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