Skip to main content
POST
部分图像模型可以通过 Chat Completions 端点调用:发送标准聊天请求,并使用包含文本提示词的多模态 content 数组;AIsa 会在 choices[].message.content[] 中以 {type: "image"} 部分返回生成的图像。
路由已变更。 wan2.7-imagewan2.7-image-pro 不再服务此路由 —— 在此调用会返回 400 model_route_not_supported。它们现在使用 POST /v1/images/generationsPOST /v1/images/editsseedream-5-0-260128gpt-image-2 同样在 /v1/images/generations 上。
兼容 Gemini 的 generateContent 请求使用 /v1beta/models/{model}:generateContent

支持的模型

下方的多模态请求与响应结构说明的是网关在 chat 路由上对图像生成的封装方式。这些结构是 Wan 模型仍在此端点时实测记录的 —— 依赖字段级细节前,请以实际响应为准再核对一次。

请求

请求架构与你已用于文本的 POST /v1/chat/completions 相同——唯一的区别是传入的模型以及 content 的结构。 关键规则:messages[].content 必须是带类型部分组成的数组。传入普通字符串会返回 400 invalid_parameter_error,错误消息为 "Input should be a valid list: messages[*].content"

请求字段

响应结构

  • **每张图像对应一个 choice。**如果 n=4choices 中会有 4 个条目。
  • 每个 choice.message.content 都是一个数组,其中包含一个 { "type": "image", "image": "..." } 部分。
  • 根据工作区配置,image 是短期有效的 URL(请尽快下载)或 base64 数据。
  • usage.total_tokens 反映请求封装产生的少量词元开销——计费按图像计算,费率见上表,而不是按词元计算。

图生图

content 数组开头添加一个 image_url 部分,并在其后添加文本指令。Wan 模型的这一流程现已迁移到 POST /v1/images/edits

为什么调试台显示 Chat Completions 路径

调试台发送的正是标准 OpenAI Chat 端点所使用的 POST /v1/chat/completions 请求——只是针对图像调整了 modelcontent 的结构。现有兼容 OpenAI 的 SDK 代码无需修改;只需替换模型和 content 结构。

常见 4xx 原因

  • 400 invalid_parameter_error — Input should be a valid list: messages[*].content——content 被作为字符串传入;请将其包装为带类型部分组成的数组。
  • 引用 messages400——你发送了 Gemini 风格的 contents/parts。请使用 messages 和 OpenAI 多模态部分。
  • 400 model_route_not_supported——该模型不服务此端点。错误响应中会列出它实际支持的路由;wan2.7-imagewan2.7-image-proseedream-5-0-260128gpt-image-2 都属于 /v1/images/generations
  • 502 no available channel——路由存在,但上游当前没有可用通道。请重试,或改用 /v1/images/generations 上的图像模型。
  • 500 model_not_found——你的工作区尚未配置该模型系列。请联系支持团队。
更多信息请参阅错误代码速率限制

相关内容

OpenAI Chat

与文本模型使用相同的端点。

Gemini generateContent

兼容 Gemini 的 generateContent 端点。

媒体生成技能

封装图像和视频生成的 Agent 技能。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
enum<string>
必填

chat 路由上的图像生成模型。seedream-4-5-251128 按每次请求 $0.036 计费。Wan 和 gpt-image-2 模型请改用 /v1/images/generations

可用选项:
seedream-4-5-251128
messages
object[]
必填

对话消息。图像提示词应放在最后一条用户消息的 content 数组中,并以 {type: "text"} 部分的形式提供。

n
integer

要生成的图像数量。每张图像单独计费;除非需要多个候选,否则传入 1

必填范围: x >= 1

响应

已生成的图像。以 Chat Completion 形式返回,图像位于 message.content[] 的图像部分中。

id
string
示例:

"chatcmpl-fcc86dfd-9424-9523-b0bd-cdf07383bee2"

object
string
示例:

"chat.completion"

created
integer
示例:

1776495713

model
string
示例:

"seedream-4-5-251128"

choices
object[]

每张生成的图像对应一个条目。

usage
object