聊天请求 - 启航 AI

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-5-mini",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "这张图片有什么"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://github.com/dianping/cat/raw/master/cat-home/src/main/webapp/images/logo/cat_logo03.png"
                    }
                }
            ]
        }
    ],
    "stream": true,
    "stream_options": {
        "include_usage": true
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/chat/completions' \
--header 'Authorization: {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-5-mini",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "这张图片有什么"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://github.com/dianping/cat/raw/master/cat-home/src/main/webapp/images/logo/cat_logo03.png"
                    }
                }
            ]
        }
    ],
    "stream": true,
    "stream_options": {
        "include_usage": true
    }
}'

返回响应

🟢200成功

application/json

Body

示例

data: {
    "id": "",
    "object": "",
    "created": 0,
    "model": "gpt-5-mini-2025-08-07",
    "choices": []
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "role": "assistant",
                "content": "",
                "refusal": null
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "7BiOh0xUwI3nnz"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "这"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "V2APMEFGIlHN9s0"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "是一"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "lLsfLCUdTYJvIs"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "张"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "WznkYy3J4jnVXod"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "简"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "o2YuwFqzMXUI6xh"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "洁"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "nnd9R1YCJxrkVSM"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "的"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "pJQ3EhggciJMk3D"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "标"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "42kIF4QeEF1L4HY"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "志"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "5VtecuW0wpiBEml"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "图"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ],
    "usage": {},
    "obfuscation": "MboulGSGZrtW2n6"
}

data: {
    "id": "chatcmpl-CToelmWvkxRd5eRDGW3PYelKdySeX",
    "object": "chat.completion.chunk",
    "created": 1761222271,
    "model": "gpt-5-mini-2025-08-07",
    "system_fingerprint": null,
    "choices": [
        {
            "index": 0,
            "delta": {