聊天 API
通过 Chat 生成图像
通过 /v1/chat/completions 路由、使用 OpenAI 的多模态 chat schema 生成图像。截至 2026 年 7 月 28 日,Wan 2.7 图像模型已迁移至 /v1/images/generations;seedream-4-5-251128 是该路由上仍在配置的模型。
POST
部分图像模型可以通过 Chat Completions endpoint 访问:你发送一个标准的 chat 请求,其中
content 为包含文本提示词的多模态数组,AIsa 会在 choices[].message.content[] 中以 {type: "image"} 分片的形式返回生成的图像。
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=4,choices中会有 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 完全一致——只有 model 和 content 结构针对图像做了调整。你现有的 OpenAI 兼容 SDK 代码无需修改,只要替换模型和 content 结构即可。
常见 4xx 原因
400 invalid_parameter_error — Input should be a valid list: messages[*].content——content传成了字符串;请改为带类型分片的数组。- 提到
messages的400——你发送的是 Gemini 风格的contents/parts。请使用带 OpenAI 多模态分片的messages。 400 model_route_not_supported——该模型不服务此 endpoint。错误响应体中会列出它支持的路由;wan2.7-image、wan2.7-image-pro、seedream-5-0-260128和gpt-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 技能。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json