原生Claude格式

简介

Claude 原生的消息接口，适用于 Claude Code 等原生 Anthropic 客户端。该接口遵循 Anthropic 的 API 规范，提供完整的 Claude 模型功能支持，包括扩展思考（Extended Thinking）、工具调用等高级特性。

通过切换下方 Body 示例（examples）或将 stream 字段改为 true 即可测试不同场景。

所有请求共享以下 Header：

x-api-key: sk-xxx（或使用 Authorization）

anthropic-version: 2023-06-01

content-type: application/json

当 stream=true 时响应为 SSE 流（content-type: text/event-stream），事件类型遵循 Anthropic 原生规范（message_start / content_block_start / content_block_delta / content_block_stop / message_delta / message_stop）。

Prompt Caching（提示词缓存）

Prompt Caching 允许缓存经常使用的上下文内容，显著降低成本并提升响应速度。有两种启用方式，可以单独使用也可以组合：

方式	写法	试用场景
自动缓存	`cache_control` 放在请求体顶层	多轮对话。断点自动落在最后一个可缓存块上并随对话后移，无需维护标记
显式断点	`cache_control` 标记在 `system` / `messages` 的内容块上	需要精确控制缓存边界，例如只缓存系统提示词或某段长文档

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "model": "claude-sonnet-4-5-20250929",
    "id": "msg_bdrk_01DJBYweRg351XHSgq6JcTsE",
    "type": "message",
    "role": "assistant",
    "content": [
        {
            "type": "text",
            "text": "Hello! Nice to meet you too! How are you doing today? Is there anything I can help you with?"
        }
    ],
    "stop_reason": "end_turn",
    "usage": {
        "input_tokens": 13,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "cache_creation": {
            "ephemeral_5m_input_tokens": 0,
            "ephemeral_1h_input_tokens": 0
        },
        "output_tokens": 26
    }
}

🟠400参数错误

🟠401未认证

🟠403IP 白名单校验不通过 / 余额不足

简介#

Prompt Caching（提示词缓存）#

请求参数

请求示例代码

返回响应

简介

Prompt Caching（提示词缓存）