MoonApiX Docs

Appearance

Seedream / Wan 异步图片模型 ​

seedream-5.0、seedream-4.5 和 wan2.7-image-pro 使用 MoonApiX 图片异步任务入口，适合文生图、图生图、商品图、角色参考图和视觉草图生成。创建任务时先拿到任务 ID，再查询任务状态和结果 URL。

模型列表 ​

模型常用模式推荐入口查询入口
seedream-5.0文生图、图生图/v1/images/generations/async/v1/images/tasks/{task_id}
seedream-4.5文生图、图生图/v1/images/generations/async/v1/images/tasks/{task_id}
wan2.7-image-pro文生图、图生图/v1/images/generations/async/v1/images/tasks/{task_id}

实际可用尺寸、单次生成数量和价格以 MoonApiX 后台、价格页和 GET /v1/models 为准。

文生图 ​

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 premium ceramic coffee cup on a clean studio table, soft light, product photography."
            }
          ]
        }
      ]
    },
    "parameters": {
      "size": "2048x2048",
      "n": 1,
      "watermark": false
    }
  }'

创建成功后响应会包含任务 ID：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "created": 1782135793,
  "status": "queued",
  "model": "seedream-5.0"
}

图生图 ​

图生图把图片 URL 和文本要求放在同一条用户消息里。图片可以是客户自己的公网 URL，也可以是 MoonApiX 托管 URL；URL 需要在任务执行期间可访问。

bash
curl https://moonapix.com/v1/images/generations/async \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "image": "https://example.com/product.png"
            },
            {
              "text": "Keep the product shape, change the background to a bright kitchen counter, realistic commercial photo."
            }
          ]
        }
      ]
    },
    "parameters": {
      "size": "2048x2048",
      "n": 1,
      "watermark": false
    }
  }'

建议输入图片至少 300x300，并避免使用需要登录、带短期签名或禁止抓取的地址。

查询任务 ​

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

处理中：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "running",
  "progress": 42,
  "model": "seedream-5.0"
}

成功：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "succeeded",
  "progress": 100,
  "model": "seedream-5.0",
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

客户端应先判断 status。只有 succeeded 时读取 data[].url；失败时读取 error 或 fail_reason，不要只根据 URL 字段判断任务成功。

常用参数 ​

字段类型说明
modelstringseedream-5.0、seedream-4.5 或 wan2.7-image-pro。
input.messagesarray消息数组。通常放一条 role=user 的消息。
content[].textstring图片生成或修改要求。
content[].imagestring可选。图生图输入图片 URL。
parameters.sizestring输出尺寸。常见写法如 2048x2048；兼容 2048*2048。
parameters.ninteger生成数量。以模型实际支持范围为准。
parameters.watermarkboolean是否添加水印。
parameters.thinking_modeboolean模型支持时可控制思考模式。未确认需要时可不传。

尺寸建议 ​

常用方图可以从 2048x2048 开始；竖图和横图请按模型列表或价格页展示的支持尺寸选择。若尺寸报错，请先切换到模型页展示的推荐尺寸后重试。

结果和计费 ​

这三个模型按任务计费。任务提交成功后请保存 id / task_id、model、请求参数和查询结果；价格以 MoonApiX 后台配置为准。

相关页面 ​