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-кодов и формата ошибок — в разделе Ошибки и коды.

✉ Поддержка