聊天(prompt cache)

POST

/v1/messages

通过设置参数："cache_control": {"type": "ephemeral"} 可以支持 prompt cache 模式
令牌需要使用aws, aws_cache分组

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "总结文章的内容，不超过50个字: {text}",
                    "cache_control": {
                        "type": "ephemeral"
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.xaix.me/v1/messages' \
--header 'x-api-key: {YOUR_API_KEY}' \
--header 'content-type: application/json' \
--data-raw '{
    "model": "claude-3-7-sonnet-20250219",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "总结文章的内容，不超过50个字: {text}",
                    "cache_control": {
                        "type": "ephemeral"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "id": "string",
    "type": "string",
    "role": "string",
    "model": "string",
    "content": [
        {
            "type": "string",
            "text": "string"
        }
    ],
    "stop_reason": "string",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 0,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 0
    }
}

修改于 2026-04-13 00:42:51

聊天

流式返回