Быстрый старт: первый запрос
Документация GonkaGate для разработчиков: отправьте первый OpenAI-совместимый запрос.
Отправьте один OpenAI-совместимый POST /v1/chat/completions через GonkaGate, чтобы проверить доступ к Gonka Network. Для этого нужны https://api.gonkagate.com/v1, заголовок Authorization: Bearer gp-... и актуальный ID модели из GET /v1/models.
Перед стартом
- Подтверждённый аккаунт GonkaGate
gp-...API-ключ; если его нужно создать, используйте Аутентификацию и API-ключи- Сохраните ключ сразу после показа. Позже полный секрет не раскрывается.
- Достаточный доступный баланс для запроса
Если нужны безопасное хранение или ротация, используйте Аутентификацию и API-ключи.
Отправьте запрос
Возьмите актуальный ID модели из GET /v1/models. Если эндпоинт вернёт 503, повторите запрос с коротким backoff и ограниченным числом попыток. Не копируйте ID из HTML /models и не угадывайте их вручную.
export GONKAGATE_API_KEY="gp-your-api-key"
curl https://api.gonkagate.com/v1/chat/completions \
-H "Authorization: Bearer $GONKAGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
"messages": [
{ "role": "user", "content": "Hello, Gonka!" }
]
}'Ожидаемый результат
Успешный запрос возвращает 200 OK. Ответ модели находится в choices[0].message.content.
Частые первые ошибки
| Ответ | Что это обычно значит | Что проверить дальше |
|---|---|---|
401 invalid_api_key | Заголовок авторизации отсутствует или имеет неверный формат, ключ недействителен, отключён или истёк, либо email аккаунта ещё не подтверждён. | Аутентификация и API-ключи |
404 model_not_found | ID модели устарел или сейчас недоступен. | Гайд по выбору моделей |
429 insufficient_quota | На аккаунте недостаточно доступного баланса для запроса. | Страница цен |
См. также
- OpenAI SDK для GonkaGate, чтобы перенести этот запрос в код приложения.
- Обзор справочника API для точных полей запроса, стриминга, ретраев и runtime-поведения после первого успешного вызова.
- Гайд по миграции с OpenAI на GonkaGate, если у вас уже есть рабочая OpenAI-совместимая интеграция и нужен только переход на GonkaGate.
Была ли эта страница полезной?
