图像接口 images

支持三类图像请求：生成、编辑、变体。

curl https://api.token.heimatianqi.com/v1/images/generations \
  -H "Authorization: Bearer sk-heima-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-image","prompt":"一只戴围巾的柯基，扁平插画风格","size":"1024x1024","n":1}'

端点	用途
POST /v1/images/generations	文生图
POST /v1/images/edits	按提示词编辑已有图片（多为 multipart 上传）
POST /v1/images/variations	生成相似变体

计费

图像模型的价格与文本模型不同口径：

场景	计费方式
按张	每次请求固定价（与分辨率/档位相关）
按 token	视觉理解类模型按输入/输出 tokens

具体到某个模型用哪种口径、各档位多少钱，请看「模型与价格 → 模型详情」里的档位/计价说明 （该说明与后台的档位表达式同源）。

实名门槛

以下图像/视觉模型需要实名认证后才能调用（未实名返回 403 realname_required）：

qwen-image-2.0、qwen-image-3.0、qwen-image-3.0-pro、wan2.7-image、 z-image-turbo、deepseek-v4-flash-vision-exp、qwen-omni-turbo、Qwen2.5-VL-7B-Instruct。

常见问题

• 返回图片链接会过期吗？ 上游返回的 URL 通常有时效，建议及时下载并转存到自己的存储。
• size 不支持怎么办？ 报 400 说明该模型不支持该尺寸，换用详情里列出的档位。
• 同一提示词费用不同？ 档位（分辨率/质量）或上游计价方式不同导致。