众扬汇 AI 开放平台 API 文档

Chat(修改图片)

OpenAPI Specification

接口:POST /v1/chat/completions(完整地址 https://api.allyang.cn/v1/chat/completions)

说明:全部对话模型都可走此接口,把 model 换成目标模型名;改图场景要求模型具备生图能力,且支持一次携带多张参考图。

鉴权:请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

  • Content-Type:必填,固定 application/json。
  • Accept:必填,固定 application/json。
  • Authorization:可选,string,默认 Bearer {{YOUR_API_KEY}}。

请求体参数(application/json)

  • model:必填,string,模型 ID,可取:gpt-image-1、gpt-4o-image、sora_image、flux-kontext-pro、nano-banana、doubao-seedream-4-0-250828、doubao-seededit-3-0-i2i-250628、nano-banana-hd、qwen-image-edit;其中 flux-kontext-pro 可覆盖所有 flux kontext 系列(原文如此)。
  • messages:必填,数组,以对话格式提交的消息;元素对象含 role(string)与 content(string)。
  • stream:boolean,开启后像聊天场景一样下发分段增量:标记可用时即以纯数据 SSE 发送,由 data: [DONE] 终止。

必填字段:model、messages。

请求示例

  • model:gpt-4o-image;stream:false
  • messages:一条 user 消息,content 为内容块数组:文本块「修改这个图片」,随后两个 image_url 块(第一张示例地址 https://example.com/logo.png,第二个位置原文写「支持多图」,即此处可继续追加参考图)。

响应

  • 200:成功,返回 JSON 对象:
    • id:string,如 chatcmpl-123;object:string,如 chat.completion;created:integer,如 1677652288。
    • choices:数组,元素含 index(如 0)、message(对象,必含 role、content)、finish_reason(如 stop)。
    • usage:对象,必含 prompt_tokens、completion_tokens、total_tokens(示例 9 / 12 / 21)。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。