Claude对话格式 - messages

POST

/v1/messages

最后修改时间：2025-11-29 03:42:50

Anthropic Claude Messages API 格式的请求。
需要在请求头中包含 anthropic-version。

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "claude-3-opus-20240229",
    "messages": [
        {
            "role": "user",
            "content": "string"
        }
    ],
    "system": "string",
    "max_tokens": 1,
    "temperature": 0,
    "top_p": 0,
    "top_k": 0,
    "stream": true,
    "stop_sequences": [
        "string"
    ],
    "tools": [
        {
            "name": "string",
            "description": "string",
            "input_schema": {}
        }
    ],
    "tool_choice": {
        "type": "auto",
        "name": "string"
    },
    "thinking": {
        "type": "enabled",
        "budget_tokens": 0
    },
    "metadata": {
        "user_id": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/messages' \
--header 'anthropic-version;' \
--header 'x-api-key;' \
--header 'Authorization: Bearer {{key}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "claude-3-opus-20240229",
    "messages": [
        {
            "role": "user",
            "content": "string"
        }
    ],
    "system": "string",
    "max_tokens": 1,
    "temperature": 0,
    "top_p": 0,
    "top_k": 0,
    "stream": true,
    "stop_sequences": [
        "string"
    ],
    "tools": [
        {
            "name": "string",
            "description": "string",
            "input_schema": {}
        }
    ],
    "tool_choice": {
        "type": "auto",
        "name": "string"
    },
    "thinking": {
        "type": "enabled",
        "budget_tokens": 0
    },
    "metadata": {
        "user_id": "string"
    }
}'

返回响应

🟢200成功

application/json

成功创建响应

Bodyapplication/json

示例

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

修改于 2025-11-29 03:42:50

OpenAI对话格式 - responses

Gemini对话格式 - v1beta