Skip to main content
POST
部分图像模型可以通过 Chat Completions endpoint 访问:你发送一个标准的 chat 请求,其中 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 系列模型仍在该 endpoint 服务时的实测结果——在依赖字段级细节之前,请对照实际响应重新确认。

请求

请求 schema 与你已经在用的 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 数据,取决于你的 workspace 配置。
  • usage.total_tokens 只反映请求封装本身的少量 token 成本——计费按图片张数,使用上表中的费率,而不是按 token。

图生图

content 数组开头放一个 image_url 分片,后面跟一条文本指令。对于 Wan 系列模型,该工作流现在位于 POST /v1/images/edits

为什么 playground 显示的是 Chat Completions 路径

playground 发送的请求与标准 OpenAI Chat endpoint 使用的 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。请使用带 OpenAI 多模态分片的 messages
  • 400 model_route_not_supported——该模型不服务此 endpoint。错误响应体中会列出它支持的路由;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——你的 workspace 未开通该模型系列。请联系支持。
更多内容参见错误码速率限制

相关

OpenAI Chat

文本模型使用的同一个 endpoint。

Gemini generateContent

Gemini 兼容的 generateContent endpoint。

Media Gen skill

封装图像与视频生成的 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