> ## 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.

# Quickstart Claude API: Kirim permintaan Messages dengan CometAPI

> Panggil model Claude melalui Messages API CometAPI yang kompatibel dengan Anthropic menggunakan curl, Python, dan Node.js.

## Yang akan Anda bangun

Anda akan mengirim satu permintaan ke `POST /v1/messages`, mencetak teks respons Claude, dan menyiapkan kode agar siap digunakan dengan Anthropic SDK atau penggunaan HTTP langsung.

## Prasyarat

* API key CometAPI yang disimpan di `COMETAPI_KEY`
* model ID Claude dari [halaman Models](/id/overview/models)
* `curl`, Python 3.10+, atau Node.js 18+

## API key, base URL, autentikasi

Gunakan endpoint Messages yang kompatibel dengan Anthropic melalui CometAPI:

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

Autentikasi permintaan HTTP langsung dengan `x-api-key` dan header versi API Anthropic:

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

## Contoh kode

Gunakan tab di bawah untuk contoh yang dapat disalin dalam cURL, Python, dan 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>

## Penjelasan alur

Permintaan Claude Messages bersifat sinkron secara default. API mengembalikan objek message dalam satu respons HTTP, dan aplikasi Anda membaca blok konten teks pertama.

Gunakan rute ini saat Anda memerlukan bentuk permintaan khusus Claude seperti array message Anthropic, extended thinking, prompt caching, atau penggunaan tool. Jika aplikasi Anda sudah menggunakan Anthropic SDK resmi, atur base URL SDK ke `https://api.cometapi.com` dan pertahankan bentuk permintaan Messages API.

## Parameter umum

| Parameter    | Penggunaan                                                                  |
| ------------ | --------------------------------------------------------------------------- |
| `model`      | model ID Claude yang tersedia untuk akun Anda.                              |
| `max_tokens` | Batas maksimum Token respons untuk respons Messages API.                    |
| `messages`   | Array message Anthropic dengan role `user` dan `assistant`.                 |
| `stream`     | Melakukan stream event message inkremental saat disetel ke `true`.          |
| `thinking`   | Mengaktifkan extended thinking Claude saat model yang dipilih mendukungnya. |

## Pemecahan masalah / FAQ

<AccordionGroup>
  <Accordion title="Permintaan mengembalikan 401">
    Pastikan `COMETAPI_KEY` disetel di shell atau runtime yang sama dengan yang mengirim permintaan. Jangan tempelkan key asli ke dalam file sumber.
  </Accordion>

  <Accordion title="SDK masih memanggil Anthropic secara langsung">
    Pastikan klien SDK menetapkan `base_url` di Python atau `baseURL` di Node.js ke `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Model mana yang sebaiknya saya gunakan">
    Gunakan model ID Claude yang tersedia untuk akun Anda. Quickstart ini tidak melakukan hardcode model Claude karena ketersediaannya berbeda menurut akun dan keluarga model.
  </Accordion>
</AccordionGroup>

## Langkah berikutnya

* Gunakan [referensi Anthropic Messages API](/api/text/anthropic-messages) untuk field permintaan dan respons lengkap.
* Periksa ketersediaan model di [Models](/id/overview/models).
* Konfigurasikan sesi coding lokal dengan [panduan integrasi Claude Code](/id/integrations/claude-code).
* Tinjau perilaku retry di [Kode error dan strategi retry](/id/guides/error-codes-and-retry-strategy).