Перейти к статье

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

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

От создания ключа до первого тестового ответа.

API возвращает тестовый текст без изменений — это не думающая модель. Все активные аккаунты с подтверждённой почтой могут создать бесплатный тестовый ключ в кабинете на рабочем сайте.
На этой странице

Перед началом

Зарегистрируйтесь на рабочем сайте и подтвердите почту: все активные аккаунты могут создать тестовый ключ, ручное разрешение не требуется. Если тест недоступен, обратитесь в поддержку.

Выберите пример PowerShell для Windows или Bash для Linux/macOS. Для примеров Bash нужен curl. Выполняйте шаги в одном окне терминала.

1. Создайте ключ

  1. Войдите в кабинет и выберите «API-ключи» в боковом меню.
  2. Нажмите «Создать тестовый ключ». Если активный ключ уже существует, второй не создаётся.
  3. Сохраните полный ключ в безопасном месте: он показывается один раз. Не вставляйте его в документацию или чат поддержки.
  4. Проверьте «Адрес API» и разрешённую модель в кабинете. Адрес в примере ниже должен совпадать с адресом вашего кабинета.

2. Подготовьте терминал

Введите ключ по запросу команды: символы не отображаются. Он сохранится только в переменной окружения текущего сеанса терминала. Сохраните /v1 в конце адреса.

read -r -s -p 'Verum API key: ' VERUM_API_KEY
printf '\n'
export VERUM_API_KEY
export VERUM_BASE_URL='https://verum-cabinet-api-preview.sdq-sfb.workers.dev/v1'

3. Получите список моделей

curl --silent --show-error --max-time 35 \
  "$VERUM_BASE_URL/models" \
  -H "Authorization: Bearer $VERUM_API_KEY"
JSON
{
  "object": "list",
  "data": [
    {
      "id": "verum-cabinet-preview-echo",
      "object": "model",
      "owned_by": "verum"
    }
  ]
}

Ответ должен содержать указанную тестовую модель. При ошибке прочитайте раздел «Ошибки и помощь», прежде чем отправлять следующий запрос.

4. Отправьте первое сообщение

curl --silent --show-error --max-time 35 \
  "$VERUM_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $VERUM_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"model":"verum-cabinet-preview-echo","messages":[{"role":"user","content":"Hello, Verum!"}],"stream":false,"max_tokens":2000}'

В choices[0].message.content должно вернуться Hello, Verum! — точно отправленный текст. Ниже пример полного ответа; id и created будут отличаться при каждом запросе.

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
  }
}

5. Завершите тест

Обновите данные в кабинете и посмотрите счётчик успешных запросов. Затем очистите копию ключа из терминала. Эта команда не отзывает ключ — отзыв выполняется в кабинете.

unset VERUM_API_KEY VERUM_BASE_URL