Миграция с OpenAI на GonkaGate
Перенесите существующую OpenAI-совместимую интеграцию chat.completions на GonkaGate.
Перенесите существующую OpenAI-совместимую интеграцию chat.completions на GonkaGate: смените base URL, API-ключ и ID модели, затем проверьте переключение через GET /v1/models и один POST /v1/chat/completions. Держите миграцию узкой: сначала переключите транспортный слой, подтвердите паритет, и только потом меняйте промпты или более широкую логику приложения.
Перед переключением
- Верифицированный аккаунт GonkaGate
- Сохранённый API-ключ формата
gp-... - Актуальный ID модели из
GET /v1/modelsдля сценария, который вы переносите - Достаточный предоплаченный USD-баланс для проверки и выкладки
- Уже работающий OpenAI-совместимый путь в приложении
Замените только три значения
- Установите
base_urlилиbaseURLвhttps://api.gonkagate.com/v1 - Замените OpenAI-ключ формата
sk-...на ключ GonkaGate форматаgp-... - Замените имя модели OpenAI на актуальный ID модели GonkaGate из
GET /v1/models
from openai import OpenAI
client = OpenAI(
- base_url="https://api.openai.com/v1",
+ base_url="https://api.gonkagate.com/v1",
- api_key="sk-..."
+ api_key="gp-..."
)
response = client.chat.completions.create(
- model="gpt-5.2",
+ model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
messages=[{"role": "user", "content": "Say hello from GonkaGate"}]
)Проверьте миграцию
curl https://api.gonkagate.com/v1/models \
-H "Authorization: Bearer gp-your-api-key"curl https://api.gonkagate.com/v1/chat/completions \
-H "Authorization: Bearer gp-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
"messages": [
{ "role": "user", "content": "Say hello from GonkaGate" }
]
}'Ожидаемый результат:
GET /v1/modelsвозвращает список моделейPOST /v1/chat/completionsвозвращает обычный ответ сchoices[0].message.content
Частые ошибки при миграции
| Ответ | Что это обычно значит | Что делать |
|---|---|---|
401 invalid_api_key | Ошибка в Bearer-заголовке, значении ключа или состоянии аккаунта | Проверьте Authorization: Bearer gp-... и убедитесь, что ключ активен |
404 model_not_found | ID модели устарел или не поддерживается | Обновите ID через GET /v1/models, прежде чем считать миграцию сломанной |
429 insufficient_quota | Для запроса недостаточно доступного баланса | Пополните баланс или уменьшите объём тестового трафика перед выкладкой |
429 rate_limit_exceeded | Вы упёрлись в rate limit | Обрабатывайте это ограниченными retry, а не как специальную ошибку миграции |
5xx | Временная ошибка платформы или апстрима | Повторите запрос с ограниченным backoff и проверьте, сохраняется ли ошибка |
Ограничения и нюансы совместимости
- В
usageмогут появляться дополнительные поля стоимости, напримерbase_cost_usd,platform_fee_usdиtotal_cost_usd, поэтому строгая типизация ответа должна допускать добавочные поля. - Этот гайд покрывает
chat.completionsиGET /v1/models. Если приложение зависит от embeddings, Responses API, Assistants, Audio, Batch или fine-tuning, эти потоки пока лучше оставить у другого провайдера. - Streaming, tools, JSON mode и vision зависят от выбранной модели и используемого API-режима. Перед выкладкой проверьте поддержку для конкретной модели.
Смотрите также
- OpenAI SDK Compatibility for GonkaGate для переноса этого переключения в боевой код
- Аутентификация и API-ключи для создания ключей, хранения, ротации и auth-ошибок
- Гайд по выбору моделей для выбора и обновления ID модели GonkaGate
- Обзор API reference для полей запроса, стриминга и retry-политики после успешной миграции
- Pricing для правил USD-биллинга и разбивки стоимости
Была ли эта страница полезной?
