> ## 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 API key 儲存在 `COMETAPI_KEY`
* 從[模型頁面](/zh-Hant/overview/models)取得一個 Claude model ID
* `curl`、Python 3.10+ 或 Node.js 18+

## API key、base 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 message 陣列、extended thinking、prompt caching 或 tool use。如果你的應用程式已經使用官方 Anthropic SDK，請將 SDK 的 base URL 設為 `https://api.cometapi.com`，並保留 Messages API 的請求格式。

## 常見參數

| Parameter    | Use                                               |
| ------------ | ------------------------------------------------- |
| `model`      | 你的帳戶可用的 Claude model ID。                          |
| `max_tokens` | Messages API 回應的最大回應 Token 預算。                    |
| `messages`   | 包含 `user` 與 `assistant` 角色的 Anthropic message 陣列。 |
| `stream`     | 設為 `true` 時，會串流傳送增量 message 事件。                   |
| `thinking`   | 當所選模型支援時，啟用 Claude extended thinking。             |

## 疑難排解 / 常見問題

<AccordionGroup>
  <Accordion title="請求回傳 401">
    確認 `COMETAPI_KEY` 已在傳送請求的同一個 shell 或執行環境中設定。不要將真實 key 貼到原始碼檔案中。
  </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 Messages API 參考](/api/text/anthropic-messages) 查看完整的請求與回應欄位。
* 在[模型](/zh-Hant/overview/models)中確認模型可用性。
* 使用 [Claude Code 整合指南](/zh-Hant/integrations/claude-code)設定本機程式開發工作階段。
* 在[錯誤代碼與重試策略](/zh-Hant/guides/error-codes-and-retry-strategy)中查看重試行為。