Gemini API Gateway

OpenAI-совместимый API поверх Google Gemini. Работает с любым клиентом, который умеет ходить в OpenAI: достаточно подменить base_url.

Подключение

base_url: https://api.architect-yug.ru/v1
api_key:  ваш ключ, выданный владельцем сервиса

Продолжение диалога

Сервис может держать диалог на своей стороне. Чтобы запросы попадали в одну беседу, передавайте заголовок X-Session-Id: любая-строка (либо поле user в теле). Без него сессия определяется по первому сообщению диалога. В ответе возвращаются X-Session-Id и X-Conversation-Id.

Доступные модели

Имя для запроса	Модель
`claude-opus-4-6-thinking`	Claude Opus 4.6 (Thinking)
`claude-sonnet-4-6`	Claude Sonnet 4.6 (Thinking)
`gemini-3.1-pro-high`	Gemini 3.1 Pro (High)
`gemini-3.1-pro-low`	Gemini 3.1 Pro (Low)
`gemini-3.6-flash-high`	Gemini 3.6 Flash (High)
`gemini-3.6-flash-low`	Gemini 3.6 Flash (Low)
`gemini-3.6-flash-medium`	Gemini 3.6 Flash (Medium)
`gemini-3.7-flash-high`	Gemini 3.7 Flash (High)
`gemini-3.7-flash-low`	Gemini 3.7 Flash (Low)
`gemini-3.7-flash-medium` по умолчанию	Gemini 3.7 Flash (Medium)
`gemini-3.8-flash-high`	Gemini 3.8 Flash (High)
`gemini-3.8-flash-low`	Gemini 3.8 Flash (Low)
`gemini-3.8-flash-medium`	Gemini 3.8 Flash (Medium)
`gpt-oss-120b-medium`	GPT-OSS 120B (Medium)

Короткие имена

Удобные псевдонимы и совместимость с клиентами, где имя модели зашито намертво.

Алиас	Ведёт на
`agy`	`gemini-3.7-flash-medium`
`agy-pro`	`gemini-3.1-pro-high`
`agy-fast`	`gemini-3.7-flash-low`
`agy-claude`	`claude-sonnet-4-6`
`gpt-4o`	`gemini-3.7-flash-medium`
`gpt-4o-mini`	`gemini-3.7-flash-low`
`gpt-4.1`	`gemini-3.1-pro-high`

Список отдаётся и по API: GET /v1/models. Обновлён: 12.10.2026 11:17.

Эндпоинты

Метод	Путь	Назначение
POST	/v1/chat/completions	чат, стриминг, картинки на вход, function calling
POST	/v1/completions	устаревший текстовый формат
POST	/v1/embeddings	векторные представления
POST	/v1/images/generations	генерация изображений
GET	/v1/models	список моделей
GET	/health	проверка живости (без ключа)

Пример: текст

curl https://api.architect-yug.ru/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"agy","messages":[{"role":"user","content":"Привет!"}]}'

Пример: картинка на вход

{
  "model": "agy",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Что на фото?"},
      {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,..."}}
    ]
  }]
}

Поддерживаются и data:-URI, и обычные http(s)-ссылки на изображение.

Python (openai SDK)

from openai import OpenAI

client = OpenAI(api_key="ВАШ_КЛЮЧ", base_url="https://api.architect-yug.ru/v1")
r = client.chat.completions.create(
    model="agy",
    messages=[{"role": "user", "content": "Привет"}],
)
print(r.choices[0].message.content)