docs

Документация

Всё необходимое для подключения AggreGate AI к вашему любимому CLI, IDE или приложению.

1. Получите API-ключ

Создайте ключ в панели управления. Ключи начинаются с sk-ag-… и работают с любым OpenAI-совместимым клиентом.

2. Выберите интеграцию

Мы предоставляем готовые к копированию конфигурации для самых популярных инструментов для AI-разработки и чат-приложений.

Смотреть интеграции

3. Начните разработку

Вставьте конфигурацию, перезапустите инструмент — и вы работаете со всеми моделями каталога через единую точку доступа.

Посмотреть поддерживаемые модели

Base URLopenai-compatible

Используйте это значение как base_url / apiBase / OPENAI_API_BASE в любом клиенте, совместимом с OpenAI.

Через VPN или из-за границы? Переключитесь на Gateway.

https://api.aggregate.surf/v1

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

$ export AGGREGATE_BASE_URL="https://api.aggregate.surf/v1"
$ curl "$AGGREGATE_BASE_URL/chat/completions" \
-H "Authorization: Bearer $AGGREGATE_API_KEY" \
-d '{"model":"claude-sonnet-5"}'

Эндпоинтыv1

метод	путь	описание
POST	/v1/chat/completions	Завершение чата, OpenAI-compatible
GET	/v1/models	Список доступных моделей
GET	/v1/usage	Расход токенов по ключу

ОшибкиHTTP

код	описание
400	Некорректное тело запроса или параметры
401	Неверный или отсутствующий ключ API
429	Превышен лимит запросов — повторите позже

Разделыreference

Модели	Каталог моделей и точные ID для параметра model
Стриминг	SSE-потоки токенов в реальном времени
Ошибки	HTTP-коды и реакция на них
Лимиты запросов	RPM-лимиты ключа и 429
Баланс и остаток	GET /v1/me — баланс и токены в пакетах из терминала
Интеграции	Готовые конфиги для CLI / IDE / чат-клиентов