Генерация речи
Успешный ответ представляет собой бинарное аудио, а не JSON.
На этой странице
https://api.shareai.now/api/v1/audio/speechГенерация речи
- Базовый URL
https://api.shareai.now- Аутентификация
- Bearer API-ключ или утвержденный токен доступа OAuth
- Требуемая область
inferenceormonetization_gateway
Успешный ответ — это бинарное аудио, а не JSON. Сохраните его с помощью curl --output speech.mp3 или считайте байты ответа в вашем SDK. Выберите поддерживаемый голос модели и формат вывода; скорость ограничена от 0.25 до 4. Лимит ввода составляет 256 KiB, а лимит синхронного ответа — 2 MiB.
Перед началом#
Установите SHAREAI_API_KEY на вашем сервере и замените заполнитель модели на текущую включенную модель. Никогда не раскрывайте API-ключ в коде браузера. Модель, учетная запись, учетные данные и провайдер должны разрешать эту операцию. Дополнительные настройки ниже требуют поддержки модели; границы безопасности API не гарантируют, что каждая модель поддерживает каждое значение.
Отправить запрос#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));Поля запроса#
| Поле | Тип | Значение и ограничения |
|---|---|---|
model обязательно | строка | Точный идентификатор включенной публичной модели. Должен объявлять эту операцию и быть разрешен вашими учетными данными. |
input обязательно | строка | Требуется непустой текст речи, максимум 256 KiB в кодировке UTF-8. Тарифы за символы учитывают символы Unicode, а не закодированные байты. |
voice | строка | Необязательный голос, поддерживаемый выбранной моделью речи, максимум 100 символов. |
response_format | строка | Необязательная поддерживаемая аудиокодировка, например mp3. Успешный ответ — это бинарный, а не JSON. Маршруты с ценой за длительность требуют самоописывающий MP3, WAV или FLAC. |
speed | число | Необязательная скорость речи от 0.25 до 4; модель может накладывать более узкие ограничения. |
provider | объект | Необязательные предпочтения маршрутизации провайдера. Используйте provider.only для принятых тегов провайдера, а не префикс в ID модели. Ограничения учетной записи и учетных данных все равно применяются. |
Прочитать результат#
Успешный ответ возвращает HTTP 200 с бинарным аудио. Успешный ответ — это бинарное аудио, а не JSON. Сохраните его с помощью curl --output speech.mp3 или считайте байты ответа в вашем SDK. Выберите поддерживаемый голос модели и формат вывода; скорость ограничена от 0.25 до 4. Лимит ввода составляет 256 KiB, а лимит синхронного ответа — 2 MiB.
Единицы выставления счетов#
Речь может тарифицироваться по количеству входных символов, токенов, сообщенных провайдером, или сгенерированных секунд, в зависимости от модели. Подсчет символов использует символы Unicode. Ценообразование по длительности требует поддерживаемого самоописывающего результата в формате MP3, WAV или FLAC. Сырой результат PCM не имеет предполагаемой частоты дискретизации. Маршруты с ценой за токены требуют надежного отчета об использовании.
Выберите точный идентификатор включенной модели из Console. Ее объявленная операция и возможности ввода/вывода должны соответствовать этой конечной точке; текстовая модель чата не может быть заменена для другой операции. Ваши учетные данные, провайдер и ограничения учетной записи все равно применяются.
Цены и использование#
Тарифы публикуются в AI-кредитах в евро для выбранной модели, провайдера, единиц и вариантов. Оплачиваются только измерения в активном тарифе. Оценка резервирует кредиты перед выполнением; окончательные списания основаны на измеренном использовании. Цены могут зависеть от разрешения, формата вывода или диапазона использования. Проверьте Console Usage для окончательного списания ShareAI. Поля затрат на вышестоящем уровне и байты медиа не преобразуются в вымышленные токены.
Доступ и ошибки#
Используйте inference для утвержденного вывода инференса с сетевыми затратами или monetization_gateway для утвержденной наценки Builder и принятых условий выставления счетов. Доступ только по идентификации не авторизует расходы. Проверка, авторизация модели, недостаток кредитов, ограничения тарифов и ошибки выполнения возвращают структурированный error. После тайм-аута или неопределенной отправки проверьте Usage или видео-задачу перед созданием другого потенциально оплачиваемого запроса.
Последнее обновление 3 ноября 2026