Skip to main content
POST
Podcast Generation

Authorizations

Authorization
string
header
required

Bearer token (API key). Format: Bearer {your_api_key}

Body

application/json

The podcast generation request payload.

text
string

The podcast script content.

Example:

"Welcome to the FineVoice podcast. Today we discuss AI audio..."

thumbnail
string

The thumbnail image URL.

speakers
string[]

Voice models used by podcast speakers.

Example:
expectedDuration
string

The expected generated duration.

Example:

"5min"

prompt
string

The generation prompt.

style
string

The desired podcast style.

Example:

"conversational"

originalText
boolean

Whether to keep the original text wording.

useAsync
boolean

Set to true to process asynchronously.

Example:

true

Response

Task accepted. Returns a taskId for async polling or the result URL directly.

Standard response for audio processing tasks.

status
integer<int32>

HTTP-style status code (200 for success, 202 for in-progress).

url
string

Download URL of the generated audio file (available when completed).

taskId
string

Task identifier for async polling. Use with GET /v1/task/{task_id}.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

error
object
urls
string[]

Multiple output URLs (e.g. for separation stems).

service
string
port
string
timestamp
string