Гайды по OpenAI SDK

Выберите гайд по рантайму для официального OpenAI SDK после того, как у вас уже есть один рабочий запрос к GonkaGate. Если вы используете LangChain, Vercel AI SDK, Aider, Cline, Roo Code или другую обертку либо community tool, переходите в Гайды по фреймворкам и инструментам. Если вы используете Claude Code, Cursor, Kilo Code, OpenCode или OpenClaw, переходите в отдельные страницы Claude Code, Cursor, Kilo Code, OpenCode или OpenClaw.

Общая схема OpenAI SDK

client = OpenAI-compatible SDK client
base_url / baseURL = "https://api.gonkagate.com/v1"
api_key = "gp-your-api-key"

response = client.chat.completions.create(
  model = "current GonkaGate model ID",
  messages = [...]
)

Ожидаемый результат: форма запроса chat.completions.create(...) остается той же в Python, TypeScript, Go, .NET и Java. Меняются только инициализация клиента и детали конкретного рантайма.

Что нужно перед выбором гайда

• Один успешный запрос к GonkaGate или проверенный smoke test миграции
• Сохраненный ключ gp-..., который приложение читает из хранилища секретов или переменной окружения
• Актуальный GonkaGate model ID для вашей нагрузки
• Серверное место хранения ключа, чтобы он не попадал в браузер или публичный бандл

Выберите гайд по рантайму

• Python SDK: бэкенд-сервисы, фоновые задачи и скрипты с синхронными или асинхронными клиентами.
• TypeScript SDK: Node.js, Deno, Bun и edge-совместимые рантаймы.
• Go SDK: context.Context, явные таймауты и переиспользование клиента на уровне сервиса.
• .NET SDK: Betalgo.OpenAI с настройкой клиента через DI.
• Java SDK: openai-java с явной конфигурацией клиента.

Частые ошибки и замечания по совместимости

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

См. также

• Совместимость OpenAI SDK с GonkaGate для общих правил по base URL, API-ключу, model ID и дополнительным полям usage во всех рантаймах.
• Аутентификация и API-ключи чтобы создать, хранить и ротировать ключи gp-....
• Быстрый старт GonkaGate, если вам сначала нужен один подтвержденный запрос до SDK-интеграции.
• Гайд по миграции с OpenAI на GonkaGate, если вы переносите уже рабочее OpenAI-приложение.
• Гайды по фреймворкам и инструментам, если интеграция идет через LangChain, Vercel AI SDK, Aider, Cline, Roo Code или другую обертку либо community tool.
• Claude Code, Cursor, Kilo Code, OpenCode и OpenClaw, если вы используете agent-owned tool path.