# Messages(思考)

**方法**: `POST`
**路径**: `/v1/messages`

也可以使用 -thinking 模型，openai 格式，我们已兼容 think

Claude 3.7 Sonnet 可以产生比以前的模型更长的响应，并支持高达 128K 的输出标记（测试版），比其他 Claude 模型长 15 倍以上。这种扩展功能对于涉及复杂推理、丰富代码生成和全面内容创建的扩展思维使用案例特别有效。
可以通过传递 output-128k-2025-02-19 的 anthropic-beta 标头来启用此功能。

```
--header "anthropic-beta: output-128k-2025-02-19"
```

API 响应将包括思考和文本内容块：

```
{
"content": [
{
"type": "thinking",
"thinking": "To approach this, let's think about what we know about prime numbers...",
"signature": "zbbJhbGciOiJFU8zI1NiIsImtakcjsu38219c0.eyJoYXNoIjoiYWJjMTIzIiwiaWFxxxjoxNjE0NTM0NTY3fQ...."
},
{
"type": "text",
"text": "Yes, there are infinitely many prime numbers such that..."
}
]
}
```

## 请求参数

### Header 参数

```text
Content-Type
string
可选
示例:
application/json
Accept
string
可选
示例:
*/*
x-api-key
string
可选
示例:
{{key}}
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
object
示例
{
"model"
:
"claude-3-7-sonnet-20250219"
,
"max_tokens"
:
20000
,
"thinking"
:
{
"type"
:
"enabled"
,
"budget_tokens"
:
16000
}
,
"messages"
:
[
{
"role"
:
"user"
,
"content"
:
"你是谁?"
}
]
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v1/messages' \
--header 'Accept: */*' \
--header 'x-api-key: {{key}}' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "claude-3-7-sonnet-20250219",
    "max_tokens": 20000,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
    },
    "messages": [
        {
            "role": "user",
            "content": "你是谁?"
        }
    ]
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{}
```