Skip to content
WitCast API

Examples

In every example $KEY is the secret of a key with the needed scopes, and QUOTE_ID in the create request is quote.quoteId from the quote response. The create body must match the quote body.

A podcast on a topic

Section titled “A podcast on a topic”

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

A podcast from prepared text

Section titled “A podcast from prepared text”

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": "prepared_text",
  "title": "Утренний выпуск",
  "text": "Доброе утро. Сегодня три коротких истории о науке и технологиях. Первая — о новых квантовых сенсорах, которые измеряют магнитное поле мозга без громоздких установок. Вторая — о спутниках, которые следят за таянием ледников. Третья — о том, как города учатся экономить воду.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'
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": "prepared_text",
  "title": "Утренний выпуск",
  "text": "Доброе утро. Сегодня три коротких истории о науке и технологиях. Первая — о новых квантовых сенсорах, которые измеряют магнитное поле мозга без громоздких установок. Вторая — о спутниках, которые следят за таянием ледников. Третья — о том, как города учатся экономить воду.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'

A podcast from rough notes

Section titled “A podcast from rough notes”

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": "raw_text",
  "title": "Итоги недели команды",
  "text": "Заметки: релиз мобильного приложения перенесли на вторник; в поддержку пришло на 20% меньше обращений; новая страница цен подняла конверсию; в пятницу общая встреча в 16:00.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru",
  "durationMinutes": 5
}'
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": "raw_text",
  "title": "Итоги недели команды",
  "text": "Заметки: релиз мобильного приложения перенесли на вторник; в поддержку пришло на 20% меньше обращений; новая страница цен подняла конверсию; в пятницу общая встреча в 16:00.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru",
  "durationMinutes": 5
}'

A News episode

Section titled “A News episode”

news:quote, news:create

1 · quote
curl -s -X POST https://cast.witqq.dev/api/v1/news/quotes \
  -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "topic": "technology",
  "period": "week",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'
2 · create
curl -s -X POST https://cast.witqq.dev/api/v1/news \
  -H "Authorization: Bearer $KEY" \
  -H 'Idempotency-Key: my-request-001' \
  -H 'Content-Type: application/json' \
  -d '{
  "quoteId": "QUOTE_ID",
  "topic": "technology",
  "period": "week",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'

Narrating ready text

Section titled “Narrating ready text”

tts:quote, tts:create

1 · quote
curl -s -X POST https://cast.witqq.dev/api/v1/tts/quotes \
  -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Объявление",
  "text": "Уважаемые пассажиры, поезд до станции Лесная отправляется с третьего пути.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'
2 · create
curl -s -X POST https://cast.witqq.dev/api/v1/tts/podcasts \
  -H "Authorization: Bearer $KEY" \
  -H 'Idempotency-Key: my-request-001' \
  -H 'Content-Type: application/json' \
  -d '{
  "quoteId": "QUOTE_ID",
  "title": "Объявление",
  "text": "Уважаемые пассажиры, поезд до станции Лесная отправляется с третьего пути.",
  "voiceId": "yandex-speechkit:filipp",
  "language": "ru"
}'