API для агентов

Эндпоинт совместим со схемой OpenAI, поэтому подходит любому клиенту, который умеет менять base_url. Запросы тратят лимиты вашей подписки — те же, что и веб-чат.

1. Получите токен

Откройте страницу подключения: ключ привяжется к аккаунту, а вы получите строку вида egn_a_…. Она показывается один раз.

2. Два заголовка

Authorization: Bearer egn_a_… — ваш токен;
X-EGN-Client — секрет клиента, зашитый в агента.

3. Примеры

curl -N https://api.ai.egn-cloud.ru/api/v1/chat/completions \
  -H "Authorization: Bearer egn_a_ВАШ_ТОКЕН" \
  -H "X-EGN-Client: КЛИЕНТСКИЙ_СЕКРЕТ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.5",
    "messages": [{"role": "user", "content": "Привет!"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ai.egn-cloud.ru/api/v1",
    api_key="egn_a_ВАШ_ТОКЕН",
    default_headers={"X-EGN-Client": "КЛИЕНТСКИЙ_СЕКРЕТ"},
)

stream = client.chat.completions.create(
    model="claude-sonnet-4.5",
    messages=[{"role": "user", "content": "Напиши хокку про код"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Список моделей

GET /api/v1/models вернёт только те модели, которые открыты вашим тарифом.

Что происходит при исчерпании лимита

Эндпоинт отвечает 429 и сообщает, какое окно закрылось (5 часов, неделя или кредиты) и когда оно обновится.