MoonApiX Docs

Appearance

图片生成 ​

图片生成接口用于从文本 prompt 创建图片，适合产品图、海报、素材草图、封面和营销视觉生成。常用模型包括 gpt-image-2、gpt-image-2-pro、doubao-seedream-5-0-260128、grok-imagine-image 等。

接口路径 ​

方法路径返回方式
POST/v1/images/generations同步返回图片结果或图片响应。
POST/v1/images/generations/async先返回任务 ID，随后查询图片结果。

请求示例 ​

bash
curl https://moonapix.com/v1/images/generations \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product mockup on a white studio table.",
    "size": "1024x1024",
    "n": 1
  }'

常用字段 ​

字段说明
model图片模型名，例如 gpt-image-2、doubao-seedream-5-0-260128、grok-imagine-image。
prompt图片描述。
size输出尺寸，例如 1024x1024。
n生成数量。
response_format返回格式，以 API Reference 为准。

结果处理 ​

场景处理方式
返回图片 URL保存 URL、prompt、模型名和尺寸。
返回图片内容先落到业务文件存储，再保存可访问地址。
批量生成按返回顺序绑定每张图和生成参数。
异步生成保存 id，轮询 GET /v1/images/tasks/{task_id}，成功后读取 data[].url。

接入建议 ​

  • Prompt 建议包含主体、场景、风格、比例和用途。
  • 批量生成时保存 prompt、模型名、尺寸和结果 URL。
  • 同步接口会等待图片生成完成；长耗时任务或不希望保持长连接时，使用 图片异步任务。
  • 需要基于已有图片修改时使用 图片编辑。

相关页面 ​