MoonApiX Docs

Appearance

图片生成指南 ​

MoonApiX 图片能力按客户可见的模型名接入：gpt-image-* 用于通用图片生成和编辑，doubao-seedream-* 用于 Seedream 图片生成，seedream-5.0、seedream-4.5 和 wan2.7-image-pro 用于异步图片任务，gemini-*-image-preview 和 nano-banana-* 用于 Gemini-compatible 图片生成，grok-imagine-* 用于 Grok Imagine 图片生成，ideogram-* 用于海报和排版类图像，mj-* 用于 Midjourney 兼容异步任务。

先选模型家族 ​

目标推荐模型家族入口
文生图、图片编辑gpt-image-*/v1/images/*
Seedream 图片生成doubao-seedream-*/v1/images/generations
异步文生图和图生图seedream-5.0、seedream-4.5、wan2.7-image-pro/v1/images/generations/async
Gemini 图片生成gemini-*-image-preview、nano-banana-*/v1beta/models/{model}:generateContent
Grok Imagine 图片生成grok-imagine-*/v1/images/generations
海报、包装、排版文字、图片描述ideogram-*/ideogram/*
Imagine、混图、放大、变体和动作任务mj-*/mj/submit/*

GPT Image 系列请走 Images API，不要通过 /v1/chat/completions 提交 gpt-image-* 图片生成请求。聊天补全和图片生成建议在业务系统中分开封装，避免不同接口的参数、响应和超时策略混用。

GPT Image 图片生成 ​

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

GPT Image 图片编辑 ​

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"

GPT Image 图片变体 ​

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"

Seedream / Wan 异步图片 ​

bash
curl https://moonapix.com/v1/images/generations/async \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "text": "A clean product hero image for a premium ceramic coffee cup."
            }
          ]
        }
      ]
    },
    "parameters": {
      "size": "2048x2048",
      "n": 1
    }
  }'

Ideogram ​

文生图：

bash
curl https://moonapix.com/ideogram/generate \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A premium coffee cup package design, clean background.",
    "aspect_ratio": "1:1"
  }'

图片描述：

bash
curl https://moonapix.com/ideogram/describe \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/input.png"
  }'

常用路径：

方法路径用途
POST/ideogram/generate文生图
POST/ideogram/remix混合图
POST/ideogram/upscale放大高清
POST/ideogram/describe图片描述

Midjourney 任务 ​

提交 Imagine 任务：

bash
curl https://moonapix.com/mj/submit/imagine \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city at sunrise --ar 16:9",
    "notifyHook": "https://example.com/moonapix/webhook"
  }'

查询任务：

bash
curl https://moonapix.com/mj/task/task_xxx/fetch \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

常用路径：

方法路径用途
POST/mj/submit/imagine提交 Imagine 任务
POST/mj/submit/action提交动作任务
POST/mj/submit/blend提交混图任务
POST/mj/submit/describe提交描述任务
POST/mj/submit/video提交视频任务
GET/mj/task/{id}/fetch查询任务
POST/mj/task/list-by-condition批量查询任务

使用建议 ​

  • 图片生成 prompt 建议包含主体、画面风格、用途和尺寸。
  • 上传图片前确认图片清晰，主体不要被遮挡。
  • 异步任务要保存任务 ID，并同时支持回调和主动查询。
  • 批量生成时记录每张图片的业务用途，方便后续追踪和复用。

更多字段和响应结构见 API Reference。