流式返回

POST

/v1/messages

文本对话，结果流式返回。
只支持claude系列模型

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [
        {
            "role": "user",
            "content": "讲个故事"
        }
    ],
    "stream": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/messages' \
--header 'x-api-key: {YOUR_API_KEY}' \
--header 'content-type: application/json' \
--data '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [
        {
            "role": "user",
            "content": "讲个故事"
        }
    ],
    "stream": true
}'

返回响应

🟠401没有权限

application/json

Bodyapplication/json

示例

{
    event: message_start
    data: {
        "type": "message_start",
        "message": {
            "type": "message",
            "model": "claude-3-5-sonnet-20241022",
            "usage": {
                "input_tokens": 8,
                "cache_creation_input_tokens": 0,
                "cache_read_input_tokens": 0,
                "output_tokens": 0
            },
            "role": "assistant",
            "id": "chatcmpl-89CUkiFyyRyYOkpO7SSURJYR7KYQO",
            "content": []
        }
    }

    event: content_block_start
    data: {
        "type": "content_block_start",
        "index": 0,
        "content_block": {
            "type": "text",
            "text": ""
        }
    }

    event: content_block_delta
    data: {
        "type": "content_block_delta",
        "index": 0,
        "delta": {
            "type": "text_delta",
            "text": "你好！有什么可以帮你的吗？"
        }
    }
}

修改于 2025-12-05 08:47:03

聊天(prompt cache)

聊天(深度思考)