Генерация аудио
Конечный пункт ShareAI возвращает ограниченный аудио-результат в формате JSON.
На этой странице
https://api.shareai.now/api/v1/audio/generationsГенерация аудио
- Базовый URL
https://api.shareai.now- Аутентификация
- Bearer API-ключ или утвержденный токен доступа OAuth
- Требуемая область
inferenceormonetization_gateway
Конечная точка ShareAI возвращает ограниченный JSON-результат аудио. Запросы на генерацию аудио с modalities:["text","audio"] также могут использовать /api/v1/chat/completions. Ваш запрос направляется на объявленную аудио-операцию. Этот синхронный ответ собирается перед возвратом; незавершенные потоки провайдера не становятся успешно оплачиваемыми результатами. Форматы аудиовыхода: mp3, wav, flac, pcm16 или pcm24, в зависимости от модели. Сырой PCM не поддерживает тарификацию по длительности. Установите либо max_tokens, либо max_completion_tokens для ограничения генерируемых токенов; не указывайте оба параметра.
Перед началом#
Установите SHAREAI_API_KEY на вашем сервере и замените заполнитель модели на текущую включенную модель. Никогда не раскрывайте API-ключ в коде браузера. Модель, учетная запись, учетные данные и провайдер должны разрешать эту операцию. Дополнительные настройки ниже требуют поддержки модели; границы безопасности API не гарантируют, что каждая модель поддерживает каждое значение.
Отправить запрос#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Поля запроса#
| Поле | Тип | Значение и ограничения |
|---|---|---|
model обязательно | строка | Точный идентификатор включенной публичной модели. Должен объявлять эту операцию и быть разрешен вашими учетными данными. |
messages обязательно | массив | 1–256 сообщений в разговоре с ролью/контентом. Используйте только модальности контента, поддерживаемые выбранной аудиомоделью. |
modalities | массив | Одно или два уникальных значения из текста и аудио; аудио обязательно. По умолчанию используется аудио. Этот синхронный endpoint не принимает поток. |
audio | объект | Дополнительные параметры вывода: только голос и формат. Формат — mp3, wav, flac, pcm16 или pcm24, в зависимости от поддержки модели. Сырой PCM несовместим с тарификацией по длительности. |
temperature | число | Дополнительная температура генерации, поддерживаемая моделью. |
top_p | число | Дополнительное значение выборки ядра, поддерживаемое моделью. |
max_tokens | целое число | Дополнительное ограничение токенов вывода, 1–262144. Не комбинируйте с max_completion_tokens. |
max_completion_tokens | целое число | Дополнительное ограничение токенов вывода, 1–262144. Не комбинируйте с max_tokens. |
provider | объект | Необязательные предпочтения маршрутизации провайдера. Используйте provider.only для принятых тегов провайдера, а не префикс в ID модели. Ограничения учетной записи и учетных данных все равно применяются. |
Прочитать результат#
Успешный ответ возвращает HTTP 200 с JSON. Конечная точка ShareAI возвращает ограниченный JSON-результат аудио. Запросы на генерацию аудио с modalities:["text","audio"] также могут использовать /api/v1/chat/completions. Ваш запрос направляется на объявленную аудио-операцию. Этот синхронный ответ собирается перед возвратом; незавершенные потоки провайдера не становятся успешно оплачиваемыми результатами. Форматы аудиовыхода: mp3, wav, flac, pcm16 или pcm24, в зависимости от модели. Сырой PCM не поддерживает тарификацию по длительности. Установите либо max_tokens, либо max_completion_tokens для ограничения генерируемых токенов; не указывайте оба параметра.
Единицы выставления счетов#
Аудиомодели могут публиковать отдельные размеры текстовых и аудиотокенов, длительность, ставки песен или запросов. Общие токены делятся на раздельные счетчики текста/аудио; одни и те же аудиотокены никогда не взимаются повторно как текст. Неподдерживаемое или отсутствующее использование не оценивается по закодированным байтам.
Выберите точный идентификатор включенной модели из Console. Ее объявленная операция и возможности ввода/вывода должны соответствовать этой конечной точке; текстовая модель чата не может быть заменена для другой операции. Ваши учетные данные, провайдер и ограничения учетной записи все равно применяются.
Цены и использование#
Тарифы публикуются в AI-кредитах в евро для выбранной модели, провайдера, единиц и вариантов. Оплачиваются только измерения в активном тарифе. Оценка резервирует кредиты перед выполнением; окончательные списания основаны на измеренном использовании. Цены могут зависеть от разрешения, формата вывода или диапазона использования. Проверьте Console Usage для окончательного списания ShareAI. Поля затрат на вышестоящем уровне и байты медиа не преобразуются в вымышленные токены.
Доступ и ошибки#
Используйте inference для утвержденного вывода инференса с сетевыми затратами или monetization_gateway для утвержденной наценки Builder и принятых условий выставления счетов. Доступ только по идентификации не авторизует расходы. Проверка, авторизация модели, недостаток кредитов, ограничения тарифов и ошибки выполнения возвращают структурированный error. После тайм-аута или неопределенной отправки проверьте Usage или видео-задачу перед созданием другого потенциально оплачиваемого запроса.
Последнее обновление 3 ноября 2026