> ## 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: надсилайте запити Messages через CometAPI

> Викликайте моделі Claude через сумісний з Anthropic Messages API від CometAPI за допомогою curl, Python і Node.js.

## Що ви створите

Ви надішлете один запит до `POST /v1/messages`, виведете текст відповіді Claude і збережете код готовим для використання з Anthropic SDK або напряму через HTTP.

## Передумови

* API-ключ CometAPI, збережений у `COMETAPI_KEY`
* model ID Claude зі сторінки [Models page](/uk/overview/models)
* `curl`, Python 3.10+ або Node.js 18+

## API-ключ, base URL, автентифікація

Використовуйте сумісний з Anthropic endpoint Messages через CometAPI:

```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-відповіді, а ваш застосунок зчитує перший текстовий блок content.

Використовуйте цей маршрут, коли вам потрібні специфічні для Claude форми запитів, як-от масиви повідомлень Anthropic, extended thinking, кешування prompt або використання інструментів. Якщо ваш застосунок уже використовує офіційний Anthropic SDK, установіть base URL SDK на `https://api.cometapi.com` і збережіть форму запиту Messages API.

## Поширені параметри

| Parameter    | Use                                                                        |
| ------------ | -------------------------------------------------------------------------- |
| `model`      | model ID Claude, доступний для вашого акаунта.                             |
| `max_tokens` | Максимальний бюджет токенів відповіді для відповіді Messages API.          |
| `messages`   | Масив повідомлень Anthropic з ролями `user` і `assistant`.                 |
| `stream`     | Передає інкрементальні події повідомлень потоком, якщо встановлено `true`. |
| `thinking`   | Увімкнює Claude extended thinking, якщо вибрана модель це підтримує.       |

## Усунення проблем / FAQ

<AccordionGroup>
  <Accordion title="Запит повертає 401">
    Переконайтеся, що `COMETAPI_KEY` задано в тій самій оболонці або runtime-середовищі, яке надсилає запит. Не вставляйте справжній ключ у вихідні файли.
  </Accordion>

  <Accordion title="SDK усе ще викликає Anthropic напряму">
    Переконайтеся, що клієнт SDK задає `base_url` у Python або `baseURL` у Node.js як `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Яку модель слід використовувати">
    Використовуйте model ID Claude, доступний для вашого акаунта. У цьому швидкому старті не зашито жорстко модель Claude, оскільки доступність залежить від акаунта та сімейства моделей.
  </Accordion>
</AccordionGroup>

## Наступні кроки

* Використовуйте [Anthropic Messages API reference](/api/text/anthropic-messages) для повного переліку полів запиту й відповіді.
* Перевірте доступність моделей у [Models](/uk/overview/models).
* Налаштуйте локальні сесії кодування за допомогою [Claude Code integration guide](/uk/integrations/claude-code).
* Перегляньте поведінку повторних спроб у [Error codes and retry strategy](/uk/guides/error-codes-and-retry-strategy).