ShareAI Platform Docs

Генерация аудио

Конечный пункт ShareAI возвращает ограниченный аудио-результат в формате JSON.

Просмотреть как Markdown
На этой странице
POST https://api.shareai.now/api/v1/audio/generations

Генерация аудио

Базовый URL
https://api.shareai.now
Аутентификация
Bearer API-ключ или утвержденный токен доступа OAuth
Требуемая область
inference or monetization_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
}'

Поля запроса#

ПолеТипЗначение и ограничения
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

Документация платформы ShareAI
Вся документация

Искать по названию или содержанию.

Спросить об этой странице

Выберите помощника для изучения этой страницы. Вы также можете скопировать страницу и вставить её в ваш диалог.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI