> ## 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](/ru/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 возвращает объект message в одном HTTP-ответе, а ваше приложение считывает первый текстовый блок content.

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

## Общие параметры

| Parameter    | Use                                                                                              |
| ------------ | ------------------------------------------------------------------------------------------------ |
| `model`      | model ID Claude, доступный вашему аккаунту.                                                      |
| `max_tokens` | Максимальный бюджет токенов ответа для ответа Messages API.                                      |
| `messages`   | Массив сообщений Anthropic с ролями `user` и `assistant`.                                        |
| `stream`     | Передаёт инкрементальные события сообщений в режиме Streaming, если установлено значение `true`. |
| `thinking`   | Включает extended thinking Claude, если выбранная модель это поддерживает.                       |

## Устранение неполадок / FAQ

<AccordionGroup>
  <Accordion title="Запрос возвращает 401">
    Убедитесь, что `COMETAPI_KEY` задан в той же оболочке или среде выполнения, которая отправляет запрос. Не вставляйте настоящий ключ в исходные файлы.
  </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](/api/text/anthropic-messages) для полного списка полей запроса и ответа.
* Проверьте доступность моделей в [Models](/ru/overview/models).
* Настройте локальные сессии кодирования с помощью [руководства по интеграции Claude Code](/ru/integrations/claude-code).
* Ознакомьтесь с поведением повторных попыток в [Коды ошибок и стратегия повторных попыток](/ru/guides/error-codes-and-retry-strategy).