Skip to main content
POST
/
suno
/
v1
/
create-voice
cURL
curl --request POST \
  --url https://api.ttapi.io/suno/v1/create-voice \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "audio_url": "<string>",
  "hookUrl": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
Create Voice is an asynchronous task API.After submitting the request, the result will not be returned immediately. You can obtain the result using one of the following methods:
  • Set hookUrl to receive a callback notification when the task is completed
  • Or call the fetch API to manually query the task status and result
If you use hookUrl, please ensure that the URL is publicly accessible; otherwise, the callback notification may fail.
  1. The uploaded audio must contain clear human speech, otherwise the voice creation may fail.
Please follow these requirements:
  • The audio must contain clear human speech
  • Avoid background noise, music, or echo
  • Do not include multiple speakers
  • Low-volume, unclear, or noisy audio may cause generation failure or poor results
  1. The created voice is a private resource, and the following limitations apply:
  • Cross-account usage is not supported
  • After the voice is successfully created, please use it promptly, otherwise it may expire or become unavailable.
It is recommended to use the voice as soon as possible after creation to avoid expiration.
Recommended audio requirements:
  • Audio duration: at least 10 seconds
  • Speaker: single speaker only
  • Recording environment: quiet and noise-free
  • Audio format: WAV or MP3

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
audio_url
string
required

Publicly accessible direct audio file URL (WAV or MP3)

​
hookUrl
string

Callback notification URL

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 29, 2026