Skip to main content
POST
/
podcast
/
scripted
Create any audio content with a user provided script
curl --request POST \
  --url https://api.wondercraft.ai/v1/podcast/scripted \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "script": [
    {
      "text": "<string>",
      "voice_id": "<string>"
    }
  ],
  "music_spec": {
    "music_id": "<string>",
    "fade_in_ms": 0,
    "fade_out_ms": 0,
    "playback_start": 0,
    "playback_end": 123,
    "volume": 0.05,
    "loop": false
  }
}
'
{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

A request to start a job to generate audio content with a provided script.

​
script
ScriptSegment · object[]
required

The segments forming the script for the episode

​
music_spec
MusicTrackSpec · object

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.

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.