JAICP

Описание метода API


Генерирует аудиофайл по переданному тексту.

POST https://aimyvoice.com/api/v1/synthesize

Запрос

Заголовки

Заголовок Значение
api-key Ваш API-токен.

Чтобы получить его, выберите нужный голос:
• в каталоге;
• на странице Мои голоса (раздел Опубликованные версии).
Content-Type application/x-www-form-urlencoded

Тело

Параметр Тип Описание
text string Текст на русском языке, который вы хотите озвучить, в кодировке UTF-8.
Если вы отправляете запрос при помощи библиотеки requests для Python, текст должен быть закодирован методом URL (percent-encoding).

• Ограничение на длину строки: 250 символов.
• Допускается использование символов:
€ £ ₽ $ % № # & - — – + * = . , ! ? ; : " `` ' ° \ / ( ) < > «» ± ^.
• Чтобы проставить ударение в слове, используйте + после ударной гласной.
• Чтобы проставить фразовое ударение, используйте # перед словом.
• Допускается использование SSML-тегов.

Примеры

Python
cURL
import requests
# from urllib.parse import urlencode

url = "https://aimyvoice.com/api/v1/synthesize"

payload = {
    "text": "%D0%9C%D0%BE%D0%B9%20%D0%B4%D1%8F%D0%B4%D1%8F%20%3Cbreak%20time%3D%221s%22%2F%3E%20%D1%81%D0%B0%D0%BC%D1%8B%D1%85%20%D1%87%D0%B5%D1%81%D1%82%D0%BD%D1%8B%D1%85%20%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%20%3Cbreak%20time%3D%221s%22%2F%3E%20%D0%9A%D0%BE%D0%B3%D0%B4%D0%B0%20%D0%BD%D0%B5%20%D0%B2%20%D1%88%D1%83%D1%82%D0%BA%D1%83%20%D0%B7%D0%B0%D0%BD%D0%B5%D0%BC%D0%BE%D0%B3%3Cbreak%20time%3D%221s%22%2F%3E%20%20%D0%9E%D0%BD%20%D1%83%D0%B2%D0%B0%D0%B6%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%B1%D1%8F%20%D0%B7%D0%B0%D1%81%D1%82%D0%B0%D0%B2%D0%B8%D0%BB!"
}

headers = {
  'api-key': 'Yzwz941JrOvpI+Eb29Eynn+HK6A47GexZdAIFCCYLmF492gNmzWZBBkYyYyYyYyfTeN0Ltyt/ZFl/zkEdsYaQQ==',
  'Content-Type': 'application/x-www-form-urlencoded'
}

response = requests.request("POST", url, headers=headers, data=payload)
if response.status_code != 200:
    print(response.text)

with open("res.wav", "wb") as fout:
    fout.write(response.content)
curl --location --request POST 'https://aimyvoice.com/api/v1/synthesize' \
--header 'api-key: Yzwz941JrOvpI+Eb29Eynn+HK6A47GexZdAIFCCYLmF492gNmzWZBBkYyYyYyYyfTeN0Ltyt/ZFl/zkEdsYaQQ==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'text=Мой дядя <break time="1s"/> самых честных правил <break time="1s"/> Когда не в шутку занемог<break time="1s"/>  Он уважать себя заставил '

Ответ

Если синтез прошел успешно, в ответ придет строка с бинарными данными. Сохраните содержимое строки в файл с расширением WAV.

Пример

HTTP/1.1 200 OK
Server: nginx/1.16.1
Date: Fri, 19 Nov 2021 12:35:54 GMT
Content-Type: audio/wav
...

(строка с бинарными данными)