FAQ по GonkaGate
Технические и биллинговые ответы для разработчиков, использующих Gonka Network через GonkaGate.
Нужен полный обзор шлюза? обзор Gonka API для настройки, совместимости и продуктового контекста.
Нужны актуальные правила списаний и примеры расчета? Смотрите страницу цен. Нужны точные детали по эндпоинтам? Откройте справочник API.
Быстрый старт
GonkaGate - это API-шлюз для доступа к AI-моделям сети Gonka без крипто-кошелька. Платите в USD и используете OpenAI-совместимый API. Если нужен полный обзор продукта, начните с хаба Gonka API.
Списание идет из предоплаченного USD-баланса по прозрачной формуле: стоимость сети плюс комиссия платформы. Актуальные правила списаний и примеры расчета есть на странице цен.
Используйте каталог моделей для актуального человекочитаемого списка и гайд по выбору моделей для того, как выбирать model ID и сценарии использования.
Аккаунт и биллинг
Зарегистрируйтесь в GonkaGate, подтвердите почту и создайте ключ в панели. Полный ключ показывается только один раз, поэтому сразу скопируйте и сохраните его. Для полного цикла работы с ключом и примеров аутентификации используйте гайд по аутентификации.
На старте новые аккаунты получают
$10 бесплатных кредитов. Платные пополнения пока не запущены. Перед тем как планировать депозиты, смотрите актуальный статус финансирования на странице цен.Итоговая стоимость равна стоимости сети плюс комиссии платформы. Если позже включат платные пополнения, все комиссии и минимумы будут опубликованы на странице цен вместе с актуальными правилами списаний.
Стоимость сети - это базовая стоимость, которую Gonka Network задает по текущей ставке. Она может меняться со временем. Страница цен показывает, как она отображается рядом с комиссией платформы.
Комиссия платформы - это отдельная комиссия поверх стоимости сети. На странице цен показана актуальная ставка и ее место в биллинговой разбивке.
Платные пополнения пока не запущены. Когда они появятся, на странице цен будет указана актуальная комиссия пополнения и ее влияние на зачисленный баланс.
Платные пополнения пока не запущены. Когда они появятся, на странице цен будет указан актуальный минимальный депозит или минимальный баланс.
Баланс отображается в панели. Выполненное использование и расходы доступны в активности панели после завершения запросов. Для правил списаний и примеров используйте страницу цен.
Использование API
Да, для поддерживаемых эндпоинтов. Официальные OpenAI SDK работают с GonkaGate для
/v1/chat/completions и /v1/models. Для настройки используйте Быстрый старт, а для деталей по эндпоинтам - справочник API.Лимиты применяются по API-ключу, пользователю и IP. При ответах
429 проверяйте Retry-After и x-ratelimit-* для текущего лимита, оставшегося запаса и окна сброса. Для retry-логики используйте гайд по обработке лимитов, а для семантики ошибок - гайд по обработке ошибок.Да. Добавьте
stream: true в запрос. Ответы отправляются как Server-Sent Events с генерацией токенов в реальном времени. Подробности по поддерживаемому поведению и payload есть в справочнике API.Используйте активность панели для выполненного использования и расходов. Ответы API не включают суммы списаний по отдельным запросам. За биллинговым контекстом, правилами списаний и примерами переходите на страницу цен.
Устранение неполадок
Проверьте, что ключ начинается с
gp- и корректно скопирован. Ключи чувствительны к регистру. Если ключ потерян, создайте новый в панели. Полный чеклист есть в гайде по аутентификации.Сначала нужно подтвердить почту. Проверьте входящие и папку со спамом. Полный сценарий создания ключа описан в гайде по аутентификации.
Во внешнем OpenAI-совместимом API
/v1/* ошибка низкого баланса приходит как HTTP 429 с error.code: insufficient_quota. Это означает, что предоплаченного USD-баланса недостаточно для запроса. Сначала проверьте баланс в панели. На старте новые аккаунты получают бесплатные кредиты, а платные пополнения пока не запущены. За актуальным статусом финансирования переходите на страницу цен, а за различием между insufficient_quota и 429-ответами, которые можно повторять, - в гайд по обработке лимитов.Проверьте
Retry-After и отделите лимит, который можно повторять, от insufficient_quota до ретрая. Для rate_limit_exceeded используйте ограниченный exponential backoff. Точный сценарий есть в гайде по обработке лимитов и гайде по обработке ошибок.Безопасность
Весь API-трафик шифруется через HTTPS. В аутентифицированных сценариях продукта chat history может храниться на сервере, поэтому prompt и response могут сохраняться в зависимости от используемой поверхности. Держите API-ключи на backend и регулярно ротируйте их. Детали политики - на странице безопасности.
Создайте новый ключ, сразу скопируйте и сохраните его, потому что полный ключ показывается только один раз, затем отключите или удалите старый и обновите ключ во всех приложениях. За деталями жизненного цикла ключа идите в гайд по аутентификации, за рекомендациями по защите аккаунта - на страницу безопасности.