Перейти к основному содержанию
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 — это асинхронный API-запрос.После отправки запроса результат не возвращается сразу. Вы можете получить результат одним из следующих способов:
  • Указать hookUrl, чтобы получить уведомление через callback после завершения задачи
  • Или вызвать fetch API для ручного запроса статуса задачи и результата
Если вы используете hookUrl, убедитесь, что этот URL доступен из публичной сети, иначе уведомление callback может не быть доставлено.
  1. Загружаемый аудиофайл должен содержать чёткую человеческую речь, иначе создание голоса может завершиться с ошибкой.
Пожалуйста, соблюдайте следующие требования:
  • Аудио должно содержать чёткую человеческую речь
  • Избегайте фонового шума, музыки или эха
  • Не используйте аудио с несколькими говорящими
  • Тихая, неразборчивая или шумная запись может привести к ошибке генерации или ухудшению качества результата
  1. Созданный голос является приватным ресурсом, и применяются следующие ограничения:
  • Использование между разными аккаунтами не поддерживается
  • После успешного создания голоса, пожалуйста, используйте его как можно скорее, иначе он может истечь или стать недоступным.
Рекомендуется использовать голос как можно скорее после создания, чтобы избежать его истечения.
Рекомендуемые требования к аудио:
  • Длительность аудио: более 10 секунд
  • Говорящий: один человек
  • Среда записи: тихая, без шума
  • Формат аудио: WAV или MP3

Авторизации

​
TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в TTAPI Dashboard.

Тело

application/json
​
audio_url
string
обязательно

Публично доступный прямой URL аудиофайла (без страницы, только файл WAV или MP3)

​
hookUrl
string

URL обратного уведомления

Ответ

Запрос выполнен успешно

​
status
string
обязательно
Пример:

"SUCCESS"

​
message
string
обязательно
Пример:

"success"

​
data
object
обязательно
Пример:
{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 29, 2026