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

API WitCast доступен по адресу https://cast.witqq.dev/api/v1/. Каждый запрос подписывается ключом: Authorization: Bearer <ключ>.

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

Откройте мини-приложение в Telegram или браузере → Профиль → API-ключи → Новый ключ. Выберите разрешения (например, «Подкасты: цена», «Подкасты: создание», «Подкасты: статус»), при желании срок действия и квоту в кредитах. Секрет ключа показывается один раз — сохраните его. Подробнее — в разделе Ключи и разрешения.

Получите котировку и создайте подкаст

Любая платная операция идёт в два шага: сначала котировка (POST …/quotes) — она фиксирует тарифы и необязательный лимит расходов и возвращает quoteId, — затем создание с тем же телом, quoteId и заголовком Idempotency-Key.

podcasts:quote, podcasts:create

1 · quote

curl -s -X POST https://cast.witqq.dev/api/v1/podcasts/quotes \
  -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "topic",
  "title": "Quantum sensors",
  "topic": "How quantum sensors work and where they are used today",
  "lengthPreset": "express",
  "grounding": "quick",
  "voiceId": "yandex-speechkit:jane",
  "language": "en"
}'

2 · create

curl -s -X POST https://cast.witqq.dev/api/v1/podcasts \
  -H "Authorization: Bearer $KEY" \
  -H 'Idempotency-Key: my-request-001' \
  -H 'Content-Type: application/json' \
  -d '{
  "quoteId": "QUOTE_ID",
  "mode": "topic",
  "title": "Quantum sensors",
  "topic": "How quantum sensors work and where they are used today",
  "lengthPreset": "express",
  "grounding": "quick",
  "voiceId": "yandex-speechkit:jane",
  "language": "en"
}'

Ответ создания — 202 и operation с podcastId. Статус, чек, отмена и аудио описаны в разделе Статус, чек, отмена и аудио.

Что дальше

• Подкасты — все режимы и поля запроса.
• Новости — датированные выпуски.
• Цены и списание — как резервируются и списываются кредиты.