Skip to main content
POST
/
v1
/
ai
/
voiceover
/
elevenlabs-turbo-v2-5
curl --request POST \
  --url https://api.freepik.com/v1/ai/voiceover/elevenlabs-turbo-v2-5 \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "text": "Welcome to Freepik. Create amazing designs with AI-powered tools.",
  "voice_id": "21m00Tcm4TlvDq8ikWAM"
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
text
string
required

The text to convert to speech. Supports UTF-8 characters including accented letters and non-Latin scripts.

Required string length: 1 - 40000
Example:

"Welcome to Freepik. Create amazing designs with AI-powered tools."

​
voice_id
string
required

The unique identifier of the ElevenLabs voice to use for synthesis. You can find voice IDs in the ElevenLabs voice library.

Example:

"21m00Tcm4TlvDq8ikWAM"

​
stability
number
default:0.5

Controls voice consistency and expressiveness. Lower values (0.0) produce more expressive and varied speech, while higher values (1.0) produce more consistent and stable output.

Required range: 0 <= x <= 1
Example:

0.5

​
similarity_boost
number
default:0.2

Controls how closely the generated voice matches the original voice sample. Higher values produce closer matching but may introduce artifacts.

Required range: 0 <= x <= 1
Example:

0.2

​
speed
number
default:1

Speech rate multiplier. 0.7 is 30% slower than normal, 1.0 is normal speed, 1.2 is 20% faster.

Required range: 0.7 <= x <= 1.2
Example:

1

​
use_speaker_boost
boolean
default:true

Enable speaker boost for enhanced voice clarity and presence in the generated audio.

Example:

true

​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

Response

OK - Task created successfully

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}