Generate AI-scripted podcast with 2 hosts using Convo Mode

curl --request POST \
  --url https://api.wondercraft.ai/v1/podcast/convo-mode/ai-scripted \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "voice_ids": [
    "<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,
    "loop": false
  }
}
'

{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Endpoint Examples

Generate AI-scripted podcast with 2 hosts using Convo Mode

Starts a background job that creates an AI generated script and produces an audio file in convo mode. The response contains a job_id that can be used with the /podcast/{job_id} endpoint to query for status. Requires a valid X-API-TOKEN header.

Note that generating via Convo Mode yields more natural results but takes longer. Expect at least 1 minute of processing per minute duration of audio before investigating a potential failure.

Throws:

429 if the user has too many jobs in flight.
400 if any voice_ids provided are invalid or if the length of voice_ids is not 2.

POST

podcast

convo-mode

ai-scripted

Generate AI-scripted podcast with 2 hosts using Convo Mode

curl --request POST \
  --url https://api.wondercraft.ai/v1/podcast/convo-mode/ai-scripted \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "voice_ids": [
    "<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,
    "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 that generates an audio file for a podcast in convo mode with a script generated by AI using the provided prompt. An optional list of Voice IDs can be provided to control the audio generation output. If no voice_ids are provided, defaults of up to 2 convo-mode voices will be chosen.

prompt

string

required

The prompt to instruct the AI to generate the script. You can specify the duration, and include links. Sometimes, the AI hallucinates, so it helps to mention that this podcast has two hosts.

voice_ids

string[]

A list of voice_ids to use for the generated audio. Must provide exactly 2 voices for this endpoint. If the script has multiple speakers, we will use the voices from this list in the order they appear in. All ids in this list must be unique. If no IDs are provided, 2 defaults will be used.

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

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.

Show child attributes

music_spec.music_id

string

required

The ID of the music track to used in the background. This can be copied from theWondercraft platform

music_spec.fade_in_ms

integer

default:0

The number of milliseconds to fade in from the start of the music track

music_spec.fade_out_ms

integer

default:0

The number of milliseconds to fade out from the end of the music track

music_spec.playback_start

integer

default:0

A millisecond into the music track at which we start playing. Equivalent to trimming thebeginning of the music track. Defaults to 0 (i.e. no trimming)

music_spec.playback_end

integer | null

How many milliseconds into the music should we playback. Equivalent to trimming up to this numberof milliseconds from the music track. Defaults to the entire music track.

music_spec.volume

number

default:0.05

The volume to apply to the music track. Defaults to 0.05. Must be between 0.0 and 1.0

music_spec.loop

boolean

default:false

Whether to loop the music track. Defaults to False.

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.

Introduction Generate podcast with 2 hosts using Convo Mode, with a user provided script

⌘I

API Documentation

Endpoint Examples

Authorizations

Body

Response