> ## 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 リクエストを送信する

> curl、Python、Node.js を使って、CometAPI の Anthropic 互換 Messages API 経由で Claude モデルを呼び出します。

## 作成するもの

`POST /v1/messages` に 1 回リクエストを送り、Claude のレスポンステキストを出力し、Anthropic SDK または直接 HTTP で使える状態のコードを用意します。

## 前提条件

* `COMETAPI_KEY` に保存された CometAPI API キー
* [Models page](/ja/overview/models) の Claude model ID
* `curl`、Python 3.10+、または Node.js 18+

## API キー、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 は 1 回の HTTP レスポンスで message オブジェクトを返し、アプリケーションは最初の text content ブロックを読み取ります。

Anthropic の message 配列、拡張 thinking、プロンプト（Prompt）キャッシュ、tool use など、Claude 固有のリクエスト形式が必要な場合はこのルートを使用します。アプリケーションがすでに公式の Anthropic SDK を使用している場合は、SDK の base URL を `https://api.cometapi.com` に設定し、Messages API のリクエスト形式はそのまま維持してください。

## 一般的なパラメータ

| Parameter    | Use                                                   |
| ------------ | ----------------------------------------------------- |
| `model`      | アカウントで利用可能な Claude model ID。                          |
| `max_tokens` | Messages API レスポンスに対する最大レスポンストークン予算。                  |
| `messages`   | `user` と `assistant` の role を持つ Anthropic message 配列。 |
| `stream`     | `true` に設定すると、増分の message イベントをストリーミングします。            |
| `thinking`   | 選択したモデルが対応している場合に Claude の拡張 thinking を有効にします。        |

## トラブルシューティング / FAQ

<AccordionGroup>
  <Accordion title="リクエストが 401 を返す">
    `COMETAPI_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 reference](/api/text/anthropic-messages) を参照してください。
* モデルの利用可否は [Models](/ja/overview/models) で確認してください。
* ローカルのコーディングセッションを設定するには、[Claude Code integration guide](/ja/integrations/claude-code) を参照してください。
* リトライ動作については、[Error codes and retry strategy](/ja/guides/error-codes-and-retry-strategy) を確認してください。