Claude Messages（思考） - 数字先锋API文档

## Claude Messages（思考）

### 接口地址
`POST /v1/messages`

### 功能说明
调用支持“思考（thinking）”能力的模型进行对话。在开启 thinking 后，模型会使用额外的思考预算来提升复杂任务表现。

---

### 请求头（Headers）

| Header | 必填 | 说明 |
|---|---|---|
| Content-Type: application/json | 是 | 请求体格式 |
| Authorization: Bearer {API_KEY} | 建议 | Bearer 鉴权 |

| Accept: */* | 否 | 可选 |

---

### 请求参数（Body）

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，例如 `claude-3-7-sonnet-20250219` |
| max_tokens | integer | 是 | 最大输出 token 数 |
| thinking | object | 否 | 思考配置 |
| thinking.type | string | 否 | 固定为 `enabled`（开启思考） |
| thinking.budget_tokens | integer | 否 | 思考预算 token，需小于 `max_tokens` |
| messages | array | 是 | 对话消息列表 |
| messages[].role | string | 是 | 角色，如 `user` |
| messages[].content | string/array | 是 | 用户输入内容 |

---

### 请求示例（cURL）

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

---

### 成功响应示例

```json
{
  "id": "chatcmpl-1774034478516190381",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "我是 Kiro，一个为开发者打造的 AI 助手和 IDE。..."
    }
  ],
  "stop_reason": "end_turn",
  "model": "claude-sonnet-4-5-20250929",
  "usage": {
    "input_tokens": 7,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 161,
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}
```

---

### 字段说明（响应）

| 字段 | 说明 |
|---|---|
| id | 请求唯一 ID |
| type | 返回对象类型，通常为 `message` |
| role | 返回角色，通常为 `assistant` |
| content | 模型输出内容数组 |
| stop_reason | 停止原因，如 `end_turn` |
| model | 实际执行模型（可能与请求 model 映射后不同） |
| usage | token 使用统计 |

---

上一篇：Claude Messages（识图）下一篇：Claude Messages（函数调用）