聊天补全接口，支持文本和图片输入

POST

/v1/chat/completions

推荐接入格式之一。该接口使用 OpenAI 兼容的 messages 结构，适合把文字和图片一起发给模型。

适用场景：

图文理解：让模型根据图片回答问题。

图像编辑意图描述：把参考图和编辑要求放在同一条 user message 中。

多轮对话：需要上下文连续追问时使用。

图片写法：

文本内容使用 { "type": "text", "text": "..." }。

图片内容使用 { "type": "image_url", "image_url": { "url": "https://..." } }。

url 可以是公网图片 URL，也可以是 base64 data URI。

如果只是单次图生图或多图参考，通常更推荐使用 /v1/images/generations，请求体更简单。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

案例 1：上传一张图片并提问案例 2：两张图作为参考，描述编辑目标案例 3：使用 base64 data URI 传图

适合图片理解、商品识别、截图分析等场景。

{
    "model": "gpt-image-2",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "请描述这张图里的主体、背景和整体风格。"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/photo.jpg"
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

案例 1：上传一张图片并提问案例 2：两张图作为参考，描述编辑目标案例 3：使用 base64 data URI 传图

curl --location '/v1/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-2",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "请描述这张图里的主体、背景和整体风格。"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/photo.jpg"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200

application/json

聊天补全成功响应。不同任务可能返回文本、图片链接、base64 图片或兼容字段。

Bodyapplication/json

示例

{
    "id": "chatcmpl_xxx",
    "object": "chat.completion",
    "created": 1776768940,
    "model": "gpt-image-2",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "system",
                "content": "string",
                "property1": "string",
                "property2": "string"
            },
            "finish_reason": "string"
        }
    ],
    "property1": "string",
    "property2": "string"
}

🟠400ErrorResponse

🟠401ErrorResponse

🔴500ErrorResponse

修改于 2026-04-22 02:51:52

文本转语音

图片生成/图生图接口，支持 image 数组传 URL 或 base64