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

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

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

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

  1. Откройте актуальный каталог и цены. Выберите модель с поддержкой чата, скопируйте точный ID и проверьте доступ учетной записи и выбранной группы.
  2. Создайте учетную запись, проверьте требования к балансу и выпустите ключ на странице ключей API. Сохраните его на сервере в ROCK_API_KEY.
  3. Запишите скопированный ID в ROCK_API_MODEL. SDK использует базовый URL https://rockapi.ai/v1, а curl — полный адрес ниже.
  4. Начните с короткого текста, затем добавляйте инструменты, изображения и потоковую выдачу.
Перед запуском задайте обе переменные локально. ID зависит от каталога и прав учетной записи; доступность конкретной модели здесь не обещается. Покупатель выбирает доступную модель и создает ключ платформы, не настраивая каналы поставщиков.

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

Проверьте HTTP-статус, тело, модель и возвращенные сведения об использовании. Найдите соответствующую запись в панели: сопоставьте группу, категории использования и окончательную сумму. Руководство по оплате различает оплату за использование, за вызов и динамический расчет. Временный резерв может отличаться от итогового списания. Единой скидки для всех моделей нет. При 401 или 403 проверьте ключ и права; при 400 или 404 — модель, тело и путь. При 429 сначала проверьте квоту и ограничения частоты. Сохраните время и доступный ID запроса, удалив секреты, и обратитесь к описанию ошибок и ограничений. После успешного минимального вызова выполните проверки миграции. Прежде чем передавать закрытые данные дополнительному посреднику, изучите безопасность и конфиденциальность и применимые условия.