Перейти до вмісту
PlaygroundДокументаціяОтримати API-ключ

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

API для генерації аудіо зі ШІ: голоси, музика та звук

Мовлення, озвучення, музика та звукові ефекти з одного промпту в Seed Audio, з голосовими референсами та налаштуваннями швидкості мовлення, гучності й висоти тону.

Отримати API-ключЧитати документацію API
POST https://api.mage.space/v1/{model}/generate

Коротко

API генерації аудіо Mage запускає Seed Audio за адресою https://api.mage.space/v1/seed_audio/generate. Надішліть текстовий промпт, за потреби з голосовими референсами чи зображенням, і отримайте аудіофайл тривалістю до 120 секунд з голосами, музикою або звуковими ефектами. Кожен кліп оплачується в Gems, без підписки.

  • 1аудіомоделі
  • $0.019Найдешевший варіант за замовчуванням, за кліп
  • 20Одночасні генерації
  • $0Щомісячна плата

Моделі

Усі аудіомоделі в Mage API

Ціни вказано за одну генерацію, у Gems. 1 000 Gems коштують $1 у стандартному пакеті, а більші пакети дають додаткові Gems. Ціна залежить від моделі, роздільної здатності та тривалості; показано ціну за стандартних налаштувань, а точну суму списання кожна відповідь містить у billing.gems_charged. За невдалу генерацію кошти повертаються; за ту, яку заблокувала політика контенту Mage, — ні.

МодельНайкраще дляЗначення model_idЦіна за замовчуванням
Seed AudioГолоси, музика та звукові ефекти з одного промптуseed-audio-1.019 Gems ($0.019)

Швидкий старт

Генеруйте аудіо за допомогою Seed Audio

Задайте MAGE_API_KEY, надішліть запит і опитуйте, доки він не завершиться. Замініть seed_audio в 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"])

Як це працює

Від 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

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

    28 моделей для зображень, відео й аудіо в одному REST API з єдиним балансом Gems. Щоб змінити модель, достатньо змінити шлях в URL.

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

    Без підписки й мінімальних витрат. Ти купуєш Gems, а за кожен запит списується його вказана ціна. Якщо генерація не вдалася, кошти повертаються — крім випадків, коли її заблокувала політика щодо контенту Mage.

  • Безпечні повторні спроби

    Ключі ідемпотентності гарантують, що повторне надсилання поверне початковий запит без повторного списання коштів.

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

    Збережи персонажа або референс один раз, а потім пиши @handle у будь-якому промпті, щоб використовувати його з усіма моделями, які це підтримують.

  • Великі вхідні файли

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

  • 20 генерацій одночасно

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

Сценарії використання

Що розробники створюють за допомогою API для аудіо

  • Озвучення та дикторський текст

    Генеруйте озвучення для відео, пояснювальних роликів та аудіокниг із налаштуваннями швидкості мовлення, гучності й висоти тону.

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

    Збережіть голосовий кліп як референс і згадуйте його через @handle, щоб зберігати той самий голос у різних кліпах.

  • Звукові ефекти

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

  • Фонова музика

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

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

    Поєднайте Seed Audio з API для відео, щоб додавати звук до кліпів із моделей без звуку.

  • Агенти, які говорять

    Дозвольте Claude, ChatGPT або власному агенту створювати аудіо через сервер MCP чи REST API.

Поширені запитання

Поширені запитання

Чи вміє API для аудіо перетворювати текст на мовлення?
Так. Seed Audio читає сценарій описаним голосом або збереженим голосовим референсом і має налаштування швидкості мовлення, гучності та висоти тону. Також він генерує музику й звукові ефекти з того самого поля промпту.
Якої тривалості може бути згенероване аудіо?
Seed Audio генерує кліпи тривалістю до 120 секунд.
Скільки коштує Mage API?
Жодної підписки чи щомісячної плати. Кожна генерація оплачується в Gems за ціною моделі, а 1000 Gems коштують $1 у стандартному пакеті. На сторінці кожної моделі вказана ціна за стандартних налаштувань, а у відповіді на запит показано точну суму списання. Якщо генерація не вдалася, кошти повертаються; якщо її заблокувала політика щодо контенту Mage — ні. Запит, на який не вистачає балансу, відхиляється ще до будь-якого списання.
Чи потрібна підписка на Mage, щоб користуватися API?
Ні. API працює лише на Gems. Плани підписки та безлімітна генерація в застосунку не поширюються на API-запити, тож його може викликати будь-який акаунт Mage з Gems.
Чи можна використовувати результати API в комерційних цілях?
Так. Контент, створений у Mage, зокрема через API та MCP-сервер, можна використовувати в комерційних цілях. Вказувати авторство бажано, але не обов’язково.
Які є ліміти запитів?
В одному акаунті може одночасно бути 20 генерацій у черзі або в роботі. Запит понад ліміт відхиляється з помилкою 429 і нічого не коштує. Напиши на [email protected], щоб збільшити ліміт під твій сценарій.
Чи може мій ШІ-агент користуватися API Mage?
Так. Агенти можуть викликати REST API за допомогою ключа або підключитися до MCP-сервера Mage, який дає Claude, ChatGPT, Claude Code, Grok і Cursor шістнадцять готових інструментів для вибору моделі, розрахунку ціни, генерації та отримання результату. Докладніше — про MCP-сервер.
Чи є SDK для API Mage?
Так. Офіційні пакети @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, усі моделі. Плати лише за те, що генеруєш.

Отримати API-ключЧитати документацію API