接入文档

1. 三步快速接入

最小文生图请求

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-1K",
    "prompt": "一只坐在窗边的橘猫，柔和自然光",
    "ratio": "1:1",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

提交成功

{
  "id": "task-...",
  "task_id": "task-...",
  "object": "image.task",
  "status": "running",
  "data": []
}

查询任务

curl https://www.chaomoapi.com/v1/images/task-... \
  -H "Authorization: Bearer sk-xxxx"

2. 接口与参数

通用参数

参考图编辑请求

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image2-2K-Direct" \
  -F "prompt=保留主体，把背景改成白色摄影棚" \
  -F "ratio=4:3" \
  -F "image[]=@./reference-1.jpg" \
  -F "image[]=@./reference-2.jpg" \
  -F "n=1" \
  -F "response_format=url" \
  -F "async=true"

视频生成请求

视频模型只面向 API 调用；需要使用 Seedance2 Video 分组下的 API Key，不会在在线生图页面展示。

纯文本生成视频

curl https://www.chaomoapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2-mini",
    "prompt": "a clean product reveal video, soft studio lighting",
    "size": "480p",
    "seconds": "4"
  }'

带参考图生成视频

curl https://www.chaomoapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2",
    "prompt": "根据参考图生成一段商品展示视频，镜头缓慢推进，柔和布光",
    "size": "720p",
    "seconds": "5",
    "content": [
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/reference-1.png"
        }
      }
    ]
  }'

带参考图、参考视频和参考音频生成视频

curl https://www.chaomoapi.com/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2",
    "prompt": "结合参考图、参考视频和参考音频生成一段品牌短片",
    "size": "720p",
    "seconds": "6",
    "content": [
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/image-1.png"
        }
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/reference.mp4"
        }
      },
      {
        "type": "audio_url",
        "role": "reference_audio",
        "audio_url": {
          "url": "https://example.com/reference.mp3"
        }
      }
    ]
  }'

4K 原生 API 请求

gpt-image2-4K 只面向 API 调用；需要使用 gpt-image2-4K-Native 分组下的 API Key，不会在在线生图页面展示。

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-4K",
    "prompt": "高端产品海报，白色背景，主体居中，柔和布光，高清质感",
    "ratio": "16:9",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

4K 原生参数边界

gpt-image2-4K 是本站封装后的 4K 原生 API 通道，不等同于官方图片接口的全量参数透传。本站只保证下表参数稳定可用；未列出的官方扩展参数可能被网关改写、忽略或被服务拒绝。

3. 模型与比例

实际可用模型以当前 API Key 调用 GET /v1/models 的返回结果为准。

分组与模型权限

分组只在创建或管理 API Key 时选择；请求接口时不要传分组名。不同 Key 看到的模型可能不同，接入程序应以 GET /v1/models 的返回为准。

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-2K-low",
    "prompt": "一张现代产品摄影，纯净背景，柔和棚拍光",
    "size": "2048x1152",
    "n": 1,
    "response_format": "url"
  }'

Low 参考图编辑

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image2-2K-low" \
  -F "prompt=保留主体，把背景改为纯白摄影棚" \
  -F "size=2048x1152" \
  -F "image=@./reference.png" \
  -F "n=1" \
  -F "response_format=url"

4. 任务状态与返回值

成功响应

{
  "id": "task-...",
  "task_id": "task-...",
  "object": "image.task",
  "status": "completed",
  "generation_status": "success",
  "asset_status": "saved",
  "data": [{ "url": "https://www.chaomoapi.com/image-files/...png" }]
}

失败响应

{
  "id": "task-...",
  "task_id": "task-...",
  "object": "image.task",
  "status": "failed",
  "data": [],
  "error": { "message": "image task failed", "type": "image_task_error" }
}

5. 完整 Node.js 18+ 示例

const API_BASE = "https://www.chaomoapi.com/v1";
const API_KEY = process.env.CHAOMO_API_KEY;
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function api(path, options = {}) {
  const response = await fetch(`${API_BASE}${path}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
      ...(options.headers || {})
    }
  });
  const body = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(body));
  return body;
}

async function main() {
  const accepted = await api("/images/generations", {
    method: "POST",
    body: JSON.stringify({
      model: "gpt-image2-1K",
      prompt: "一只大公鸡，写实摄影",
      ratio: "1:1",
      n: 1,
      response_format: "url",
      async: true
    })
  });

  while (true) {
    await sleep(4000);
    const task = await api(`/images/${accepted.task_id}`);
    if (task.status === "completed") {
      console.log(task.data[0].url);
      return;
    }
    if (task.status === "failed") {
      throw new Error(task.error?.message || "image task failed");
    }
  }
}

main().catch(console.error);

6. 计费与并发

• 提交时按 API Key 所属分组的当前价格预留本次费用。
• 任务最终成功后完成扣费；平台确认失败或超时后释放预留。
• 已提交任务按提交时预留价格结算；后台改价只影响之后的新任务。
• 需要多张图时提交多个 n=1 的异步任务，并分别保存 task_id。
• 遇到 429、server_busy 或 retry_after 时，应退避后重试。

7. 错误排查

8. 安全与常见问题