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}/generateW 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.
| Model | Najlepszy do | Wartości model_id | Cena domyślna |
|---|---|---|---|
| Berry | Wideo wierne Twoim referencjom | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Ustal pierwszą i ostatnią klatkę | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Nasza flagowa rodzina modeli wideo | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine w ruchu | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Wideo na co dzień, bez konfiguracji | kiwi | 270 Gems ($0.27) |
| Lemon | Wszystkie funkcje wideo w przystępniejszej cenie | lemon | 245 Gems ($0.245) |
| LTX Video | Szybkie wideo z otwartymi wagami do iteracji | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Zmień obsadę dowolnego wideo, zachowując jego ruch | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime w ruchu, opcjonalnie z dźwiękiem | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Szybkie otwarte wideo z dźwiękiem stereo | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Dźwięk w każdym klipie, do 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Postacie ożywione z pierwszej klatki | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance z rygorystycznym filtrem | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, z rygorystycznym filtrem | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Wideo z otwartymi wagami z wariantem Lightning | wan22-video, wan22-video-lightning | 40 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.
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.
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.
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?
Czy API wideo obsługuje zamianę obrazu na wideo?
Jak długie mogą być generowane wideo?
Ile trwa generowanie wideo?
Ile kosztuje Mage API?
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Czy mogę używać wyników z API komercyjnie?
Jakie obowiązują limity zapytań?
Czy mój agent AI może korzystać z API Mage?
Czy istnieje SDK do API Mage?
Korzystam już z innego API do generowania. Co muszę zmienić?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.