POST
/
voices
/
create
curl --request POST \
  --url https://api.synclabs.so/voices/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "name": "Test voice",
  "description": "This is a test voice. It'\''s used for testing purposes.",
  "inputSamples": [
    "<string>"
  ],
  "maxCredits": 123,
  "webhookUrl": "<string>"
}'
{
  "id": "<string>",
  "createdAt": "<string>",
  "status": {},
  "name": {},
  "description": {},
  "inputSamples": [
    "<string>"
  ],
  "outputSamples": [
    "<string>"
  ],
  "creditsDeducted": {},
  "webhookUrl": {},
  "errorMessage": {}
}

introduction

unlock the power of personalized audio with sync.’s /voices endpoint. this tool enables you to create custom voice clones, allowing for the ultimate customization of your projects. whether you’re aiming to match a specific vocal style or infuse your brand’s unique character into your content, our technology ensures your videos stand out.

craft voice clones with ease and integrate them with our animate and speak endpoints for a cohesive and engaging audio experience. ideal for content creators, marketers, and educators looking to elevate their audiovisual projects.

api features

custom voice creation

easily create custom voice clones tailored to your project’s needs.

seamless integration

integrate your custom voices with our animate and speak endpoints for a unified project workflow.

enhanced engagement

engage your audience with unique voiceovers that elevate your content.

quick start

authentication

before you can start using our api, you need to authenticate your requests. this is done using an x-api-key that links your requests to your account. if you don’t have an api key yet, check out the instructions here to obtain one.

create your custom voice

with your x-api-key ready, you can begin creating custom voice clones. to use the /voices via the playground above follow the instructions below:

embrace the power of custom voices to bring a new level of personalization to your projects. with sync., your content can truly speak in your brand’s voice.

Authorizations

x-api-key
string
headerrequired

Body

application/json
name
string

The name of the voice. Helpful for organization and search purposes.

description
string

The description of the voice. Helpful for keeping track of voice details.

inputSamples
string[]
required

A list of audio samples to use for voice generation

maxCredits
number

Maximum number of credits to use for audio generation. If job exceeds this value, the job will be aborted

webhookUrl
string

A url to send a notification to upon completion of audio generation

Response

201 - application/json
id
string
required

A unique identifier for the voice.

createdAt
string
required

The date and time the voice was created.

status
object
required

The status of the voice.

name
object

A name for the voice.

description
object

A description the voice.

inputSamples
string[]
required

Input samples for creating the voice.

outputSamples
string[]
required

Output samples for hearing the voice.

creditsDeducted
object
required

The cost of the voice.

webhookUrl
object
required

The webhook URL for the voice.

errorMessage
object
required

An error message if the voice failed to process.