TokenFlow

主题

Images ​

POST /v1/images/generations（OpenAI 兼容 · 已开放）

文生图：文本生成图片，结果以 URL 或 base64 返回。请求与响应均为 OpenAI 标准形态。

  • OpenAI 兼容渠道（智谱 CogView、火山 Seedream、硅基流动等）：网关改写 model，其余字段（size/quality/n/…）原样透传。
  • 百炼原生渠道（qwen-image-3.0 / qwen-image-3.0-pro / wan2.6-t2i）：客户仍用本接口；网关把 prompt / n / size / 参考图译成百炼 messages。size 可用 1024x1024 或 1024*1024。参考图可走 image / images / image_url。百炼只回 URL，不转 b64_json。
  • Vapeur 中转（挂载协议 vapeur）：目录仍登 dashscope。千问 / 万相打 /qwen/api/v1/services/aigc/image-generation/generation（百炼信封）；豆包 Seedream 打 /doubao/v1/images/generations。GPT 生图不要挂 vapeur，继续用 openai。upstream_model 用 Vapeur 的 id（常带 -cn）。渠道 Base https://api.vapeur.ai。

客户侧始终同步等待，没有视频那种任务 ID。

请求 ​

字段类型必填说明
modelstring是图像生成模型名（厂商/模型名，需为 image 模态）
promptstring是描述文本
nint否生成张数，1-10（默认 1）
sizestring否分辨率档位（如 1024x1024），透传给上游
response_formatstring否url（默认）或 b64_json（百炼渠道仍返回 url）
bash
curl https://www.wutooai.cn/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zhipai/cogview-4",
    "prompt": "一只戴帽子的猫",
    "n": 2
  }'

响应 ​

OpenAI 标准形态：{ "created": ..., "data": [ { "url": "..." } ] }。

计费 ​

  • 按张计费：费用 = 张数 × 单价（元/张），精确无估算。
  • 张数按请求里的 n（缺省 1），不按实际上游返回张数退补。
  • 单价在控制台「渠道模型」中以 元/张 维护（例：¥0.06/张）。
  • 明细中的 输出 列记录张数。
  • 分辨率分档价、参考图加价本期未计入，以后台牌价一档为准。

错误 ​

  • modality_mismatch：model 不是 image 模态（请到模型广场确认）。
  • modality_not_ready：该模型模态为预留位。
  • image_unsupported_protocol：该挂载不是 OpenAI 兼容、百炼或 Vapeur 图像协议。
  • 402 / 429 语义与 chat 一致（企业池余额 / 成员月度上限）。