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

1. 接入信息

基础调用流程

1. 登录控制台并创建 API 密钥。
2. 确认密钥有可用额度，并已分配到图片模型分组。
3. 将 SDK 或 HTTP 客户端的 base_url 配置为 https://www.chaomoapi.com/v1。
4. 使用 /v1/models 验证密钥能访问的模型列表。
5. 批量生成时在服务端控制并发，不要在浏览器或客户端直接暴露 API Key。

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"

当前正常返回应包含：

• image2 1K
• image2 2K
• image2 4K

3. 服务端接入建议

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

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

• 在自己的后端封装图片生成接口，再由前端调用自己的业务接口。
• 根据业务用户设置额度、频率、日志审计和异常提示。
• 图片链接通常有时效性，生成后请及时转存到自己的对象存储或文件系统。

4. 图片接口

文生图

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": "image2 2K",
    "prompt": "一张高端不锈钢智能保温杯的电商主图，棚拍灯光，干净背景",
    "size": "2048x1152",
    "n": 1,
    "response_format": "url"
  }'

图生图

上传 1 到 3 张参考图后使用 /v1/images/edits，请求格式为 multipart/form-data。可按模型选择官方直出 1K、2K 或 4K 输出尺寸。

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

curl https://www.chaomoapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=image2 1K" \
  -F "prompt=参考上传图片，生成更明亮、更干净的商业摄影风格图片" \
  -F "size=1024x1024" \
  -F "n=1" \
  -F "quality=auto" \
  -F "image[]=@source-1.png" \
  -F "image[]=@source-2.png" \
  -F "image[]=@source-3.png"

5. 并发与批量调用

图片生成是长耗时任务，客户端应把并发控制在自己的服务端队列中。并发数表示同时进行中的请求数；每个请求的 n 表示本次返回几张图。

服务端队列示例

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

import pLimit from "p-limit";

const limit = pLimit(10); // 从 10 并发开始，稳定后再逐步提高

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: "image2 1K",
      prompt,
      size: "1024x1024",
      n: 4
    })
  });

  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 图片生成模块

已提供一个可直接复用的图片生成模块，默认按本站网关调用。

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

const { ImageGenerationClient } = require("./image-generation-client");

const client = new ImageGenerationClient();

const result = await client.generateImage({
  model: "image2 4K",
  prompt: "一张科技产品发布会主视觉，黑色背景，蓝绿色边缘光",
  size: "3840x2160",
  n: 1
});

console.log(result.images);

7. 计费与额度

• image2 1K 按 $0.03 / 张 计费。
• image2 2K 按 $0.03 / 张 计费。
• image2 4K 按 $0.04 / 张 计费。
• 最终扣费以平台实际账单、模型倍率、分组规则和请求记录为准。

8. 常见错误排查

9. 安全要求

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

10. 联系方式

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

联系方式：微信 zntcode