Аутентификация
Узнайте, как аутентифицировать ваши API-запросы к GonkaGate.
Ищете хаб Gonka API ? Начните здесь.
Обзор
GonkaGate использует два метода аутентификации в зависимости от типа эндпоинта:
Аутентификация по API-ключу
Для всех /v1/* эндпоинтов (Chat Completions, Models). Используйте Bearer-токен в заголовке Authorization.
/v1/*Получение API-ключа
Следуйте этим шагам для получения API-ключа:
Внимание
Важно: Сохраните ключ: Ваш API-ключ показывается только один раз при создании. Скопируйте и сохраните его сразу в надёжном месте. При утере вам придётся создать новый ключ.
Использование API-ключа
Включайте ваш API-ключ в заголовок Authorization всех API-запросов:
HTTP Header
Authorization: Bearer gp-your-api-key-hereФормат API-ключа
API-ключи GonkaGate всегда начинаются с префикса 'gp-'
gp-*Примеры кода
Вот как использовать ваш API-ключ на разных языках:
python
from openai import OpenAI
client = OpenAI(
base_url="https://api.gonkagate.com/v1",
api_key="gp-your-api-key-here" # Get from dashboard
)
response = client.chat.completions.create(
model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)Лучшие практики безопасности
Следуйте этим рекомендациям для защиты вашего API-ключа:
- Никогда не размещайте во фронтенд-коде — Никогда не включайте API-ключ в клиентский JavaScript. Он будет виден в инструментах разработчика браузера.
- Используйте переменные окружения — Храните API-ключ в переменных окружения, а не в исходном коде.
- Ротируйте при компрометации — Если вы подозреваете, что ключ скомпрометирован, выполните ротацию в дашборде (создайте новый ключ и отключите старый).
Смотрите Security для обзора политики и Best Practices для продакшн-рекомендаций.
Использование переменных окружения
python
import os
from openai import OpenAI
# Read from environment variable
client = OpenAI(
base_url="https://api.gonkagate.com/v1",
api_key=os.environ.get("GONKAGATE_API_KEY")
)
# Now use client as normal
response = client.chat.completions.create(
model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
messages=[{"role": "user", "content": "Hello!"}]
)Ротация API-ключей
Ротируйте ключи, создавая новый ключ, сохраняя его, а затем отключая (или удаляя) старый ключ.
Ротируйте безопасно
Сначала создайте и сохраните новый ключ. Только после этого отключайте или удаляйте старый ключ и обновляйте ваши приложения.
Ключевые моменты
- Всегда храните API-ключи в переменных окружения, никогда в исходном коде
- Корректно обрабатывайте ошибки 401 (неверный ключ) и 402 (недостаточно средств)
- Ротируйте ключи, создавая новый и отключая старый
- Никогда не раскрывайте API-ключи во фронтенд/клиентском коде