聊天 API
通过 Chat 生成图像
通过 /v1/chat/completions 路由使用 OpenAI 多模态聊天架构生成图像。截至 2026 年 7 月 28 日,Wan 2.7 图像模型已迁移到 /v1/images/generations;seedream-4-5-251128 是此路由上剩余的已配置模型。
POST
部分图像模型可以通过 Chat Completions 端点调用:发送标准聊天请求,并使用包含文本提示词的多模态
content 数组;AIsa 会在 choices[].message.content[] 中以 {type: "image"} 部分返回生成的图像。
兼容 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=4,choices中会有 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 请求——只是针对图像调整了 model 和 content 的结构。现有兼容 OpenAI 的 SDK 代码无需修改;只需替换模型和 content 结构。
常见 4xx 原因
400 invalid_parameter_error — Input should be a valid list: messages[*].content——content被作为字符串传入;请将其包装为带类型部分组成的数组。- 引用
messages的400——你发送了 Gemini 风格的contents/parts。请使用messages和 OpenAI 多模态部分。 400 model_route_not_supported——该模型不服务此端点。错误响应中会列出它实际支持的路由;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——你的工作区尚未配置该模型系列。请联系支持团队。
相关内容
OpenAI Chat
与文本模型使用相同的端点。
Gemini generateContent
兼容 Gemini 的 generateContent 端点。
媒体生成技能
封装图像和视频生成的 Agent 技能。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json