API Reference
AiBuy API совместим с форматом OpenAI Chat Completions. Если вы уже пользуетесь OpenAI API — просто смените base_url.
Базовый URL
https://api.quantadev.pro/v1
Эндпоинты
GET
/v1/models
Возвращает список доступных моделей. Не требует аутентификации.
curl https://api.quantadev.pro/v1/models
POST
/v1/chat/completions
Основной эндпоинт для генерации текста. Принимает OpenAI-совместимый JSON.
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
model |
string | Да | Имя модели (например, claude-sonnet-4-7) |
messages |
array | Да | Массив сообщений с ролями user, assistant, system |
max_tokens |
integer | Нет | Максимум токенов в ответе (по умолчанию 4096) |
temperature |
number | Нет | Температура генерации (0.0–2.0, по умолчанию 1.0) |
stream |
boolean | Нет | Включить потоковый режим SSE (true/false) |
stop |
string/array | Нет | Последовательности, при которых генерация останавливается |
Пример запроса (не-streaming)
curl https://api.quantadev.pro/v1/chat/completions \
-H "Authorization: Bearer sk-aisell-..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-7",
"messages": [
{"role": "system", "content": "Ты полезный ассистент."},
{"role": "user", "content": "Расскажи вкратце про ИИ."}
],
"max_tokens": 500,
"temperature": 0.7
}'
Пример ответа
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1712345678,
"model": "claude-sonnet-4-7",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "Искусственный интеллект..."
},
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 120,
"total_tokens": 145
}
}
Streaming
Для потокового режима добавьте "stream": true. Ответ будет приходить чанками в формате SSE. Подробнее — в разделе Streaming.
Ошибки
Описание HTTP-кодов и формата ошибок — в разделе Ошибки и коды.