Skip to main content
POST
/
v1
/
audio
/
podcastgen
Podcast Generation
curl --request POST \
  --url https://apis.finevoice.ai/v1/audio/podcastgen \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Welcome to the FineVoice podcast. Today we discuss AI audio...",
  "thumbnail": "<string>",
  "speakers": [
    "olivia",
    "ethan"
  ],
  "expectedDuration": "5min",
  "prompt": "<string>",
  "style": "conversational",
  "originalText": true,
  "useAsync": true
}
'
{
  "status": 123,
  "url": "<string>",
  "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "urls": [
    "<string>"
  ],
  "service": "<string>",
  "port": "<string>",
  "timestamp": "<string>"
}

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:
["olivia", "ethan"]
​
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