Что такое
API
для LLM
HTTP-запрос вместо чата в браузере. OpenAI-compatible формат, ключ, base URL — минимум для первого запроса.
API — программный интерфейс
ChatGPT в браузере — для человека. API — для вашего кода, бота, IDE или n8n-workflow. Вы отправляете HTTP-запрос, получаете JSON с ответом модели.
Стандарт де-факто — OpenAI Chat Completions: один endpoint, поля model, messages, опционально max_tokens, temperature.
Три части подключения
- 01Base URLАдрес сервера. IRI Gateway:
https://api-ru.agi-iri.ru/v1/ - 02API KeyСекрет в заголовке
Authorization: Bearer iri-.... Выдаётся в кабинете. - 03Model IDСтрока из каталога, например
claude-sonnet-4.6илиdeepseek-v4-pro.
Пример запроса
curl https://api-ru.agi-iri.ru/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "Объясни API одним абзацем"}],
"max_tokens": 256
}'
Ответ — JSON с полем choices[0].message.content и usage (сколько токенов списали). Подробнее — документация Gateway.
Зачем шлюз, а не напрямую OpenAI
Один ключ на все модели · оплата в рублях · failover · единые логи · не нужен VPN. IRI Gateway — прослойка между вашим кодом и upstream-провайдерами. Разбор архитектуры — в статье IRI Gateway: архитектура.
IDE-провайдер: если не хотите писать curl — используйте Verstak: ключ из кабинета, модели из коробки.
Коротко
API = HTTP + ключ + model ID. IRI Gateway совместим с OpenAI SDK. Следующий шаг — как устроен шлюз или каталог инструментов.