MoonApiX Docs

Appearance

图像系列概览 ​

图像系列按客户在价格页和模型列表中看到的模型名组织。当前常见图片模型包括 gpt-image-2、gpt-image-2-pro、gpt-image-2-vip、doubao-seedream-4-5-251128、doubao-seedream-5-0-260128、seedream-5.0、seedream-4.5、wan2.7-image-pro、gemini-3.1-flash-image-preview、gemini-3-pro-image-preview、nano-banana-2、nano-banana-pro、grok-imagine-image 和 grok-imagine-image-pro。不同模型使用统一图片入口、Gemini-compatible 入口或任务入口。

Matrix图像模型矩阵按模型、输入素材、生成模式和结果处理方式选择接入口。POSTOpenAI Images 兼容使用 gpt-image、Seedream、Grok 等模型提交生成和编辑请求。Task图片异步任务提交图片长任务，使用 task id 查询状态和结果 URL。GET查询图片任务读取 Midjourney 任务状态、结果 URL 和图片 seed。Uploads上传与素材为图生图、图编和视频参考准备稳定素材。

路由清单 ​

方法路径用途
POST/v1/images/generations图片生成。
POST/v1/images/generations/async图片异步生成。
POST/v1/images/edits图片编辑。
POST/v1/images/edits/async图片异步编辑。
GET/v1/images/tasks/{task_id}查询图片异步任务。
GET/v1/images/tasks/{task_id}/content获取图片异步任务结果。
POST/v1/images/variations图片变体。
POST/ideogram/generateIdeogram 文生图。
POST/ideogram/remixIdeogram 混合图。
POST/ideogram/upscaleIdeogram 放大。
POST/ideogram/describe图片描述。
POST/mj/submit/imagineMidjourney Imagine 任务。
POST/mj/submit/blendMidjourney 混图任务。
POST/mj/submit/describeMidjourney 描述任务。
GET/mj/task/{id}/fetch查询 Midjourney 单任务。
POST/mj/task/list-by-condition批量查询 Midjourney 任务。

基本流程 ​

  1. 查看 图像模型矩阵，确认模型家族、输入方式和返回方式。
  2. gpt-image-*、doubao-seedream-*、grok-imagine-* 优先使用 OpenAI Images 兼容概览。
  3. 如果图片输入需要稳定复用，先阅读 上传与素材概览。
  4. 调用对应接口并保存 model、请求参数和返回图片 URL；长耗时图片任务可使用 图片异步任务。
  5. Midjourney 任务需要保存任务 ID，并通过 Midjourney 任务查询 或回调获取结果。

模型目录 ​

目录适合场景
GPT Imagegpt-image-2、gpt-image-2-pro、gpt-image-2-vip 图片生成和编辑。
Gemini 图像生成gemini-*-image-preview 和 nano-banana-* 使用 Gemini-compatible 格式生成图片。
Doubao Seedreamdoubao-seedream-* 文生图和图片创作。
Seedream / Wan 异步图片模型seedream-5.0、seedream-4.5、wan2.7-image-pro 异步文生图和图生图。
Grok Imaginegrok-imagine-image 和 grok-imagine-image-pro 图片生成。
Ideogram 图像海报、包装、文字排版、混合图、放大和图片描述。
Midjourney 任务Imagine、混图、变体、放大、描述和动作任务。

标准请求 ​

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
  }'

推荐阅读顺序 ​

  1. 图像模型矩阵
  2. OpenAI Images 兼容概览
  3. 图片异步任务
  4. Midjourney 任务查询
  5. 图片生成指南
  6. 任务管理概览