Перейти к основному содержанию
API, совместимый с OpenAI, поддерживает документированные форматы запросов и ответов OpenAI. Для поддерживаемых операций это позволяет повторно использовать клиент. Но замена базового URL — лишь начало: отдельно проверяются ID моделей, параметры, инструменты, потоковые события и обработка ошибок.

Подготовка учетной записи и параметров

Выберите модель чата в актуальном каталоге, скопируйте точный ID и проверьте права учетной записи и группы. Создайте ключ Rock API на странице ключей API; ключ исходного поставщика его не заменяет. Изучите правила оплаты и требования к балансу. Сохраните ключ на сервере в ROCK_API_KEY, а ID модели — в ROCK_API_MODEL. Примеры предполагают наличие curl либо пакета openai для выбранного языка. Они показывают Chat Completions и не подтверждают поддержку всех методов SDK или собственных API поставщика. Покупателю не нужно настраивать каналы поставщиков.

Минимальный контрольный запрос

Полный базовый URL SDK — https://rockapi.ai/v1. Не добавляйте второй /v1 и не включайте /chat/completions в базовую настройку SDK. Для curl нужен полный адрес:

Пример на Python

Пример на Node.js

Проверка нужных приложению функций

Начните без необязательных параметров и добавляйте возможности по одной. Сохраняйте версию SDK, ID модели, входные данные и ожидаемое поведение, чтобы воспроизвести расхождения. Успешный текстовый ответ не проверяет изображения или инструменты. Даже за одним адресом разные модели могут предоставлять разные возможности и ответы. См. оценку моделей по задачам.

Перенос трафика с возможностью отката

В тестовой среде повторите типичные обезличенные запросы приложения. Сравните качество, задержки, ошибки и стоимость принятого результата. Ограничьте повторы, чтобы не создавать дублирующую работу и неконтролируемые расходы. Ошибку авторизации не следует повторять бесконечно. Используйте описание ошибок и лимитов, сохраняя время и ID без ключей и закрытых запросов. Наращивайте рабочий трафик после приемки и сохраняйте прежнюю конфигурацию для отката. Сверяйте окончательное использование: временное уменьшение баланса или HTTP-ошибка сами по себе не определяют итоговую оплату.