Настройка PydanticAI

Используйте этот гайд, если приложение уже работает на PydanticAI и вам нужно только направить его OpenAI-совместимый provider на GonkaGate. Здесь меняются base URL, API-ключ и ID модели, а затем проверяется один запрос.

Быстрая настройка

Если вам ещё не установлен пакет с поддержкой OpenAI provider для PydanticAI:

pip install 'pydantic-ai-slim[openai]'

Затем направьте OpenAIProvider(...) на GonkaGate и оставьте остальную часть приложения на том же wrapper-слое.

import os

from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider

api_key = os.getenv("GONKAGATE_API_KEY")

if not api_key:
    raise RuntimeError("Set GONKAGATE_API_KEY before running this example")

provider = OpenAIProvider(
    base_url="https://api.gonkagate.com/v1",
    api_key=api_key,
)

model = OpenAIChatModel(
    "<model-id-from-get-v1-models>",
    provider=provider,
)

agent = Agent(model)
result = agent.run_sync("Return exactly: PydanticAI connected")

print(result.output)

Замените <model-id-from-get-v1-models> на актуальное значение из GET /v1/models.

Когда подходит именно эта страница

• Ваше Python-приложение уже использует PydanticAI.
• Приложение работает через OpenAIProvider(...) и OpenAIChatModel(...).
• Вам нужны только параметры подключения GonkaGate, а не полная миграция или переход на SDK без PydanticAI.

Что останется без изменений

Сохраняйте текущее определение Agent(...) и прикладную логику вокруг этого пути через provider. После того как базовое подключение заработает, отдельно проверьте инструменты, output models, graphs и multi-agent сценарии, а не расширяйте эту страницу до владельца этих тем.

Частые проблемы

• Не задан GONKAGATE_API_KEY: экспортируйте переменную в том же рантайме, где запускается агент.
• 401 invalid_api_key: проверьте загрузку ключа и его состояние на странице Аутентификация и API-ключи.
• 404 model_not_found: переключитесь на актуальный ID модели из GET /v1/models.
• 429 insufficient_quota: для этого запроса не хватает средств на prepaid USD balance.
• 429 rate_limit_exceeded: обрабатывайте это как троттлинг, учитывайте Retry-After и добавьте ограниченный backoff.

Следующий шаг

Если задача больше, чем замена provider, переходите к гайду по миграции с OpenAI на GonkaGate.

Официальная документация

• PydanticAI OpenAI models docs
• PydanticAI OpenAI models API reference