API доступен только после пополнения баланса
Доступны 2 варианта озвучки текста по API:
1 вариант - быстрая озвучка коротких текстов.
2 вариант - постановка задачи на озвучку текста.
Урл для 1 варианта: https://zvukogram.com/index.php?r=api/text
У данного варианта есть ограничение - максимум 300 символов. А также максимум 2 смены голоса. В случае превышение лимитов получим ошибку (status = -1).
$data = [ 'token'=>'СекретныйКлючДоступныйВЛичномКабинете', 'email'=>'ВашаПочта@gmail.com', 'voice'=>'Владимир', 'text'=>"Текст который будет озвучен", 'format'=>'mp3', 'speed'=>1.1, 'pitch'=>0.8, 'emotion'=>'good', ];
'token' - 'СекретныйКлючДоступныйВЛичномКабинете' 'email' - 'ВашаПочта@gmail.com' 'voice' - 'Голос' 'text' - 'Текст который будет озвучен'
'format' - формат результирующего файла, по умолчанию = mp3, доступные значения ( 'mp3', 'wav', 'ogg') 'speed' - скорость воспроизведения, по умолчанию 1, (диапазон от 0.1 до 2.0) 'pitch'- высота голоса, по умолчанию 0, (диапазон от -20 до 20) 'emotion' - эмоциональный окрас голоса, по умолчанию 'good', доступные значения ( 'good', 'evil', 'neutral').
Доступен не для всех голосов, смотреть здесь.
{ "id":"4153594", "status":"0", "file":"result.mp3", "parts":"5", "parts_done":"2", "duration":"0", "format":"mp3", "error":"", "balans":"3331.2720000314", "cost":"0.06" }
"id" - уникальный идентификатор озвучки "status" - текущий статус озвучки. Доступны 3 значения: 0 - в процессе 1 - завершен успешно -1 - ошибка "file" - путь до аудио файла, доступен если status = 1 "error" - текст ошибки, в случае, если status = -1 "parts" - число фрагментов озвучки "parts_done" - число фрагментов завершенных "duration" - длительность аудио файла в секундах, доступен если status = 1 "format" - формат аудиофайла "balans" - остаток на балансе в токенах "cost" - затраты на озвучку. (увеличивается по мере озвучки фрагментов)
Шаг 1: Текст отправляется на API и получаем уникальный идентификатор озвучки (id).
Шаг 2: Запрашиваем результат озвучки , отправив идентификатор озвучки (id).
Данный метод не имеет ограничений и позволяет озвучивать текста до 1000 000 символов. Озвучка происходит в порядке очереди (первый пришел, первый обработан) и может занимать от 1 до нескольких минут в зависимости от длинны текста.
$data = [ 'token'=>'СекретныйКлючДоступныйВЛичномКабинете', 'email'=>'ВашаПочта@gmail.com', 'voice'=>'Владимир', 'text'=>"Текст который будет озвучен", 'format'=>'mp3', 'speed'=>1.1, 'pitch'=>0.8, 'emotion'=>'good', ];
'token' - 'СекретныйКлючДоступныйВЛичномКабинете' 'email' - 'ВашаПочта@gmail.com' 'voice' - 'Голос' 'text' - 'Текст который будет озвучен'
'format' - формат результирующего файла, по умолчанию = mp3, доступные значения ( 'mp3', 'wav', 'ogg') 'speed' - скорость воспроизведения, по умолчанию 1, (диапазон от 0.1 до 2.0) 'pitch'- высота голоса, по умолчанию 0, (диапазон от -20 до 20) 'emotion' - эмоциональный окрас голоса, по умолчанию 'good', доступные значения ( 'good', 'evil', 'neutral').
Доступен не для всех голосов, смотреть здесь.
{ "id":"4153594", "status":"0", "file":"result.mp3", "parts":"5", "parts_done":"2", "duration":"0", "format":"mp3", "error":"", "balans":"3331.2720000314", "cost":"0.06" }
"id" - уникальный идентификатор озвучки "status" - текущий статус озвучки. Доступны 3 значения: 0 - в процессе 1 - завершен успешно -1 - ошибка "file" - путь до аудио файла, доступен если status = 1 "error" - текст ошибки, в случае, если status = -1 "parts" - число фрагментов озвучки "parts_done" - число фрагментов завершенных "duration" - длительность аудио файла в секундах, доступен если status = 1 "format" - формат аудиофайла "balans" - остаток на балансе в токенах "cost" - затраты на озвучку. (увеличивается по мере озвучки фрагментов)
После создания задачи и получения идентификатора (id), необходим отправить запроса на https://zvukogram.com/index.php?r=api/result, чтобы узнать результат.
$data = [ 'token'=>'СекретныйКлючДоступныйВЛичномКабинете', 'email'=>'ВашаПочта@gmail.com', 'id'=>4153594, ];
'token' - СекретныйКлючДоступныйВЛичномКабинете 'email' - ВашаПочта@gmail.com 'id' - Уникальный идентификатор озвучки полученный на шаге 1