文档 · 文生图

告诉我这张是谁画的

auto/image 走 OpenAI 形状的 POST /v1/images/generations。背后有多个模型，每次请求别名会落到其中一个。值得单说的是：响应里会告诉你实际是哪个模型出的图——因为图像这件事，事后是看不出来的。

怎么调

curl https://tokenexchage.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto/image","prompt":"黄昏的灯塔，长曝光","size":"1024x1024"}'

{
  "created": 1790524404,
  "data": [ { "url": "https://dashscope-result-….aliyuncs.com/…png" } ],
  "model": "qwen-image-3.0-pro",
  "usage": { … }
}

url 是对象存储的临时链接，要留图就自己下载。

为什么模型名要放在返回里

图像模型之间的差别不只是好坏，是风格。有的招牌文字渲染干净，有的肤色更自然，有的快但糙。如果你在生成一套产品图，其中三分之一回来是明显另一种画风，你需要知道这件事——而且需要返回里有那么一个字段能告诉你。

所以别名报的是实际服务的那一个，不是你点的那一个。当这个值和你发的不一样，说明别名落到了别的候选上，发货前值得看一眼。

下落本身很窄：只有当前模型在上游被下线（404 / 410）时，别名才会移到下一个候选。超时、限流、上游 5xx 一律返回错误并指明是哪个模型失败的，而不是给你一张你没选的模型画的图。

只收文生图。*-edit 系模型要一到三张输入图，走的是 POST /v1/images/edits——那是另一个操作、另一套请求形状，不是这个的变体。

参数

其他能力

同一套命名，一个能力一个别名，都在 /v1/models 里：