Перейти к содержимому

Mage API · Генерация аудио

API нейросети для генерации аудио: голоса, музыка и звуки

Речь, озвучка, музыка и звуковые эффекты по одному промпту с Seed Audio: голосовые референсы, настройка скорости речи, громкости и тона.

POST https://api.mage.space/v1/{model}/generate

Главное

API Mage для генерации аудио запускает Seed Audio по адресу https://api.mage.space/v1/seed_audio/generate. Отправьте текстовый промпт (при желании с голосовыми референсами или изображением) и получите аудиофайл до 120 секунд с голосами, музыкой или звуковыми эффектами. Каждый клип оплачивается в Gems, без подписки.

  • 4аудиомодели
  • $0.019Самый дешёвый вариант по умолчанию, за клип
  • 20Одновременных генераций
  • $0Абонентская плата

Модели

Все аудиомодели в Mage API

Цены указаны за одну генерацию, в Gems. 1000 Gems стоят $1 в стандартном пакете, а в больших пакетах есть бонусные Gems. Цена зависит от модели, разрешения и длительности; здесь показана цена при настройках по умолчанию, а точная сумма списания указана в каждом ответе в billing.gems_charged. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.

МодельЛучше всего подходит дляЗначения model_idЦена по умолчанию
Eleven MusicПесни ElevenLabs с вокалом и безeleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: реалистичная озвучка, которой можно управлятьeleven-v430 Gems ($0.03)
MiniMax Music 3Полноценные песни по вашему тексту, открытые весаminimax-music-3125 Gems ($0.125)
Seed AudioГолоса, музыка и звуковые эффекты по одному промптуseed-audio-1.019 Gems ($0.019)

Быстрый старт

Генерация аудио с Eleven Music v2.5

Задай MAGE_API_KEY, отправь запрос и опрашивай статус, пока он не завершится. Замени eleven_music в URL на любую модель из списка выше.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
  "duration": "30",
  "model_id": "eleven-music-v2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('eleven_music', {
  prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
  duration: '30',
  model_id: 'eleven-music-v2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("eleven_music", {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
    "duration": "30",
    "model_id": "eleven-music-v2.5",
})

print(request["result"]["url"])

Как это работает

От API-ключа до готового результата за три вызова

У всех моделей одна схема аутентификации, один жизненный цикл асинхронного запроса и одинаковые названия полей.

  1. Создайте API-ключ

    Войдите в Mage, откройте API → API Keys и создайте ключ. Он начинается с mage_sk_ и показывается только один раз. В аккаунте может быть до 10 активных ключей.

  2. Отправьте генерацию

    Отправьте POST-запрос с JSON-телом на https://api.mage.space/v1/{model}/generate с заголовком Authorization: Bearer. Ответ приходит сразу и содержит request_id, status и status_url. Добавьте заголовок Idempotency-Key, чтобы повторный запрос не списывал оплату дважды.

  3. Опрашивайте и скачивайте

    Опрашивайте status_url, пока статус не станет completed, failed или cancelled. В завершённом запросе есть result.url со ссылкой на файл изображения, видео или аудио; он хранится 30 дней.

Готово к продакшену

Что получает каждый запрос к Mage API

  • Один ключ — все модели

    37 моделей для изображений, видео и аудио в одном REST API и с одним балансом Gems. Чтобы сменить модель, измените путь в URL.

  • Оплата за каждую генерацию

    Без подписки и минимальных трат. Вы покупаете Gems, и за каждый запрос списывается его цена по прайс-листу. Если генерация не удалась, Gems возвращаются — кроме случаев, когда её заблокировала политика контента Mage.

  • Безопасные повторы

    Ключи идемпотентности гарантируют, что повторная отправка вернёт исходный запрос без повторного списания.

  • Стабильные персонажи

    Сохраните персонажа или референс один раз, а затем пишите @handle в любом промпте, чтобы использовать его в каждой модели, которая это поддерживает.

  • Большие входные файлы

    Передавайте изображения, видео и аудио как URL или data URL либо загружайте файлы до 100 МБ через подписанную загрузку.

  • 20 генераций одновременно

    Каждый аккаунт может запускать 20 генераций одновременно, а лимит можно повысить под вашу задачу. За отклонённые запросы плата не списывается.

Сценарии использования

Что разработчики создают с аудио API

  • Закадровый голос и озвучка

    Создавайте озвучку для видео, обучающих роликов и аудиокниг с настройкой скорости речи, громкости и тона.

  • Стабильные голоса

    Сохраните голосовой клип как референс и упоминайте его через @handle, чтобы голос оставался одинаковым во всех клипах.

  • Звуковые эффекты

    Создавайте атмосферные звуки, фоли и звуки интерфейса по описанию для игр и приложений.

  • Музыкальная подложка

    Создавайте фоновую музыку для клипов в соцсетях и рекламы по промпту.

  • Саундтреки для сгенерированного видео

    Используйте Seed Audio вместе с API для видео, чтобы добавлять звук в клипы от моделей без звука.

  • Агенты, которые говорят

    Пусть Claude, ChatGPT или ваш собственный агент создаёт аудио через MCP-сервер или REST API.

FAQ

Частые вопросы

Умеет ли аудио API озвучивать текст?
Да. Seed Audio читает сценарий заданным в описании голосом или сохранённым голосовым референсом и позволяет настраивать скорость речи, громкость и тон. Из того же поля промпта можно создавать музыку и звуковые эффекты.
Какой длины может быть сгенерированное аудио?
Seed Audio создаёт клипы длиной до 120 секунд.
Сколько стоит Mage API?
Подписки и ежемесячной платы нет. Каждая генерация оплачивается в Gems по цене её модели, а 1 000 Gems в стандартном пакете стоят $1. На странице каждой модели указана цена при настройках по умолчанию, а в каждом ответе — точная сумма списания. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет. Запрос, на который не хватает баланса, отклоняется до любого списания.
Нужна ли подписка Mage, чтобы пользоваться API?
Нет. API работает только на Gems. Тарифные планы и безлимитная генерация в приложении на запросы через API не распространяются. Сначала на аккаунте должен пройти один успешный платёж: подойдёт любой пакет Gems или любой план. Бонусные Gems, полученные при регистрации, действуют только в приложении Mage.
Можно ли использовать результаты API в коммерческих целях?
Да. Контент, созданный в Mage, в том числе через API и MCP-сервер, можно использовать в коммерческих целях. Указывать авторство приятно, но необязательно.
Какие есть лимиты запросов?
В одном аккаунте одновременно может быть до 20 генераций в очереди или в работе. Запрос сверх этого лимита отклоняется с кодом 429 и ничего не стоит. Напишите на [email protected], чтобы увеличить лимит под вашу задачу.
Может ли мой ИИ-агент использовать Mage API?
Да. Агенты могут вызывать REST API по ключу или подключаться к MCP-серверу Mage, который даёт Claude, ChatGPT, Claude Code, Grok и Cursor шестнадцать готовых инструментов: выбрать модель, узнать цену, запустить генерацию и получить результат. Подробности: MCP-сервер.
Есть ли SDK для Mage API?
Да. Официальные пакеты @mage-space/sdk в npm и mage-space в PyPI имеют открытый исходный код и типизацию для каждой модели. Они сами отправляют запрос, дожидаются результата, безопасно повторяют попытки и загружают файлы. Пользователи ComfyUI могут установить набор нод comfyui-mage. Подробности: SDK Mage.
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Направьте клиент на https://api.mage.space/v1, передавайте ключ Mage как Bearer-токен и сопоставьте свои поля с полями на странице модели: prompt, aspect_ratio, resolution, duration и model_id работают одинаково во всех моделях Mage. Запросы асинхронные: отправьте запрос, а затем опрашивайте status_url.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

CharactersСообщество