API429 / Разработчикам

OpenAI-совместимый API для Gemini, GPT, Claude и Grok

Используйте библиотеку OpenAI для подключения моделей разных провайдеров через один адрес API429. Начните с проверки доступных моделей, затем укажите точный ID и поддерживаемые параметры запроса.

Что указать в настройках приложения

  • Base URL: https://gateway.api429.com/v1.
  • API key: ваш ключ API429 из личного кабинета.
  • Model: точный идентификатор из GET /v1/models, доступный этому ключу.

Общий каталог моделей и цен включает Gemini, GPT, Claude и Grok, а также модели изображений, видео и аудио. Для каждого типа задачи выбирайте соответствующий метод API: наличие модели в каталоге не означает, что она работает через любой endpoint.

Python: первый запрос через OpenAI SDK

Установите библиотеку командой pip install openai. На сервере приложения задайте переменные API429_API_KEY и API429_MODEL. Например, используйте gemini-2.5-flash, если этот ID доступен вашему ключу.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API429_API_KEY"],
    base_url="https://gateway.api429.com/v1",
    timeout=60.0,
    max_retries=0,
)
model = os.environ["API429_MODEL"]
available = {item.id for item in client.models.list()}
if model not in available:
    raise ValueError("Модель недоступна этому ключу")

response = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Объясни назначение HTTP 429 в одном предложении."}],
)
print(response.choices[0].message.content)
print(response.usage)

Генерация оплачивается по тарифу выбранной модели. В примере автоматические повторы выключены, чтобы после ошибки сначала проверить её причину. Для рабочего приложения настройте ограниченные повторы с учётом типа операции.

Chat Completions или Responses?

POST /v1/chat/completions принимает диалог в messages. POST /v1/responses предоставляет интерфейс Responses для поддерживаемых моделей и сценариев. Контракт обоих методов опубликован в OpenAPI API429.

Совместимость формата не означает одинаковую поддержку всех инструментов у всех моделей. Перед переносом агента проверьте function calling, структуру результата, мультимодальные входы, streaming и параметры reasoning, которые использует ваше приложение. Для нативных contents и parts Google используйте Gemini / Vertex-интерфейс.

Как подключить n8n

В OpenAI-совместимых credentials задайте ключ API429 и указанный base URL. В узле выберите модель по точному ID; если интерфейс не подгружает список, используйте ручной ввод или HTTP Request. Пошаговая настройка и диагностика разобраны в инструкции Gemini для n8n.

Что проверить при ошибке

  • 401/403: ключ, права и правильный адрес шлюза. Ключ Google или OpenAI не заменяет ключ API429.
  • 400: ID модели, формат запроса и поддерживаемые параметры.
  • 429: лимиты и нагрузку; см. разбор ограничений и повторов.
  • Таймаут: состояние операции и списание до повторной платной генерации.

Цены и переход с другого провайдера

Сравните полную стоимость своей нагрузки, включая вход, выход и дополнительные операции. Расчёт стоимости Gemini показывает формулу; тарифы остальных семейств есть в каталоге. Сначала перенесите один типичный сценарий и проверьте ответ, затем расширяйте интеграцию.

Справочные материалы: официальная библиотека OpenAI Python и совместимость Gemini с OpenAI SDK. Адрес, ключ и биллинг API429 отличаются от прямого подключения к Google.

Telegram