Первый файл

После получения ключа задайте ID его Workspace и путь к локальному аудиофайлу. Секрет экспортирован как MINDVOICE_API_KEY; публичный API доступен по адресу https://api.mindvoice.pro.

export WORKSPACE_ID='ws-<UUID-вашего-workspace>'
curl --fail-with-body -X POST \
  "https://api.mindvoice.pro/api/v1/workspaces/$WORKSPACE_ID/recordings" \
  -H "Authorization: Bearer $MINDVOICE_API_KEY" \
  -F 'file=@./call.mp3;type=audio/mpeg' \
  -F 'metadata={"external_id":"crm-call-7781"}' \
  -F 'retention_days=7'

Ответ — карточка записи с id вида fl-<UUID> и первоначальным status: "queued". Сохраните id вместе с идентификатором записи в вашей системе. Загрузка не ждёт анализа аудио: проверяйте карточку GET /api/v1/workspaces/{workspace_id}/recordings/{recording_id}, пока статус не станет completed либо failed.

Дальше используйте полный цикл интеграции и руководство по сценариям. Формат карточки и остальные поля приведены в API Reference.