POST
Import Audio
Register an external audio file as a generation row. Designed for the story timeline so users can drop in music or other non-TTS audio. The row points at a singleton тАЬImported AudioтАЭ profile so the existing generation/story plumbing keeps working unchanged. POST /api/voice/generate/import All requests authenticate with your PeachDesk API key in the X-API-Key header (an interactive session token in Authorization: Bearer also works тАФ see Authentication). Use the playground to send a live request and inspect the response.

Authorizations

X-API-Key
string
header
required

Organization API key (bibha_...). Takes precedence over the session credential, and is refused outright on user-session-only and super-admin routes.

Body

multipart/form-data
file
file
required

Response

Successful Response

Response model for voice generation.

id
string
required
profile_id
string
required
text
string
required
language
string
required
created_at
string<date-time>
required
audio_path
string | null
duration
number | null
seed
integer | null
instruct
string | null
engine
string | null
default:vaani
model_size
string | null
status
string
default:completed
error
string | null
is_favorited
boolean
default:false
source
string
default:manual
versions
GenerationVersionResponse ┬╖ object[] | null
active_version_id
string | null
usage
UsageInfo ┬╖ object | null

Per-request resource usage the engine reports back to the API proxy.

The proxy meters/bills off these fields; each one maps to a rate-registry unit (TTS per character, STT per audio-second, LLM per token). Only the dimensions relevant to the request are populated тАФ the rest stay None.