Документация API

Создание записей, статус, результат и экспорт. Идентификаторы записей — UUID.

curl -X POST https://cosmoscribe.ru/api/v1/transcriptions \
  -H "X-API-Key: $COSMIC_API_KEY" \
  -H "Idempotency-Key: order-1042" \
  -F "file=@meeting.mp3" \
  -F "language=ru" \
  -F "webhook_url=https://example.ru/hooks/cosmic"

{
  "message": "Транскрибация поставлена в очередь",
  "log_id": "9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70",
  "status": "queued"
}

curl -X POST https://cosmoscribe.ru/api/v1/transcriptions/url \
  -H "X-API-Key: $COSMIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://vk.com/video-1_1","language":"ru"}'

curl https://cosmoscribe.ru/api/v1/transcriptions/9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70 \
  -H "X-API-Key: $COSMIC_API_KEY"

{
  "data": {
    "id": "9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70",
    "status": "completed",
    "original_filename": "meeting.mp3",
    "language": "ru",
    "clean_text": "Добрый день. Начнём с плана на квартал…",
    "formatted_text": "[00:00] Спикер 1: Добрый день…",
    "segments": [
      {
        "start": 0.48,
        "end": 4.12,
        "text": "Добрый день. Начнём с плана на квартал.",
        "speaker": "SPEAKER_00",
        "words": [
          { "word": "Добрый", "start": 0.48, "end": 0.91 },
          { "word": "день.", "start": 0.94, "end": 1.32 }
        ]
      }
    ],
    "is_partial": false,
    "audio_duration_seconds": 1847,
    "full_duration_seconds": 1847,
    "group_id": null,
    "source_type": "upload"
  }
}

curl -L "https://cosmoscribe.ru/api/v1/transcriptions/9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70/export?format=srt" \
  -H "X-API-Key: $COSMIC_API_KEY" -o meeting.srt

Краткие содержания и перевод. Оба метода асинхронные: создают объект в статусе queued и наполняют его позже.

curl -X POST https://cosmoscribe.ru/api/v1/transcriptions/9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70/summaries \
  -H "X-API-Key: $COSMIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"meeting"}'

curl -X POST https://cosmoscribe.ru/api/v1/transcriptions/9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70/summaries \
  -H "X-API-Key: $COSMIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"custom","custom_instruction":"Выпиши все возражения клиента и как на них ответили."}'

{
  "id": "b4c9a1d2-77e3-4f10-8c55-1a2b3c4d5e6f",
  "transcription_log_id": "9f1c2f7e-5a44-4c0e-9b1e-2d3c4b5a6f70",
  "template": "meeting",
  "status": "completed",
  "summary_text": "Обсудили план на квартал…",
  "key_points": ["Запуск переносится на март"],
  "action_items": [
    { "task": "Прислать смету", "assignee": "Иван", "due_date": "2026-09-01", "completed": false }
  ],
  "topics": ["Планирование"],
  "language": "ru",
  "generated_at": "2026-08-25T12:44:19+00:00"
}

Замены применяются к тексту при выдаче: имена, бренды, аббревиатуры. Требуется тариф со словарём.

Папки для записей: передавайте group_id при создании или переносите записи методом assign.

Состояние ключа, лимиты тарифа и адрес доставки уведомлений.

curl https://cosmoscribe.ru/api/v1/account -H "X-API-Key: $COSMIC_API_KEY"

{
  "client": {
    "id": "3f2a1b0c-1111-2222-3333-444455556666",
    "name": "Продакшен",
    "status": "active",
    "rpm_limit": 60,
    "daily_limit": 5000,
    "monthly_limit": 100000,
    "requests_today": 412,
    "requests_this_month": 9310
  },
  "webhook": {
    "url": "https://example.ru/hooks/cosmic",
    "secret": "8f14e45fceea167a5a36dedd4bea2543",
    "signature_header": "X-Cosmic-Signature",
    "signature_algo": "hmac-sha256(raw_body, secret), hex"
  },
  "plan": {
    "plan": "Бизнес",
    "max_file_mb": 500,
    "max_video_file_mb": 2000,
    "max_audio_duration_min": 300,
    "monthly_audio_minutes": 1200,
    "features": { "has_summaries": true, "has_translation": true }
  },
  "usage": {
    "audio_minutes_this_month": 730,
    "audio_minutes_limit": 1200,
    "audio_minutes_remaining": 470,
    "transcriptions_this_month": 96,
    "transcriptions_remaining": 104,
    "summaries_this_month": 41,
    "summaries_remaining": 159
  },
  "period": {
    "start": "2026-08-14T00:00:00+00:00",
    "end": "2026-09-13T00:00:00+00:00"
  }
}

• Секрет вебхука виден в профиле рядом с ключом и в GET /account; там же он ротируется.
• Считайте подпись от сырого тела запроса до любого парсинга JSON — пересборка тела даёт другую подпись.
• Сравнивайте подписи функцией постоянного времени (hash_equals, hmac.compare_digest, crypto.timingSafeEqual).
• Отбрасывайте запросы со старым occurred_at (например, старше часа): подпись подтверждает, что тело наше, но не защищает от переигрывания перехваченного запроса.
• Отвечайте кодом 2xx как можно быстрее. Таймаут ответа — 10 секунд, установка соединения — 5.
• При не-2xx доставка повторяется до 5 раз с интервалами 1, 5, 15 и 60 минут.
• Редиректы не выполняются: ответ 3xx считается ошибкой доставки — указывайте конечный URL.
• На один исход обработки приходит одно уведомление: после успешного ответа повторов по нему не будет.
• Доставка гарантируется «хотя бы один раз»: если наш POST дошёл, а ваш ответ потерялся, событие придёт снова с тем же X-Cosmic-Delivery. Запоминайте обработанные идентификаторы — это дешевле, чем сверять содержимое.
• Поле occurred_at — время самого события, а не время отправки, и у повторов оно не меняется.
• Повторный запуск обработки начинает новый цикл: после POST /retry придёт ещё одно уведомление об исходе, после POST /resume — ещё одно transcription.completed, уже с is_partial = false.
• События summary.* и translation.* приходят только по тем разборам и переводам, которые запрошены через API. То, что владелец аккаунта сделал на сайте, ваш эндпоинт не трогает.
• Готовьтесь к незнакомым именам событий: отвечайте 2xx и пропускайте всё, чего не ждёте, — иначе новое событие уйдёт в повторы.
• Адрес доставки для записи — её webhook_url, иначе адрес по умолчанию у ключа, которым запись создана. События summary.* и translation.* уходят на адрес того ключа, которым запрошена сама операция: если ключ один, это один и тот же адрес.

• search_transcripts
  Поиск по расшифровкам

  Ищет релевантные фрагменты по всем расшифровкам аккаунта Cosmo Scribe (или в пределах одной группы либо одной записи). Возвращает куски текста с тайм-кодами, спикером и ссылкой на запись — по ним можно отвечать на вопросы о том, что обсуждалось на встречах и звонках. Отвечать следует только по возвращённым фрагментам.

• list_transcriptions
  Список записей

  Возвращает записи аккаунта Cosmo Scribe от новых к старым: название, дату, длительность, статус обработки и наличие саммари. Полезно, чтобы найти идентификатор нужной записи перед вызовом get_transcript.

• get_transcript
  Расшифровка записи

  Возвращает полный текст одной записи Cosmo Scribe, а при наличии — её AI-саммари с ключевыми пунктами и договорённостями. Очень длинный текст усекается; для точечного поиска по большому архиву используйте search_transcripts.

• list_commitments
  Договорённости со встреч

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