Skip to main content
gpt-image-2-chat 使用 OpenAI 兼容的 /chat/completions 接口。它适合把图片作为对话上下文输入,再用自然语言描述你要生成或编辑的图像。 POST /chat/completions

官方参考

常用参数

官方 Chat Completions 文档中,metadata 是附加到请求对象的键值对。AIOAGI 的 gpt-image-2-chat 示例使用 metadata.sizemetadata.quality 控制图像规格。请在 控制台开发者指南 中确认当前支持的取值。

尺寸设置

gpt-image-2-chat 支持两种尺寸设置方式。你可以在 metadata.size 中设置尺寸,也可以把尺寸写在 prompt 开头。 prompt 前缀格式如下:
支持的常用尺寸示例: 自定义尺寸需要同时满足以下条件:
  • 宽和高都能被 16 整除。
  • 像素总数不少于 655360
  • 宽高比不超过 3:1

请求示例

Python 示例

下面的示例展示完整调用流程。它会把公网图片或本地图片转换成 data:image/...;base64,...,这样可以减少图片 URL 无法被服务端访问的问题。

典型返回

gpt-image-2-chat 返回 Chat Completions 对象。你应先读取 choices[0].message.content,再根据实际内容提取图片 URL、Markdown 图片或文本说明。

流式调用

当你设置 stream: true 时,接口会返回一组 chat.completion.chunk。你需要逐块读取 choices[].delta.content 并拼接内容。

调用说明

  • 如果图片 URL 需要登录、存在防盗链或服务端无法访问,请转成 data:image/...;base64,... 后再传入。
  • 你可以通过 metadata.size 或 prompt 前缀设置尺寸。prompt 前缀示例为 3840x2160 '生成一张产品海报'auto '生成一张产品海报'
  • 如果返回内容不是图片 URL,请记录原始响应并检查 choices[0].message.content 的结构。
  • 如果你传入大图,请控制图片体积。官方 Chat Completions 文档提示,图片输入过大可能被丢弃。
  • gpt-image-2-chat/chat/completions,不要把它传到 /images/generations/images/edits