文本对话（优先）

POST

/v1/messages

官方格式请求
可选模型ID例如：

claude-haiku-4-5-20251001

claude-sonnet-4-6

claude-opus-4-6

claude-opus-4-7等

请求参数

Body 参数application/json必填

示例

{
    "model": "claude-sonnet-4-6",
    "messages": [
        {
            "role": "user",
            "content": "Hello"
        }
    ],
    "max_tokens": 500
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/messages' \
--header 'Content-Type: application/json' \
--data '{
    "model": "claude-sonnet-4-6",
    "messages": [
        {
            "role": "user",
            "content": "Hello"
        }
    ],
    "max_tokens": 500
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "model": "string",
    "type": "string",
    "role": "string",
    "content": [
        {
            "type": "string",
            "text": "string"
        }
    ],
    "stop_reason": "string",
    "stop_sequence": "string",
    "usage": {
        "input_tokens": 0,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "cache_creation": {
            "ephemeral_5m_input_tokens": 0,
            "ephemeral_1h_input_tokens": 0
        },
        "output_tokens": 0,
        "service_tier": "string"
    }
}

修改于 2026-06-01 06:20:57

获取可用模型接口

文本对话 / 文本对话（兼容接口） / 生成图像（Nano Banana）