API Reference Overview
This section documents the field-by-field contract of the public endpoints: request fields, response structure, and real examples. All endpoints are authenticated via the Authorization: Bearer <API_KEY> request header, and the model name is specified with model.
Models
Files
Upload File
POST /v1/files — Upload a file, returning a file_id for reuse in large-file scenarios.
List Files
GET /v1/files — List uploaded files.
Get File
GET /v1/files/{file_id} — Retrieve a single file's metadata by file_id.
Delete File
DELETE /v1/files/{file_id} — Delete a file by file_id.
Text to speech
Single-speaker Speech
POST /v1/audio/speech — Text-to-speech; voice accepts a voice id only.
Multi-speaker Speech
POST /v1/audio/speech/speakers — Multi-speaker TTS, using speakers to bind each speaker to a voice.
Speech recognition
Voice management
List Voices
GET /v1/audio/voices — List the currently available voices.
Create Voice
POST /v1/audio/voices — Upload an audio sample to create a reusable voice, returning a voice_id.
Generate Voice
POST /v1/audio/voice/generations — Generate a voice / speech preview from text and an instruction.