Quick Start

Получите API-ключ

Зарегистрируйтесь в Premiss Cloud и создайте API-ключ в личном кабинете.

Отправьте запрос на транскрибацию

Создайте задачу с шагами transcribe и llm (саммаризация). Premiss автоматически скачает аудиофайл, транскрибирует его с разделением по спикерам и сделает краткое содержание.

curl -X POST https://premiss.ru/api/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/podcast-episode-01.mp3",
    "webhook_url": "https://yourapp.com/webhook",
    "template": "meeting",
    "steps": [
      {
        "name": "transcribe",
        "options": { "diarization": true }
      },
      {
        "name": "llm",
        "depends_on": ["transcribe"]
      }
    ]
  }'

Ответ API:

{
  "success": true,
  "data": {
    "id": "1d2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
    "status": "pending",
    "webhook_url": "https://yourapp.com/webhook",
    "created_at": "2026-02-13T10:30:00.000Z"
  }
}

Сохраните data.id для проверки статуса обработки.

Получите результат

Есть два способа получить результат: через webhook (рекомендуется) или polling статуса задачи.

Вариант А: Webhook (рекомендуется)

Если вы указали webhook_url при создании задачи, Premiss отправит результат автоматически, когда обработка завершится. Не нужно делать дополнительные запросы.

{
  "event": "task.completed",
  "task": {
    "id": "1d2f3a4b-...",
    "status": "completed",
    "output": {
      "synopsis": "Краткое содержание встречи...",
      "transcript": "Полная транскрипция с разметкой спикеров..."
    },
    "completed_at": "2026-02-13T10:32:15.000Z"
  },
  "timestamp": "2026-02-13T10:32:15.123Z"
}

Вариант Б: Polling статуса

Если вы не можете принимать webhook, опрашивайте статус задачи каждые 5 секунд.

curl https://premiss.ru/api/v1/tasks/1d2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b \
  -H "Authorization: Bearer YOUR_API_KEY"