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.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: реалистичная озвучка, которой можно управлять | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Полноценные песни по вашему тексту, открытые веса | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Голоса, музыка и звуковые эффекты по одному промпту | seed-audio-1.0 | 19 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-ключа до готового результата за три вызова
У всех моделей одна схема аутентификации, один жизненный цикл асинхронного запроса и одинаковые названия полей.
Создайте API-ключ
Войдите в Mage, откройте API → API Keys и создайте ключ. Он начинается с mage_sk_ и показывается только один раз. В аккаунте может быть до 10 активных ключей.
Отправьте генерацию
Отправьте POST-запрос с JSON-телом на https://api.mage.space/v1/{model}/generate с заголовком Authorization: Bearer. Ответ приходит сразу и содержит request_id, status и status_url. Добавьте заголовок Idempotency-Key, чтобы повторный запрос не списывал оплату дважды.
Опрашивайте и скачивайте
Опрашивайте 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 озвучивать текст?
Какой длины может быть сгенерированное аудио?
Сколько стоит Mage API?
Нужна ли подписка Mage, чтобы пользоваться API?
Можно ли использовать результаты API в коммерческих целях?
Какие есть лимиты запросов?
Может ли мой ИИ-агент использовать Mage API?
Есть ли SDK для Mage API?
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.