API Mage · Аудиомодель
API Seed Audio
Голоса, музыка и звуковые эффекты по одному промпту
POST https://api.mage.space/v1/seed_audio/generateГлавное
API Seed Audio запускает Seed Audio через Mage по адресу POST https://api.mage.space/v1/seed_audio/generate. Запрос с настройками по умолчанию стоит 19 Gems (около $0.019), подписка не нужна. Seed Audio принимает сохранённые аудиореференсы по @handle в промпте.
- АудиоРезультат
- 1Вариант
- 19Gems за клип, по умолчанию
- $0.019Примерно, в USD
Обзор
Что умеет API Seed Audio
Речь, диалоги, музыка и звуковые эффекты по одному промпту — в виде MP3 точно заданной длины, от 5 секунд до 2 минут. Голос можно подобрать по образцу, загрузив до 3 аудиоклипов.
Голоса, диалоги, музыка и звуковые эффекты по одному промпту — в виде MP3 точно заданной длительности.
На вход принимает image.
Быстрый старт
Вызов API Seed Audio
Задайте MAGE_API_KEY, отправьте запрос на /seed_audio/generate и опрашивайте status_url, пока запрос не завершится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])Модели
Значения model_id для Seed Audio
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| seed-audio-1.0 | Seed Audio | Да |
Параметры
Параметры Seed Audio
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| duration | 5, 10, 30, 60, 120 |
Входные данные
Какие медиафайлы принимает Seed Audio
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
Правила
Какие ограничения действуют в API Seed Audio
- Референс-изображение нельзя сочетать с аудиореференсами: отправляйте что-то одно.
- Длина промпта — не более 2986 символов.
- `sample_rate` — одно из значений: 8000, 16000, 24000, 32000, 44100, 48000.
- `speech_rate` — целое число от -50 до 100.
- `loudness_rate` — целое число от -50 до 100.
- `pitch_rate` — целое число от -12 до 12.
Другие аудиомодели
Другие API для генерации аудио в Mage
Eleven Music API
Песни ElevenLabs с вокалом и без
Eleven Speech API
ElevenLabs v4: реалистичная озвучка, которой можно управлять
API MiniMax Music 3
Полноценные песни по вашему тексту, открытые веса
FAQ
Частые вопросы
Сколько стоит API Seed Audio?
Какой эндпоинт у API Seed Audio?
Какие модели Seed Audio можно вызывать?
Поддерживает ли Seed Audio референсные изображения или персонажей?
Можно ли использовать Seed Audio из Claude или ChatGPT?
Как долго хранятся результаты Seed Audio?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.