Перейти к статье
VERUM AI
Разделы
Документация APIСправочник API
O‘zbekРусскийЎзбек

Бесплатный тест подключения

Справочник API

Адреса, параметры и форматы ответов.

Сейчас API возвращает отправленный тестовый текст без изменений. Это не думающая модель. Доступ открыт только выбранным аккаунтам.
На этой странице

Адрес и авторизация

Текущий тестовый адрес: https://verum-cabinet-api-preview.sdq-sfb.workers.dev/v1. Сверьте его с кабинетом. В каждом запросе передавайте заголовок Authorization: Bearer <VERUM_API_KEY>. Не добавляйте ключ в URL.

Список моделей

HTTP
GET /v1/models
Authorization: Bearer <VERUM_API_KEY>

Тело запроса и параметры URL не нужны. Ответ содержит только разрешённую тестовую модель.

JSON
{
  "object": "list",
  "data": [
    {
      "id": "verum-cabinet-preview-echo",
      "object": "model",
      "owned_by": "verum"
    }
  ]
}

Текстовый запрос

HTTP
POST /v1/chat/completions
Authorization: Bearer <VERUM_API_KEY>
Content-Type: application/json
JSON
{
  "model": "verum-cabinet-preview-echo",
  "messages": [
    {
      "role": "user",
      "content": "Hello, Verum!"
    }
  ],
  "stream": false,
  "max_tokens": 2000
}
ПолеТребование
modelОбязательно: verum-cabinet-preview-echo
messagesОбязательно: ровно одно сообщение user
contentНепустой текст, не более 8192 байт UTF-8
streamНеобязательно; только false, по умолчанию false
max_tokensНеобязательно; только целое 2000, по умолчанию 2000

Дополнительные поля, например temperature или tools, не принимаются. Сообщение содержит только role и content. Всё тело запроса — не более 32768 байт. Байты не равны символам: кириллическая буква может занимать несколько байт.

Успешный ответ

JSON
{
  "id": "00000000-0000-4000-8000-000000000001",
  "object": "chat.completion",
  "created": 1790553600,
  "model": "verum-cabinet-preview-echo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello, Verum!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1000,
    "completion_tokens": 2000,
    "total_tokens": 3000
  }
}

Успешный статус — 200. Значения id и created меняются; choices[0].message.content равен отправленному тексту. usage — синтетический учёт. При ошибке возвращается error.code.

JSON
{
  "error": {
    "code": "invalid_key"
  }
}

Неподдерживаемые запросы

Через этот API недоступны /v1/responses, /v1/messages, загрузка файлов и служебные адреса управления. Другой путь/метод или параметр URL возвращает 404. Потоковые ответы, инструменты и история диалога пока недоступны.

НазадЛимиты и использованиеДалееОшибки и помощь