通过 Chat 接口生图

除了标准的 /v1/images/generations 端点，你也可以通过 /v1/chat/completions（OpenAI Chat 协议）调用图片模型。

系统会自动检测渠道类型，对腾讯云/百度云等异步渠道走内部异步转同步流程，对 PoloAI 等同步渠道直接代理。

请求示例

curl -X POST https://pico.5884.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GEM-3.0",
    "messages": [
      {"role": "user", "content": "一只穿宇航服的猫咪在月球上"}
    ]
  }'

同步返回（默认）

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "GEM-3.0",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "https://xxx.myqcloud.com/aigcImageGenFile.png"
      },
      "finish_reason": "stop"
    }
  ]
}

图片 URL 在 choices[0].message.content 中返回。

异步模式

添加 X-Async: true 请求头，立即返回 task_id：

curl -X POST https://pico.5884.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -H "X-Async: true" \
  -d '{
    "model": "GEM-3.0",
    "messages": [{"role": "user", "content": "一只猫"}]
  }'

{
  "task_id": "xxxxxx",
  "status": "pending",
  "model": "GEM-3.0",
  "message": "任务已提交，使用 GET /v1/generations/xxxxxx 轮询结果"
}

然后使用 任务查询 API 轮询结果。

模型别名

如果管理员配置了模型别名（如 gemini-3-pro-image-preview → gemini-3-pro-image-preview, GEM-3.0），调用别名时系统会自动按渠道优先级路由，高优先级渠道失败时自动兜底到低优先级渠道。

提示

使用别名调用时，客户端无需关心底层走的是哪个渠道和模型，系统会透明处理。