REST API SUIN.AI

Аутентификация

Все запросы аутентифицируются Bearer-токеном. Создать API-ключ можно в личном кабинете: Настройки → API → Создать ключ.

curl https://api.suin.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-suin-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

Основные endpoints

5 главных операций. Полная справка с параметрами — в OpenAPI-спеке.

• POST/v1/chat/completions

  Чат с моделью

  Совместимо с OpenAI Chat Completions API — можно использовать существующие SDK (openai, anthropic-sdk через base URL).

• GET/v1/assistants

  Список AI-агентов

  Все AI-агенты в текущем workspace — id, имя, инструкции, подключённые базы знаний.

• POST/v1/knowledge-bases/{id}/documents

  Загрузить документ в базу знаний

  Multipart upload PDF/DOCX/TXT/MD. Возвращает job id для отслеживания статуса индексации.

• POST/v1/webhooks

  Создать webhook

  Регистрирует обработчик для tool-use в AI-агенте. Поддерживает MCP-протокол.

• GET/v1/usage

  Расход нейронов

  Отчёт по расходу за период с разбивкой по моделям, агентам и пользователям.