POST
/
podcast
/
convo-mode
/
user-scripted
Generate podcast with 2 hosts using Convo Mode, with a user provided script
curl --request POST \
  --url https://api.wondercraft.ai/v1/podcast/convo-mode/user-scripted \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "script": [
    {
      "text": "<string>",
      "voice_id": "<string>"
    }
  ],
  "delivery_instructions": "<string>",
  "music_spec": {
    "music_id": "<string>",
    "fade_in_ms": 0,
    "fade_out_ms": 0,
    "playback_start": 0,
    "playback_end": 123,
    "volume": 0.05
  }
}'
{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

X-API-KEY
string
header
required

Body

application/json

A request to start a job that generates an audio file for a podcast in convo mode with a script generated by the user.

script
ScriptSegment · object[]
required

The segments forming the script for the episode

delivery_instructions
string | null

An optional delivery instructions for the generated audio. This will be used to guide the generation of the audio.

music_spec
object | null

An optional spec for adding background music to the generated script. Note that if the chosenmusic track is longer than the duration of the generated script, it will be cut off. A music track to add to the generated audio. Note that the music will always be added at the very beginning of the generated podcast and will be automatically trimmed to match the content length.

Response

Successful Response

job_id
string<uuid>
required

The job ID for the episode generation. The status of this job can be queried using the/podcast/{job_id} endpoint.