Skip to main content
POST
/
api
/
v2
/
audio
/
speech
cURL
curl --request POST \
  --url https://api.deapi.ai/api/v2/audio/speech \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'text=A beautiful sunset over mountains' \
  --form model=Kokoro \
  --form lang=en-us \
  --form speed=1 \
  --form format=flac \
  --form sample_rate=24000 \
  --form mode=custom_voice \
  --form voice=af_sky \
  --form 'ref_audio=<string>' \
  --form 'ref_text=<string>' \
  --form 'instruct=<string>' \
  --form webhook_url=https://your-server.com/webhooks/deapi \
  --form ref_audio.0='@example-file' \
  --form ref_audio.1='@example-file'
{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}
Generate natural-sounding speech from text. Supports preset voices, voice cloning, and voice design depending on the selected model. Returns a request_id for status polling.
Prerequisite: Consult the Model Selection endpoint to identify a valid model slug and the per-model voice catalog.
OpenAI SDK users: This endpoint is also available via the OpenAI-compatible surface as POST /v1/audio/speech at https://oai.deapi.ai/v1. The six OpenAI voice aliases (alloy, echo, fable, onyx, nova, shimmer) are supported on Kokoro. See OpenAI Compatibility.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

multipart/form-data

Audio generation parameters. Supports three TTS modes: custom_voice (default, preset speakers), voice_clone (clone from reference audio), voice_design (create voice from description).

​
text
string
required

Text to be converted to speech

Example:

"A beautiful sunset over mountains"

​
model
string
required

The model to use for speech generation. Available models can be retrieved via the GET /api/v1/client/models endpoint.

Example:

"Kokoro"

​
lang
string
required

Language to be used during audio generation

Example:

"en-us"

​
speed
number
required

Generated audio speech speed

Example:

1

​
format
string
required

Audio output format

Example:

"flac"

​
sample_rate
number
required

Sample rate of generated audio

Example:

24000

​
mode
enum<string> | null

TTS mode: custom_voice (default), voice_clone, or voice_design. Determines which fields are required.

Available options:
custom_voice,
voice_clone,
voice_design
Example:

"custom_voice"

​
voice
string | null

Name of the voice to be used. Required for custom_voice mode.

Example:

"af_sky"

​
ref_audio
file | null

Reference audio file for voice cloning. Supported formats: mp3, wav, flac, ogg, m4a. Max 15MB. Duration must be between 3-10 seconds (model-specific limits may apply). Required for voice_clone mode.

​
ref_text
string | null

Optional transcript of the reference audio for improved voice cloning accuracy.

​
instruct
string | null

Natural language voice description for voice_design mode (e.g. "A warm female voice with a British accent"), or style/emotion control in custom_voice mode.

​
webhook_url
string<uri> | null

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See Webhook Documentation for payload structure and authentication details.

Maximum string length: 2048
Example:

"https://your-server.com/webhooks/deapi"

Response

ID of the inference request.

​
data
object

Information from success endpoint