Przejdź do treści

API Mage · Generowanie wideo

API do generowania wideo AI z tekstu lub obrazów

Tekst na wideo, obraz na wideo, pierwsza i ostatnia klatka oraz wideo z referencji w 15 modelach, z flagowym modelem Mage Cherry 2 Pro na czele, a wiele klipów ma też dźwięk.

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

W skrócie

API do generowania wideo Mage to REST API pod adresem https://api.mage.space/v1, które obsługuje 15 modeli tekst-na-wideo i obraz-na-wideo, w tym Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video i Wan. Wyślij prompt oraz opcjonalne klatki lub referencje, sprawdzaj status żądania i pobierz plik MP4. Każdy klip jest opłacany w Gems zależnie od modelu, rozdzielczości i czasu trwania.

  • 15modeli wideo
  • $0.02Najtańsza opcja domyślna, za klip
  • 20Równoczesne generowania
  • $0Opłata miesięczna

Modele

Wszystkie modele wideo w API Mage

Ceny są za jedno generowanie, w Gems. 1000 Gems kosztuje 1 USD w standardowym pakiecie, a większe pakiety dodają bonusowe Gems. Cena zależy od modelu, rozdzielczości i czasu trwania; pokazujemy cenę dla ustawień domyślnych, a dokładną opłatę podaje każda odpowiedź w billing.gems_charged. Nieudane generowanie jest zwracane; zablokowane przez zasady treści Mage — nie.

ModelNajlepszy doWartości model_idCena domyślna
BerryWideo wierne Twoim referencjomberry, berry-2189 Gems ($0.189)
BlueberryUstal pierwszą i ostatnią klatkęblueberry, blueberry-v2360 Gems ($0.36)
CherryNasza flagowa rodzina modeli wideocherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine w ruchugrok-imagine-video375 Gems ($0.375)
KiwiWideo na co dzień, bez konfiguracjikiwi270 Gems ($0.27)
LemonWszystkie funkcje wideo w przystępniejszej cenielemon245 Gems ($0.245)
LTX VideoSzybkie wideo z otwartymi wagami do iteracjiltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MagejutsuZmień obsadę dowolnego wideo, zachowując jego ruchmagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
MelonAnime w ruchu, opcjonalnie z dźwiękiemmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Szybkie otwarte wideo z dźwiękiem stereominimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
PlumDźwięk w każdym klipie, do 2Kplum, plum-max, plum-fast173 Gems ($0.173)
RaspberryPostacie ożywione z pierwszej klatkiraspberry360 Gems ($0.36)
SeedanceSeedance z rygorystycznym filtremseedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0, z rygorystycznym filtremwan-3.0245 Gems ($0.245)
Wan Video v2.2Wideo z otwartymi wagami z wariantem Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Szybki start

Wygeneruj wideo w Berry 2

Ustaw MAGE_API_KEY, wyślij zgłoszenie i sprawdzaj status, aż się zakończy. Zamień berry w adresie URL na dowolny model z listy powyżej.

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"])

Jak to działa

Od klucza API do gotowego pliku w trzech wywołaniach

Każdy model korzysta z jednego schematu uwierzytelniania, jednego asynchronicznego cyklu żądania i tych samych nazw pól.

  1. Utwórz klucz API

    Zaloguj się do Mage, otwórz API → API Keys i utwórz klucz. Zaczyna się od mage_sk_ i jest wyświetlany tylko raz. Konto może mieć 10 aktywnych kluczy.

  2. Wyślij generację

    Wyślij POST z ciałem JSON na https://api.mage.space/v1/{model}/generate z nagłówkiem Authorization: Bearer. Odpowiedź przychodzi od razu i zawiera request_id, status oraz status_url. Dodaj nagłówek Idempotency-Key, aby ponowienie nigdy nie kosztowało podwójnie.

  3. Sprawdzaj status i pobierz plik

    Odpytuj status_url, aż status zmieni się na completed, failed lub cancelled. Zakończone żądanie zawiera result.url z plikiem obrazu, wideo lub audio, który jest przechowywany przez 30 dni.

Stworzone do produkcji

Co dostaje każde zapytanie do Mage API

  • Jeden klucz, wszystkie modele

    37 modeli do obrazów, wideo i dźwięku w jednym REST API i z jednym saldem Gems. Model zmienisz, zmieniając ścieżkę w URL.

  • Płać za generację

    Bez subskrypcji i minimalnych wydatków. Kupujesz Gems, a każde zapytanie kosztuje tyle, ile wskazuje cennik. Za nieudaną generację zwracamy koszt, chyba że zablokowała ją polityka treści Mage.

  • Bezpieczne ponowienia

    Klucze idempotentności sprawiają, że ponowne wysłanie zapytania zwraca oryginalny wynik i nie pobiera opłaty drugi raz.

  • Spójne postacie

    Zapisz postać lub referencję raz, a potem wpisz @handle w dowolnym prompcie, by użyć jej w każdym modelu, który to obsługuje.

  • Duże dane wejściowe

    Przesyłaj obrazy, wideo i audio jako adresy URL lub data URL albo wgrywaj pliki do 100 MB przez podpisany upload.

  • 20 generacji naraz

    Każde konto może uruchomić 20 generacji jednocześnie, a limit można zwiększyć na potrzeby Twojego projektu. Odrzucone zapytania nigdy nie są płatne.

Zastosowania

Co programiści tworzą dzięki API wideo

  • Krótkie wideo i social media

    Twórz pionowe klipy na TikToka, Reels i Shorts z promptu lub zdjęcia produktu.

  • Animowanie statycznych obrazów

    Zamień pierwszą klatkę albo pierwszą i ostatnią klatkę w ruch dzięki modelom obrazu na wideo, takim jak Lemon i Kiwi.

  • Historie oparte na postaciach

    Zachowaj tę samą postać w kolejnych ujęciach dzięki modelom wideo z referencji, które obsługują postacie z @handle.

  • Wideo z dźwiękiem

    Plum i inne modele generują mowę, efekty dźwiękowe i tło dźwiękowe razem z obrazem oraz przyjmują referencje audio dla głosów.

  • Reklamy i prezentacje produktów

    Generuj wiele wariantów spotu i wybierz najlepszy, a dzięki idempotentnym zgłoszeniom nigdy nie zapłacisz podwójnie.

  • Edycja istniejących klipów

    Berry, Plum i Grok Video edytują przesłane przez Ciebie wideo źródłowe, a Lemon i MiniMax-H3 przyjmują także wideo referencyjne.

FAQ

Najczęściej zadawane pytania

Jakie jest najlepsze API do generowania wideo AI?
W Mage domyślnym modelem do wideo jest Cherry 2 Pro: obsługuje postacie, wiele obrazów referencyjnych, referencje audio, rozdzielczość od 480p do 4K i klipy do 30 sekund. Lemon wybierz, gdy chcesz kontrolować pierwszą i ostatnią klatkę, Plum – do klipów z generowanym dźwiękiem w rozdzielczości do 2K, a Cherry Mini lub Wan – do tańszych wersji roboczych.
Czy API wideo obsługuje zamianę obrazu na wideo?
Tak. Modele obrazu na wideo przyjmują pierwszą klatkę, a niektóre także ostatnią klatkę lub obrazy referencyjne, jako adresy URL, data URL lub przesłane pliki. Strona każdego modelu podaje jego dane wejściowe i informację, czy obraz jest wymagany.
Jak długie mogą być generowane wideo?
To zależy od modelu i rozdzielczości. Wiele modeli generuje klipy od 4 do 15 sekund, a Cherry 2 Pro i Cherry 2 osiągają 20, 25 i 30 sekund. Czasy trwania znajdziesz na stronie każdego modelu.
Ile trwa generowanie wideo?
To zależy od modelu, rozdzielczości i długości. API działa asynchronicznie: wyślij zgłoszenie, a potem sprawdzaj status_url z narastającym odstępem (backoff) albo pozwól klientowi MCP czekać za pomocą get_request.
Ile kosztuje Mage API?
Nie ma subskrypcji ani opłaty miesięcznej. Każda generacja jest płatna w Gems według ceny danego modelu, a 1000 Gems kosztuje 1 USD w standardowym pakiecie. Strona każdego modelu podaje cenę przy ustawieniach domyślnych, a każda odpowiedź zawiera dokładną kwotę opłaty. Za nieudaną generację zwracamy koszt, ale nie w przypadku zablokowania jej przez politykę treści Mage. Zapytanie, na które nie wystarcza Twojego salda, zostanie odrzucone, zanim cokolwiek zostanie pobrane.
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Nie. API działa wyłącznie na Gemach. Plany członkowskie i ich nielimitowane generowanie w aplikacji nie obejmują zapytań API. Konto musi mieć najpierw jedną udaną płatność – za dowolny pakiet Gemów lub plan; Gemy z bonusu za rejestrację działają tylko w aplikacji Mage.
Czy mogę używać wyników z API komercyjnie?
Tak. Treści tworzone w Mage, także przez API i serwer MCP, możesz wykorzystywać komercyjnie. Podanie autorstwa jest mile widziane, ale nie jest wymagane.
Jakie obowiązują limity zapytań?
Na jednym koncie może być jednocześnie w kolejce lub w trakcie 20 generowań. Zgłoszenie ponad limit zostanie odrzucone z kodem 429 i nic nie kosztuje. Napisz na [email protected], aby podnieść limit dla swojego zastosowania.
Czy mój agent AI może korzystać z API Mage?
Tak. Agenci mogą wywoływać REST API za pomocą klucza albo połączyć się z serwerem MCP Mage, który daje Claude, ChatGPT, Claude Code, Grok i Cursor szesnaście gotowych narzędzi do wyboru modelu, sprawdzenia ceny, generowania i pobrania wyniku. Zobacz serwer MCP.
Czy istnieje SDK do API Mage?
Tak. Oficjalne pakiety @mage-space/sdk na npm i mage-space na PyPI są open source i mają typy dla każdego modelu. Wysyłają zlecenia, czekają na wynik, bezpiecznie ponawiają próby i przesyłają za Ciebie pliki. Użytkownicy ComfyUI mogą zainstalować zestaw węzłów comfyui-mage. Zobacz SDK Mage.
Korzystam już z innego API do generowania. Co muszę zmienić?
Skieruj klienta na https://api.mage.space/v1, wysyłaj swój klucz Mage jako token Bearer i dopasuj pola do strony modelu: prompt, aspect_ratio, resolution, duration i model_id działają tak samo we wszystkich modelach Mage. Żądania są asynchroniczne, więc wyślij je, a potem odpytuj status_url.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

CharactersSpołeczność