gpt-image-2-chat 使用 OpenAI 兼容的 /chat/completions 接口。它适合把图片作为对话上下文输入,再用自然语言描述你要生成或编辑的图像。
POST /chat/completions
官方参考
常用参数
官方 Chat Completions 文档中,
metadata 是附加到请求对象的键值对。AIOAGI 的 gpt-image-2-chat 示例使用 metadata.size 和 metadata.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。