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

# Начало работы с CometAPI: создайте API key и выполните свой первый запрос

> Начните работу с CometAPI: создайте API key, укажите base URL и отправьте свой первый API-запрос через curl, Python или Node.js.

## Создайте аккаунт и API key

Создайте аккаунт CometAPI и API key перед вызовом API.

<Steps>
  <Step title="Войдите или создайте аккаунт">
    Откройте [страницу входа CometAPI](https://www.cometapi.com/console/login). Продолжите через Google, продолжите через GitHub или введите свой email либо имя пользователя. Если у вас нет аккаунта, завершите его создание на этой странице.

    <Frame>
      <img src="https://mintcdn.com/cometapi/BtE3Lagaukxd3efj/images/overview/cometapi-console-login.png?fit=max&auto=format&n=BtE3Lagaukxd3efj&q=85&s=988bee0055bf1ce2552a8d877a48a97d" alt="Страница входа CometAPI с вариантами входа через Google, GitHub и email" width="1280" height="720" data-path="images/overview/cometapi-console-login.png" />
    </Frame>
  </Step>

  <Step title="Откройте API keys">
    После входа откройте [страницу API key](https://www.cometapi.com/console/token). Вы также можете выбрать **API Keys** в боковой панели панели управления.
  </Step>

  <Step title="Создайте API key">
    Нажмите **Create API Key**, введите понятное имя, например `local-test`, и оставьте **Unlimited Quota** включённым для первого теста, если только вы не хотите задать лимит расходов. Нажмите **Create**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Страница API keys CometAPI с выделенной кнопкой Create API Key и диалогом создания" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>
  </Step>

  <Step title="Скопируйте API key">
    Нажмите кнопку копирования в столбце **Key**. Сохраните скопированный ключ в серверной переменной окружения или в локальном файле `.env`. Не вставляйте настоящий API key в публичные репозитории, frontend-код, скриншоты или обращения в поддержку.

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Таблица API keys CometAPI с выделенной кнопкой копирования для скрытого API key" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>
</Steps>

В примерах запросов `COMETAPI_KEY` считывается из вашего окружения.

## Сохраните ваш API key локально

Для локального тестирования экспортируйте ваш API key как переменную окружения:

```bash theme={null}
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
```

## Base URL

Используйте этот base URL для OpenAI-совместимых SDK и вызовов API:

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

## Переключение с OpenAI за 30 секунд

После получения API key CometAPI используйте это изменение из двух настроек при переключении клиента OpenAI SDK на CometAPI:

```diff theme={null}
- base_url="https://api.openai.com/v1"
- api_key=os.environ["OPENAI_API_KEY"]
+ base_url="https://api.cometapi.com/v1"
+ api_key=os.environ["COMETAPI_KEY"]
```

CometAPI использует OpenAI-совместимые форматы запросов для распространённых текстовых, графических, аудио- и видео-сценариев. Если ваше приложение уже использует OpenAI SDK, начните с изменения base URL и API key.

## Сделайте свой первый вызов

После того как вы зададите `COMETAPI_KEY` в своём окружении, замените `your-model-id` на актуальный model ID со страницы [Models page](/ru/overview/models).

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/chat/completions \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "messages": [
        {
          "role": "user",
          "content": "Write a one-sentence bedtime story."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write a one-sentence bedtime story.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write a one-sentence bedtime story.",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
  ```
</CodeGroup>

## Выберите модель

Выберите model ID на странице [Models page](/ru/overview/models), затем передайте это значение в поле `model`.

| Цель                  | С чего начать                                                                                                                                    |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Чат или общий текст   | Используйте GPT, Claude, Gemini, DeepSeek или другую чат-модель с [Chat Completions](/api/text/chat).                                            |
| Кодинг и рассуждение  | Используйте модель для кодинга или рассуждений с [Responses](/api/text/responses), если модель требует API Responses.                            |
| Генерация изображений | Используйте модель изображений с [Create image](/api/image/openai/images) или руководство по изображениям для конкретного провайдера.            |
| Генерация видео       | Используйте видеомодель со страницей video API, соответствующей рабочему процессу провайдера, например [Create video](/api/video/sora-2/create). |

## Что дальше

* В случае ошибок запроса см. [Error Codes & Handling](/ru/errors/error-codes-handling).
* Рекомендации по повторам запросов см. в [how to handle rate limits](/api/text/chat#how-to-handle-rate-limits).
* Для использования конкретных моделей начните с [Chat Completions](/api/text/chat), [Responses](/api/text/responses), [Create image](/api/image/openai/images) или [Create video](/api/video/sora-2/create).
* Подробности о тарификации см. в [About Pricing](/ru/pricing/about-pricing).
* Чтобы приглашать участников команды и управлять общими Credits, см. [Управление командой в Workspace](/ru/workspace/overview).
* Чтобы получить помощь, см. [Help Center](/ru/support/help-center) или свяжитесь с [CometAPI support](https://www.cometapi.com/support/).

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Как создать аккаунт CometAPI?">
    Откройте [страницу входа CometAPI](https://www.cometapi.com/console/login), затем продолжите через Google, GitHub или введите свою электронную почту либо имя пользователя. Если у вас нет аккаунта, завершите его создание на той же странице.
  </Accordion>

  <Accordion title="Как получить API key CometAPI?">
    Откройте [страницу API key](https://www.cometapi.com/console/token) в панели CometAPI, нажмите **Create API Key**, введите имя, нажмите **Create** и скопируйте сгенерированный API key. В примерах используйте `$COMETAPI_KEY` вместо настоящего API key.
  </Accordion>

  <Accordion title="Где следует хранить мой API key?">
    Храните API key в переменной окружения на стороне сервера или в локальном файле `.env`. Не коммитьте его в публичные репозитории, не вставляйте во frontend-код, не включайте в скриншоты и не отправляйте в тикетах поддержки.
  </Accordion>

  <Accordion title="Какой base URL CometAPI использовать для API-вызовов?">
    Используйте `https://api.cometapi.com/v1` для OpenAI-совместимых SDK и endpoint, таких как `/v1/chat/completions`.
  </Accordion>

  <Accordion title="Работает ли CometAPI с OpenAI Python SDK?">
    Да. Создайте клиент `OpenAI`, установите `api_key` в значение вашего API key CometAPI и задайте `base_url` как `https://api.cometapi.com/v1`.
  </Accordion>

  <Accordion title="Как перейти с OpenAI на CometAPI?">
    Измените base URL на `https://api.cometapi.com/v1`, замените API key на ваш API key CometAPI и используйте model ID CometAPI со [страницы Models](/ru/overview/models).
  </Accordion>

  <Accordion title="Какой model ID стоит использовать первым?">
    Выбирайте model ID в зависимости от сценария использования. Начните со [страницы Models](/ru/overview/models), затем выберите модель для чата, кодинга, изображений или видео, соответствующую странице API, которую вы планируете вызывать.
  </Accordion>

  <Accordion title="Какие языки программирования поддерживает CometAPI?">
    CometAPI работает с любым языком программирования, который может отправлять HTTPS-запросы. Начните с примеров curl, Python и Node.js на этой странице или используйте OpenAI-совместимый SDK, который позволяет переопределить base URL.
  </Accordion>

  <Accordion title="Предоставляет ли CometAPI бесплатный пробный период или бесплатный API key?">
    Вы можете создать API key CometAPI в панели управления. Чтобы проверить доступность бесплатного пробного периода, пробные кредиты и сведения о биллинге, см. [страницу цен CometAPI](https://www.cometapi.com/pricing/) и [About Pricing](/ru/pricing/about-pricing).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "name": "Краткое руководство по CometAPI: создайте API key и выполните свой первый вызов",
        "description": "Краткое руководство по CometAPI для новых пользователей: войдите, создайте API key, скопируйте ключ, задайте base URL и выполните свой первый API-вызов с помощью curl, Python или Node.js.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#sign-in-or-create-an-account",
            "name": "Войдите или создайте аккаунт",
            "text": "Откройте https://www.cometapi.com/console/login и продолжите через Google, GitHub или email."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#open-api-keys",
            "name": "Откройте API keys",
            "text": "После входа откройте https://www.cometapi.com/console/token или выберите API Keys в боковой панели панели управления."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#create-an-api-key",
            "name": "Создайте API key",
            "text": "Нажмите Create API Key, введите имя, выберите настройку квоты и нажмите Create."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#copy-the-api-key",
            "name": "Скопируйте API key",
            "text": "Нажмите кнопку копирования в столбце Key и сохраните ключ в переменной окружения на стороне сервера или в локальном файле .env."
          },
          {
            "@type": "HowToStep",
            "name": "Задайте base URL",
            "text": "Используйте https://api.cometapi.com/v1 в качестве base URL для OpenAI-совместимых SDK и API-вызовов."
          },
          {
            "@type": "HowToStep",
            "name": "Выполните свой первый вызов",
            "text": "Вызовите /v1/chat/completions с помощью curl, Python или Node.js и замените your-model-id на актуальный model ID со страницы Models CometAPI."
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "Как создать аккаунт CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Откройте страницу входа CometAPI и продолжите через Google, GitHub или email. Если у вас нет аккаунта, завершите его создание на той же странице."
            }
          },
          {
            "@type": "Question",
            "name": "Как получить API key CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Откройте страницу API key в панели CometAPI, нажмите Create API Key, введите имя, нажмите Create и скопируйте сгенерированный API key."
            }
          },
          {
            "@type": "Question",
            "name": "Где следует хранить мой API key?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Храните API key в переменной окружения на стороне сервера или в локальном файле .env. Не коммитьте его в публичные репозитории, не вставляйте во frontend-код, не включайте в скриншоты и не отправляйте в тикетах поддержки."
            }
          },
          {
            "@type": "Question",
            "name": "Какой base URL CometAPI использовать для API-вызовов?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Используйте https://api.cometapi.com/v1 для OpenAI-совместимых SDK и endpoint."
            }
          },
          {
            "@type": "Question",
            "name": "Работает ли CometAPI с OpenAI Python SDK?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Да. Создайте клиент OpenAI, установите api_key в значение вашего API key CometAPI и задайте base_url как https://api.cometapi.com/v1."
            }
          },
          {
            "@type": "Question",
            "name": "Как перейти с OpenAI на CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Измените base URL на https://api.cometapi.com/v1, замените API key на ваш API key CometAPI и используйте model ID CometAPI со страницы Models."
            }
          },
          {
            "@type": "Question",
            "name": "Какой model ID стоит использовать первым?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Выбирайте model ID в зависимости от сценария использования. Начните со страницы Models, затем выберите модель для чата, кодинга, изображений или видео, соответствующую странице API, которую вы планируете вызывать."
            }
          },
          {
            "@type": "Question",
            "name": "Какие языки программирования поддерживает CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI работает с любым языком программирования, который может отправлять HTTPS-запросы. Начните с примеров curl, Python и Node.js или используйте OpenAI-совместимый SDK, который позволяет переопределить base URL."
            }
          },
          {
            "@type": "Question",
            "name": "Предоставляет ли CometAPI бесплатный пробный период или бесплатный API key?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Вы можете создать API key CometAPI в панели управления. Чтобы проверить доступность бесплатного пробного периода, пробные кредиты и сведения о биллинге, см. страницу цен CometAPI и страницу About Pricing."
            }
          }
        ]
      }
    ]
    }
    `}
</script>