Инструкция для API

API доступен только после пополнения баланса

Доступны 2 варианта озвучки текста по API:

1 вариант - быстрая озвучка коротких текстов.
2 вариант - постановка задачи на озвучку текста.

1 вариант - быстрая озвучка коротких текстов. 

Урл для 1 варианта: https://zvukogram.com/index.php?r=api/text

Текст отправляется на API и сразу получаем результат озвучки. 

У данного варианта есть ограничение - максимум 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'). 
Доступен не для всех голосов, смотреть здесь.

Ответ приходит в JSON:

{
"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" - затраты на озвучку. (увеличивается по мере озвучки фрагментов)
 

2 вариант - постановка задачи на озвучку текста.

Урл для 2 варианта: https://zvukogram.com/index.php?r=api/longtext

Шаг 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'). 
Доступен не для всех голосов, смотреть здесь.

Ответ приходит в JSON:

{
"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
 
2021 - Звукограм