> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Шлюз API для ИИ: модели, оплата и первый запрос

> Разберитесь в назначении шлюза ИИ и проверьте доступ к модели с ключом платформы, полным базовым URL и журналом окончательных списаний.

**Шлюз API для ИИ** находится между приложением и поставщиками моделей. Он проверяет авторизацию, направляет запрос поддерживаемой модели и возвращает ответ через документированный интерфейс. Это позволяет сократить повторяющиеся настройки и свести поддерживаемые вызовы в один журнал. Поведение разных моделей при этом не становится одинаковым.

У сервиса OpenAPI могут быть собственные подписка, авторизация и адреса. Его нельзя автоматически вызывать как модель чата.

## Сравнение с прямым подключением

Прямое подключение может подходить приложению, зависящему от собственных функций одного поставщика. Шлюз полезно рассмотреть при оценке нескольких семейств моделей, объединении управления ключами и учета расходов. Перед переносом трафика проверьте фактический объем предоставляемых функций.

| Критерий | Прямой доступ | Что проверить у шлюза |
| - | - | - |
| Клиент | API каждого поставщика | Поддерживаемые методы и работу SDK |
| Возможности | Текущую документацию поставщика | Функции, доступные для выбранной модели |
| Расходы | Отдельные счета | Тариф, примененную группу и окончательное списание |
| Эксплуатация | Ошибки поставщика | Также ошибки шлюза, тайм-ауты и ограничения |

Полный базовый URL моделей Rock API, совместимых с OpenAI: `https://rockapi.ai/v1`. Совместимость относится к поддерживаемым запросам и моделям. Единый адрес сам по себе не гарантирует автоматическое переключение, одинаковые ответы или все собственные функции поставщика.

## Первый вызов для покупателя

1. Откройте [актуальный каталог и цены](https://rockapi.ai/pricing). Выберите модель с поддержкой чата, скопируйте точный ID и проверьте доступ учетной записи и выбранной группы.
2. [Создайте учетную запись](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=docs_launch), проверьте требования к балансу и выпустите ключ на странице [ключей API](https://rockapi.ai/keys). Сохраните его на сервере в `ROCK_API_KEY`.
3. Запишите скопированный ID в `ROCK_API_MODEL`. SDK использует базовый URL `https://rockapi.ai/v1`, а curl — полный адрес ниже.
4. Начните с короткого текста, затем добавляйте инструменты, изображения и потоковую выдачу.

```bash theme={null}
curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ROCK_API_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Ответь: привет.\"}]}"
```

Перед запуском задайте обе переменные локально. ID зависит от каталога и прав учетной записи; доступность конкретной модели здесь не обещается. Покупатель выбирает доступную модель и создает ключ платформы, не настраивая каналы поставщиков.

## Проверка ответа и оплаты

Проверьте HTTP-статус, тело, модель и возвращенные сведения об использовании. Найдите соответствующую запись в панели: сопоставьте группу, категории использования и окончательную сумму. [Руководство по оплате](https://docs.rockapi.ai/ru/pricing-and-billing.md) различает оплату за использование, за вызов и динамический расчет. Временный резерв может отличаться от итогового списания. Единой скидки для всех моделей нет.

При `401` или `403` проверьте ключ и права; при `400` или `404` — модель, тело и путь. При `429` сначала проверьте квоту и ограничения частоты. Сохраните время и доступный ID запроса, удалив секреты, и обратитесь к [описанию ошибок и ограничений](https://docs.rockapi.ai/ru/errors-and-rate-limits.md).

После успешного минимального вызова выполните [проверки миграции](https://docs.rockapi.ai/ru/blog/buyers/openai-compatible-api.md). Прежде чем передавать закрытые данные дополнительному посреднику, изучите [безопасность и конфиденциальность](https://docs.rockapi.ai/ru/security-and-privacy.md) и применимые условия.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.