MoonApiX Docs

Appearance

OpenAI Images 兼容 ​

OpenAI Images 兼容入口用于通过 /v1/images/* 调用 gpt-image-*、doubao-seedream-*、grok-imagine-* 等图片模型。实际可用模型、尺寸和数量以 MoonApiX 后台、价格页和 GET /v1/models 为准。

图片生成和图片编辑请使用 /v1/images/generations、/v1/images/edits 或对应异步入口。/v1/chat/completions 不是 GPT Image 系列的推荐图片生成入口，不建议把 gpt-image-* 放到聊天补全请求中生成图片。

能力概览 ​

能力路径输入结果
图片生成/v1/images/generationsJSON prompt同步返回图片结果。
图片异步生成/v1/images/generations/asyncJSON prompt先返回任务 ID，随后查询任务结果。
图片编辑/v1/images/editsmultipart 图片文件和 prompt同步返回编辑结果。
图片异步编辑/v1/images/edits/asyncJSON 图片 URL 或 Base64 和 prompt先返回任务 ID，随后查询任务结果。
图片变体/v1/images/variationsmultipart 图片文件模型支持时返回相近版本。

同步接口会保持连接直到图片生成或编辑完成。需要避免长连接、网关超时或客户端中断时，请使用图片异步接口。异步接口成功提交后读取 id，通过 GET /v1/images/tasks/{task_id} 查询状态；任务成功后读取 data[].url。

如果你的业务系统同时接入聊天和图片能力，建议把聊天模型与图片模型分别配置：聊天走 /v1/chat/completions，GPT Image 图片生成走 /v1/images/generations，图片编辑走 /v1/images/edits。

图片生成 ​

http
POST /v1/images/generations
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
  }'

图片异步生成 ​

http
POST /v1/images/generations/async
bash
curl https://moonapix.com/v1/images/generations/async \
  -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
  }'

提交成功后响应会包含任务 ID：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "queued",
  "progress": 3,
  "model": "gpt-image-2"
}

查询任务：

bash
curl https://moonapix.com/v1/images/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

任务成功后：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "succeeded",
  "progress": 100,
  "model": "gpt-image-2",
  "data": [
    {
      "url": "https://media.moonapix.com/image/example.png"
    }
  ]
}

图片编辑 ​

http
POST /v1/images/edits
bash
curl https://moonapix.com/v1/images/edits \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "image=@./product.png" \
  -F "model=gpt-image-2-pro" \
  -F "prompt=Change the background to a clean studio scene." \
  -F "size=1024x1024"

图片异步编辑 ​

http
POST /v1/images/edits/async

图片异步编辑适合使用可访问图片 URL 或 Base64 图片内容提交任务。需要上传本地文件的编辑场景，继续使用同步 /v1/images/edits。

bash
curl https://moonapix.com/v1/images/edits/async \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-pro",
    "prompt": "Change the background to a clean studio scene.",
    "image": "https://example.com/product.png",
    "size": "1024x1024"
  }'

图片变体 ​

http
POST /v1/images/variations
bash
curl https://moonapix.com/v1/images/variations \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "image=@./product.png" \
  -F "model=gpt-image-2" \
  -F "n=2"

常用字段 ​

字段用途
model图片模型名。
prompt图片生成或编辑描述。
image上传的图片文件。
size输出尺寸，例如 1024x1024。
n生成数量。

异步任务状态 ​

状态含义
queued / submitted已提交，等待处理。
running正在生成。
succeeded已成功，读取 data[].url。
failed已失败，读取 error.message。

异步图片任务返回 URL，不返回图片 Base64 正文。如果生成结果是图片内容，MoonApiX 会转成可访问的图片 URL 后再写入任务结果。

使用建议 ​

  • Prompt 建议包含主体、画面风格、用途和尺寸。
  • 上传图片前确认图片清晰，主体不要被遮挡。
  • 批量生成时保存请求参数和返回结果，便于后续追踪。
  • 同步接口适合短耗时请求；异步接口适合长耗时图片任务、后台任务和对连接稳定性敏感的业务。
  • 如果需要海报排版或文字呈现，可以评估 Ideogram 图像。
  • 如果需要高风格化异步任务，可以评估 Midjourney 任务。

相关页面 ​