智能体Code 图片生成 API 接入文档

1. 接入信息

基础调用流程

1. 登录控制台并创建 API 密钥。
2. 确认密钥有可用额度。
3. 将 SDK 或 HTTP 客户端的 base_url 配置为 https://www.chaomoapi.com/v1。
4. 使用 /v1/models 验证密钥能访问的模型列表。
5. 首次接入请使用 async=true、n=1 和并发 1 到 3 验证稳定性。
6. 批量生成时在服务端控制并发，不要在浏览器或客户端直接暴露 API Key，也不要无限制地同时提交大量请求。
7. 图生图和高质量模型可能超过 60 秒，生产接入请始终使用 async=true 并通过任务查询接口获取结果。

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

2. 模型列表查询

接入前建议先调用 /v1/models，确认当前 API Key 可用的图片模型。

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

当前公开模型如下。用户接入时只需将表格中的模型 ID 直接传给请求参数 model，无需了解或填写后台分组名称。

3. 服务端接入建议

真实 API Key 只应放在服务端。前端页面、移动端包和公开仓库不要写入真实密钥。

IMAGE_API_BASE_URL=https://www.chaomoapi.com/v1
IMAGE_API_KEY=sk-xxxx
IMAGE_DEFAULT_MODEL="gpt-image2-1K"

• 在自己的后端封装图片生成接口，再由前端调用自己的业务接口。
• 根据业务用户设置额度、频率、并发上限、日志审计和异常提示。普通密钥的可用并发以控制台配置为准，未额外提升时请按较小并发设计。
• 服务端建议保存 task_id，按 1 到 3 秒间隔轮询任务结果；不要因为长任务未立即完成而重复提交同一个生成请求。
• 图片链接通常有时效性，生成后请及时转存到自己的对象存储或文件系统。

4. 图片接口

1K 支持比例与目标尺寸

// 正确：传受支持的宽高比
{
  "model": "gpt-image2-1K",
  "ratio": "21:9"
}

// 错误：不要把画布像素写入 ratio
{
  "model": "gpt-image2-1K",
  "ratio": "3840x1648"
}

2K / 4K 模型、比例与目标尺寸

每个模型的完整文生图调用示例

文生图使用 JSON 请求体。按业务选择模型和宽高比，ratio 必须在下方已验证比例表内。

gpt-image2-1K

POST https://www.chaomoapi.com/v1/images/generations

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": "16:9",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

gpt-image2-4K-Stable

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-4K-Stable",
    "prompt": "高端腕表品牌广告主视觉，黑色金属质感背景，产品居中，棚拍光影，细节清晰",
    "ratio": "16:9",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

gpt-image2-2K-Direct（2K Direct）

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-2K-Direct",
    "prompt": "简洁的高端台灯电商主图，柔和工作室灯光，深灰色背景，产品细节清晰",
    "ratio": "16:9",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

gpt-image2-4K-Direct（4K Direct）

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image2-4K-Direct",
    "prompt": "高端家居空间杂志内页，现代客厅，自然天光，材质细节清晰，商业摄影风格",
    "ratio": "3:2",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

nano-banana-2

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "一只橘猫坐在窗边，午后阳光，真实摄影风格，毛发细节清晰",
    "ratio": "1:1",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

nano-banana-pro

curl https://www.chaomoapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "高级护肤品广告海报，白色背景，玻璃质感，柔和自然光，画面干净",
    "ratio": "4:5",
    "n": 1,
    "response_format": "url",
    "async": true
  }'

每个模型完整图生图调用示例

上传参考图后使用 /v1/images/edits，请求格式为 multipart/form-data。全部公开模型，包括 gpt-image2-1K、gpt-image2-2K-Direct、gpt-image2-4K-Stable、gpt-image2-4K-Direct、nano-banana-2 和 nano-banana-pro，均支持 1 到 9 张参考图。多张参考图请按顺序重复传 image[]，第一张作为主参考图，后续图片按上传顺序依次作为参考。

POST https://www.chaomoapi.com/v1/images/edits

gpt-image2-1K（9 张参考图示例）

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image2-1K" \
  -F "prompt=参考上传图片，生成更明亮、更干净的商业摄影风格图片" \
  -F "ratio=16:9" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@source-1.png" \
  -F "image[]=@source-2.png" \
  -F "image[]=@source-3.png" \
  -F "image[]=@source-4.png" \
  -F "image[]=@source-5.png" \
  -F "image[]=@source-6.png" \
  -F "image[]=@source-7.png" \
  -F "image[]=@source-8.png" \
  -F "image[]=@source-9.png"

gpt-image2-4K-Stable

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image2-4K-Stable" \
  -F "prompt=保留参考图中的产品主体和材质细节，将场景调整为高端品牌展台，真实商业摄影风格" \
  -F "ratio=16:9" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

gpt-image2-4K-Direct

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image2-4K-Direct" \
  -F "prompt=保留参考图中的主体与服装，将背景调整为现代简约展厅，真实商业摄影风格" \
  -F "ratio=3:2" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

gpt-image2-2K-Direct

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image2-2K-Direct" \
  -F "prompt=保留参考图的产品外观，将背景替换为简洁的白色摄影棚，清晰商业摄影风格" \
  -F "ratio=16:9" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

nano-banana-2

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=nano-banana-2" \
  -F "prompt=严格参考第一张图片中的主体外观，参考第二张图片的场景氛围，生成真实摄影风格图片" \
  -F "ratio=1:1" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

nano-banana-pro

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=nano-banana-pro" \
  -F "prompt=保留第一张参考图的主体，参考第二张图的构图和色调，生成高质量商业海报" \
  -F "ratio=4:5" \
  -F "n=1" \
  -F "async=true" \
  -F "response_format=url" \
  -F "image[]=@reference-1.jpg" \
  -F "image[]=@reference-2.jpg"

异步任务查询与终态处理

图片生成可能是长耗时任务。请求体或表单中传入 async=true 后，接口会立即返回任务 ID；客户端应保存 task_id，再轮询 GET /v1/images/{task_id} 获取最终图片。

1. 提交生成或编辑请求，并保存响应中的 task_id。
2. 每隔 1 到 3 秒请求一次 GET /v1/images/{task_id}。
3. status=running 或 pending 时继续轮询，不要重复提交同一个生成请求。
4. status=completed 时读取 data[].url 并及时下载；status=failed 时停止轮询，记录响应中的 error 后再决定是否重试。

{
  "id": "task-19f...",
  "task_id": "task-19f...",
  "object": "image.task",
  "status": "running",
  "generation_status": "running",
  "asset_status": "pending",
  "data": []
}

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

{
  "id": "task-19f...",
  "task_id": "task-19f...",
  "object": "image.task",
  "status": "completed",
  "data": [
    { "url": "https://..." }
  ]
}

{
  "id": "task-19f...",
  "task_id": "task-19f...",
  "object": "image.task",
  "status": "failed",
  "data": [],
  "error": { "message": "具体失败原因" }
}

5. 并发与批量调用

图片生成是长耗时任务，客户端应把并发控制在自己的服务端队列中。并发数表示同时进行中的请求数；每个请求的 n 表示本次返回几张图。为了获得接近本站在线生图的稳定性，默认使用小并发、异步任务和轮询查询。

服务端队列示例

下面示例使用 p-limit 控制并发，先安装依赖：npm install p-limit。

import pLimit from "p-limit";

const limit = pLimit(3); // 从 1 到 3 并发开始，稳定后再逐步提高到 4 或 8

async function generateOne(prompt) {
  const res = await fetch("https://www.chaomoapi.com/v1/images/generations", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.IMAGE_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "gpt-image2-1K",
      prompt,
      ratio: "1:1",
      n: 1,
      async: true
    })
  });

  if (res.status === 429) {
    throw new Error("rate_limited: lower concurrency and retry later");
  }
  if (!res.ok) {
    throw new Error(await res.text());
  }
  return res.json();
}

const tasks = prompts.map((prompt) => limit(() => generateOne(prompt)));
const results = await Promise.allSettled(tasks);

6. Node.js 18+ 异步调用示例

以下示例不依赖第三方包。设置环境变量 IMAGE_API_KEY 后，可直接保存为 generate-image.js 并运行。

const BASE_URL = "https://www.chaomoapi.com/v1";
const API_KEY = process.env.IMAGE_API_KEY;

if (!API_KEY) throw new Error("Missing IMAGE_API_KEY");

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function request(path, options = {}) {
  const response = await fetch(`${BASE_URL}${path}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      ...options.headers
    }
  });
  const body = await response.json().catch(() => ({}));
  if (!response.ok) throw new Error(JSON.stringify(body));
  return body;
}

async function main() {
  const accepted = await request("/images/generations", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      model: "gpt-image2-1K",
      prompt: "一张科技产品发布会主视觉，黑色背景，蓝绿色边缘光",
      ratio: "16:9",
      response_format: "url",
      n: 1,
      async: true
    })
  });

  const taskId = accepted.task_id;
  console.log("task accepted:", taskId);

  while (true) {
    await sleep(2000);
    const task = await request(`/images/${taskId}`);
    if (task.status === "completed") {
      console.log("image urls:", task.data.map((item) => item.url));
      return;
    }
    if (task.status === "failed") {
      throw new Error(JSON.stringify(task.error || task));
    }
    console.log("task status:", task.status);
  }
}

main().catch((error) => {
  console.error(error.message);
  process.exitCode = 1;
});

7. 计费与额度

• gpt-image2-1K 按 RMB 0.03 / 张 计费。
• gpt-image2-2K-Direct（2K Direct）按 RMB 0.05 / 张 计费。
• gpt-image2-4K-Stable 按 RMB 0.05 / 张 计费。
• gpt-image2-4K-Direct（4K Direct）按 RMB 0.05 / 张 计费。
• nano-banana-2 按 RMB 0.10 / 张 计费。
• nano-banana-pro 按 RMB 0.20 / 张 计费。
• 最终扣费以平台实际账单、模型倍率、分组规则和请求记录为准。

8. 常见错误排查

9. 安全要求

• API Key 只能放在服务端、环境变量或安全密钥管理系统中。
• 不要把真实密钥写入前端代码、移动端包、浏览器扩展或公开仓库。
• 如果密钥已经泄露，应立即在控制台停用并重新创建。
• 对外提供服务时，应在自己的后端增加用户鉴权、额度限制、日志审计和异常告警。

10. 联系方式

如遇到账户、额度、模型权限或接口异常问题，请联系管理员。

联系方式：微信 zntcode