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.