AgentAPI

AgentAPI — единый шлюз к 300+ AI-моделям. Один ключ, один базовый URL, оплата в рублях. API совместим с форматом OpenAI, поэтому большинство существующих клиентов, SDK и плагинов для редакторов работают без изменений в коде — достаточно поменять base_url и ключ.

Что нужно знать сразу


Base URL	`https://api.agentapi.ru/v1/ai`
Аутентификация	`x-api-key: agentapi-…` или `Authorization: Bearer agentapi-…`
Формат ключа	`agentapi-` + 48 hex-символов
Форматы API	OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Embeddings
Модели	формат `провайдер/модель` — `openai/gpt-4.1`, `anthropic/claude-3.5-sonnet`
Оплата	предоплаченный баланс в рублях, списание по факту токенов
Swagger	api.agentapi.ru/v1/docs

Обратите внимание на сегмент /ai в базовом URL — он обязателен. https://agentapi.ru/v1 (без api. и без /ai) не существует: основной домен отдаёт сайт.

Быстрый старт

curl https://api.agentapi.ru/v1/ai/chat/completions \
  -H "x-api-key: agentapi-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Подробнее — Быстрый старт.

Контракт запроса

flowchart TD
    A["POST /v1/ai/chat/completions<br/>ключ + model + messages"] --> B{"stream?"}

    B -- "нет" --> C["200 · application/json<br/>текст в choices.message.content"]
    B -- "да" --> D["200 · text/event-stream<br/>SSE-кадры, финал DONE"]

    A -.-> E["401 · проблема с ключом"]
    A -.-> F["400 · параметры или баланс"]
    A -.-> G["429 · превышен лимит запросов"]
    A -.-> H["502 · модель недоступна"]

Что важно учесть на стороне клиента:

Ключ передаётся заголовком — x-api-key или Authorization: Bearer, оба варианта равнозначны. См. Аутентификация.
Ключ показывается один раз при создании и не может быть восстановлен. См. API-ключи.
Стриминг завершается литералом data: [DONE]. Ошибка, случившаяся после начала потока, приходит отдельным кадром при уже отданном статусе 200 — проверяйте поле error в каждом кадре.
Расход списывается с баланса в рублях по факту использованных токенов. См. Биллинг.

Совместимость

Один и тот же аккаунт и ключ работают через четыре формата запроса:

Формат	Эндпоинт	Кому подходит
OpenAI Chat Completions	`POST /v1/ai/chat/completions`	OpenAI SDK, Continue, Cline, Roo Code, LangChain
Anthropic Messages	`POST /v1/ai/messages`	Anthropic SDK и клиенты Claude
OpenAI Responses	`POST /v1/ai/responses`	клиенты на Responses API
Embeddings	`POST /v1/ai/embeddings`	векторный поиск, RAG

Настройка редакторов и плагинов: Continue · Cline · Roo Code · Claude Code · SDK и curl

Дальше

Быстрый старт — первый запрос за 5 минут.
API-ключи — как создать, где хранить, как отозвать.
Аутентификация — заголовки и ошибки 401.
Модели — какие слаги использовать.
Ошибки и лимиты — коды ответов и rate limit.
Известные ограничения — что пока не поддерживается.