> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude API 快速入门：通过 CometAPI 发送 Messages 请求

> 通过 CometAPI 兼容 Anthropic 的 Messages API，使用 curl、Python 和 Node.js 调用 Claude 模型。

## 你将构建什么

你将向 `POST /v1/messages` 发送一个请求，打印 Claude 的响应文本，并让代码可直接用于 Anthropic SDK 或直接 HTTP 调用。

## 前提条件

* 一个存储在 `COMETAPI_KEY` 中的 CometAPI API 密钥
* 一个来自[模型页面](/zh-Hans/overview/models)的 Claude model ID
* `curl`、Python 3.10+ 或 Node.js 18+

## API 密钥、基础 URL、身份验证

通过 CometAPI 使用兼容 Anthropic 的 Messages 端点：

```text theme={null}
https://api.cometapi.com/v1/messages
```

对直接 HTTP 请求，使用 `x-api-key` 和 Anthropic API 版本请求头进行身份验证：

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## 代码示例

使用下面的标签页查看可复制的 cURL、Python 和 Node.js 示例。

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

  client = anthropic.Anthropic(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com",
  )

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
  });

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

  console.log(message.content[0].text);
  ```
</CodeGroup>

## 流程说明

Claude Messages 请求默认是同步的。API 会在一次 HTTP 响应中返回一个 message 对象，而你的应用程序读取第一个文本 content 块。

当你需要 Claude 特有的请求结构时，请使用此路由，例如 Anthropic 消息数组、扩展思考、Prompt 缓存或工具使用。如果你的应用程序已经在使用官方 Anthropic SDK，请将 SDK 的基础 URL 设置为 `https://api.cometapi.com`，并保持 Messages API 的请求结构不变。

## 常见参数

| Parameter    | Use                                         |
| ------------ | ------------------------------------------- |
| `model`      | 你的账户可用的 Claude model ID。                    |
| `max_tokens` | Messages API 响应的最大响应 token 预算。              |
| `messages`   | 包含 `user` 和 `assistant` 角色的 Anthropic 消息数组。 |
| `stream`     | 设置为 `true` 时，以流式方式返回增量消息事件。                 |
| `thinking`   | 当所选模型支持时，启用 Claude 扩展思考。                    |

## 故障排查 / FAQ

<AccordionGroup>
  <Accordion title="请求返回 401">
    确认 `COMETAPI_KEY` 已在发送请求的同一 shell 或运行时环境中设置。不要将真实密钥粘贴到源文件中。
  </Accordion>

  <Accordion title="SDK 仍然直接调用 Anthropic">
    确认 SDK 客户端在 Python 中将 `base_url` 或在 Node.js 中将 `baseURL` 设置为 `https://api.cometapi.com`。
  </Accordion>

  <Accordion title="我应该使用哪个模型">
    使用你的账户可用的 Claude model ID。此快速入门没有硬编码 Claude 模型，因为不同账户和模型系列的可用性会有所变化。
  </Accordion>
</AccordionGroup>

## 后续步骤

* 使用[Anthropic 消息 API 参考](/api/text/anthropic-messages)查看完整的请求和响应字段。
* 在[模型](/zh-Hans/overview/models)中检查模型可用性。
* 使用 [Claude Code 集成指南](/zh-Hans/integrations/claude-code) 配置本地编码会话。
* 在[错误代码和重试策略](/zh-Hans/guides/error-codes-and-retry-strategy)中查看重试行为。