Python SDK

Отправьте один chat.completions запрос из Python через официальный OpenAI SDK, а затем выберите OpenAI или AsyncOpenAI под вашу модель нагрузки.

Минимальный рабочий пример

Установите openai и задайте API-ключ:

pip install openai
export GONKAGATE_API_KEY="gp-your-api-key"

Отправьте один запрос chat.completions через стандартный клиент из OpenAI Python SDK:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.gonkagate.com/v1",
    api_key=os.environ["GONKAGATE_API_KEY"],
)

response = client.chat.completions.create(
    model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
    messages=[{"role": "user", "content": "Hello from Python"}],
)

print(response.choices[0].message.content)

Ожидаемый результат: вы получаете текст в response.choices[0].message.content.

Используйте актуальный model ID из GET /v1/models. Значение в примере выше приведено только для ориентира.

Что нужно заранее

• Python 3.9+ и возможность ставить пакеты
• API-ключ GonkaGate с префиксом gp- в серверной переменной окружения или хранилище секретов
• Достаточный доступный баланс для запроса
• Актуальный ID модели GonkaGate

Выберите клиент

Используйте OpenAI для скриптов, cron-задач и простых бэкенд-сценариев, где запросы идут по одному.

Используйте AsyncOpenAI для API, воркеров и сервисов с конкурентными запросами.

import asyncio
import os
from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.gonkagate.com/v1",
    api_key=os.environ["GONKAGATE_API_KEY"],
)

async def main():
    response = await client.chat.completions.create(
        model="qwen/qwen3-235b-a22b-instruct-2507-fp8",
        messages=[{"role": "user", "content": "Hello from async Python"}],
    )

    print(response.choices[0].message.content)

asyncio.run(main())

Замечания для Python

• Переиспользуйте один настроенный клиент на процесс или воркер, а не создавайте его заново на каждый запрос.
• Храните gp-... ключи на серверной стороне, не в браузере и не в публичных ноутбуках.
• Перед продакшен-нагрузкой явно задайте на клиенте timeout и max_retries.

Частые ошибки и ограничения

• 401 invalid_api_key обычно означает, что ключ отсутствует, поврежден или относится к недоступному состоянию аккаунта.
• 404 model_not_found означает, что указанный ID модели сейчас недоступен в GonkaGate.
• 429 insufficient_quota обычно означает, что для запроса не хватает доступного предоплаченного USD-баланса.

См. также

• Совместимость OpenAI SDK для общих правил GonkaGate, которые одинаковы во всех рантаймах.
• Аутентификация и API-ключи для создания, хранения и ротации ключей.
• Обзор справочника API, если Python-интеграции нужны точные поля запроса, поведение стриминга или правила повторов и обработки сбоев.
• Миграция с OpenAI на GonkaGate, если вы переносите уже существующее OpenAI-совместимое Python-приложение.