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

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

API для генерації відео за допомогою ШІ з тексту чи зображень

Текст у відео, зображення у відео, перший і останній кадр та референси у відео на 12 моделях на чолі з флагманською Cherry 2 Pro від Mage, у багатьох кліпах — зі звуком.

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

Коротко

API Mage для генерації відео — це REST API на https://api.mage.space/v1, який запускає 12 моделей перетворення тексту та зображень у відео, зокрема Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video і Wan. Надішліть промпт і за потреби кадри чи референси, опитуйте статус запиту та завантажте MP4. Кожен кліп оплачується в Gems залежно від моделі, роздільної здатності й тривалості.

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

Моделі

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

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

МодельНайкраще дляЗначення model_idЦіна за замовчуванням
BerryВідео, вірне вашим референсамberry, berry-2189 Gems ($0.189)
BlueberryЗадайте перший і останній кадрblueberry, blueberry-v2360 Gems ($0.36)
CherryНаша флагманська лінійка відеомоделейcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine в русіgrok-imagine-video375 Gems ($0.375)
KiwiВідео на щодень, без налаштуваньkiwi270 Gems ($0.27)
LemonУсі відеофункції за привабливішою ціноюlemon245 Gems ($0.245)
LTX VideoШвидке відео з відкритими вагами для ітераційltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonАніме в русі, зі звуком на вибірmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Швидке відкрите відео зі стереозвукомminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumЗвук у кожному кліпі, до 2Kplum, plum-max338 Gems ($0.338)
RaspberryПерсонажі оживають з першого кадруraspberry360 Gems ($0.36)
Wan Video v2.2Відео з відкритими вагами та варіантом Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

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

Згенеруйте відео за допомогою Berry 2

Задайте MAGE_API_KEY, надішліть запит і опитуйте статус, доки він не завершиться. Замініть berry в URL на будь-яку модель зі списку вище.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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 відео

  • Короткі відео для соцмереж

    Створюйте вертикальні кліпи для TikTok, Reels і Shorts із промпту або зображення товару.

  • Анімація нерухомих зображень

    Перетворюйте перший кадр або пару з першого й останнього кадрів на рух за допомогою моделей зображення у відео, як-от Lemon і Kiwi.

  • Історії з персонажами

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

  • Відео зі звуком

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

  • Реклама та демо продуктів

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

  • Редагування наявних кліпів

    Berry, Plum і Grok Video редагують надіслане вами вихідне відео; Lemon і MiniMax-H3 також приймають референсні відео.

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

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

Який найкращий API для генерації відео за допомогою ШІ?
У Mage для відео за замовчуванням використовується Cherry 2 Pro: він підтримує персонажів, багато референсних зображень, аудіореференси, вихід від 480p до 1080p і кліпи тривалістю до 30 секунд. Lemon — вибір для керування першим і останнім кадром, Plum — для кліпів зі згенерованим звуком до 2K, а Cherry Mini або Wan — для дешевших чернеток.
Чи підтримує API відео перетворення зображень у відео?
Так. Моделі зображення у відео приймають перший кадр, а деякі також останній кадр чи референсні зображення — як URL, data URL або завантаження. На сторінці кожної моделі вказано її вхідні дані та чи обов’язкове зображення.
Якої тривалості можуть бути згенеровані відео?
Залежить від моделі та роздільної здатності. Багато моделей генерують від 4 до 15 секунд, а Cherry 2 Pro — 20, 25 і 30 секунд. На сторінці кожної моделі вказано доступну тривалість.
Скільки часу триває генерація відео?
Залежить від моделі, роздільної здатності й тривалості. API асинхронний: надішліть запит, а потім опитуйте status_url із затримкою між спробами або дозвольте вашому MCP-клієнту чекати за допомогою get_request.
Скільки коштує 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