Treci la conținut
PlaygroundDocumentațieObține cheia API

Mage API · Generare video

API-ul de generare video cu AI, pornind de la text sau imagini

Din text în video, din imagine în video, de la primul la ultimul cadru și din referințe în video, cu 12 modele, în frunte cu Cherry 2 Pro, modelul principal Mage, cu audio la multe clipuri.

Obține o cheie APICitește documentația API
POST https://api.mage.space/v1/{model}/generate

Pe scurt

API-ul Mage de generare video este un API REST la https://api.mage.space/v1 care rulează 12 modele de text în video și de imagine în video, printre care Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video și Wan. Trimiți un prompt și, opțional, cadre sau referințe, verifici periodic starea cererii și descarci un MP4. Fiecare clip se plătește în Gems, în funcție de model, rezoluție și durată.

  • 12modele video
  • $0.02Cea mai ieftină opțiune implicită, per clip
  • 20Generări simultane
  • $0Taxă lunară

Modele

Toate modelele video din Mage API

Prețurile sunt per generare, în Gems. 1.000 de Gems costă $1 în pachetul standard, iar pachetele mai mari adaugă Gems bonus. Prețul depinde de model, rezoluție și durată; se afișează prețul pentru setările implicite, iar fiecare răspuns indică suma exactă în billing.gems_charged. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.

ModelIdeal pentruValori model_idPreț implicit
BerryVideo fidel referințelor taleberry, berry-2189 Gems ($0.189)
BlueberryFixează primul și ultimul cadrublueberry, blueberry-v2360 Gems ($0.36)
CherryFamilia noastră video principalăcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine, în mișcaregrok-imagine-video375 Gems ($0.375)
KiwiVideo de zi cu zi, fără configurarekiwi270 Gems ($0.27)
LemonToate funcțiile video, la un preț mai prietenoslemon245 Gems ($0.245)
LTX VideoVideo open-weights rapid pentru iterațiiltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime în mișcare, cu audio opționalmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Video open rapid, cu sunet stereominimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumSunet la fiecare clip, până la 2Kplum, plum-max338 Gems ($0.338)
RaspberryPersonaje aduse la viață dintr-un prim cadruraspberry360 Gems ($0.36)
Wan Video v2.2Video open-weights cu o variantă Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Pornire rapidă

Generează un video cu Berry 2

Setează MAGE_API_KEY, trimite cererea și verifică periodic până se termină. Înlocuiește berry din URL cu oricare dintre modelele de mai sus.

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

Cum funcționează

De la cheia API la media gata în trei apeluri

Toate modelele folosesc aceeași schemă de autentificare, același ciclu de viață asincron al cererilor și aceleași nume de câmpuri.

  1. Creează o cheie API

    Autentifică-te în Mage, deschide API → API Keys și creează o cheie. Începe cu mage_sk_ și este afișată o singură dată. Un cont poate avea 10 chei active.

  2. Trimite o generare

    Trimite cu POST un corp JSON la https://api.mage.space/v1/{model}/generate, cu un antet Authorization: Bearer. Răspunsul vine imediat, cu un request_id, un status și un status_url. Trimite un antet Idempotency-Key, ca o reîncercare să nu fie plătită de două ori.

  3. Interoghează și descarcă

    Interoghează status_url până când statusul devine completed, failed sau cancelled. O cerere finalizată conține result.url cu fișierul de imagine, video sau audio, păstrat 30 de zile.

Creat pentru producție

Ce primește fiecare cerere către API-ul Mage

  • O cheie, toate modelele

    28 de modele de imagine, video și audio într-un singur API REST și cu un singur sold de Gems. Schimbi modelul modificând calea din URL.

  • Plătești per generare

    Fără abonament și fără cheltuială minimă. Cumperi Gems, iar fiecare cerere costă prețul afișat. O generare eșuată este rambursată, cu excepția cazului în care a fost blocată de politica de conținut Mage.

  • Reîncercări în siguranță

    Cheile de idempotență fac ca o retrimitere să returneze cererea inițială, fără o nouă taxare.

  • Personaje consecvente

    Salvează o dată un personaj sau o referință, apoi scrie @handle în orice prompt ca să le folosești cu fiecare model care le acceptă.

  • Fișiere de intrare mari

    Trimite imagini, video și audio ca URL-uri sau URL-uri de date, sau încarcă fișiere de până la 100 MB printr-o încărcare semnată.

  • 20 de generări simultane

    Fiecare cont poate rula 20 de generări în același timp, iar limita poate fi mărită pentru cazul tău de utilizare. Cererile refuzate nu sunt taxate niciodată.

Cazuri de utilizare

Ce construiesc dezvoltatorii cu API-ul video

  • Video scurt și pentru social media

    Creează clipuri verticale pentru TikTok, Reels și Shorts dintr-un prompt sau dintr-o imagine de produs.

  • Animează imagini statice

    Transformă un prim cadru, sau un prim și un ultim cadru, în mișcare, cu modele de imagine în video precum Lemon și Kiwi.

  • Povești construite în jurul personajelor

    Păstrează același personaj în toate cadrele cu modele de referințe în video care acceptă personaje prin @handle.

  • Video cu sunet

    Plum și alte modele generează voce, efecte sonore și ambianță odată cu imaginea și acceptă referințe audio pentru voci.

  • Reclame și demonstrații de produs

    Generează multe variante ale unei reclame și alege-o pe cea câștigătoare, cu trimiteri idempotente care nu te taxează niciodată de două ori.

  • Editează clipuri existente

    Berry, Plum și Grok Video editează un video sursă pe care îl trimiți; Lemon și MiniMax-H3 acceptă și videoclipuri de referință.

Întrebări frecvente

Întrebări frecvente

Care este cel mai bun API de generare video cu AI?
Pe Mage, Cherry 2 Pro este alegerea implicită pentru video: acceptă personaje, multe imagini de referință, referințe audio, ieșire de la 480p la 1080p și clipuri de până la 30 de secunde. Lemon este alegerea pentru controlul primului și ultimului cadru, Plum pentru clipuri cu sunet generat până la 2K, iar Cherry Mini sau Wan pentru schițe mai ieftine.
API-ul video acceptă imagine în video?
Da. Modelele de imagine în video primesc un prim cadru, iar unele acceptă și un ultim cadru sau imagini de referință, ca URL-uri, URL-uri de date sau încărcări. Pagina fiecărui model listează intrările acceptate și dacă o imagine este obligatorie.
Cât de lungi pot fi videoclipurile generate?
Depinde de model și de rezoluție. Multe modele generează între 4 și 15 secunde, iar Cherry 2 Pro ajunge la 20, 25 și 30 de secunde. Pagina fiecărui model listează duratele disponibile.
Cât durează generarea unui video?
Depinde de model, rezoluție și durată. API-ul este asincron: trimiți cererea, apoi verifici periodic status_url cu backoff sau lași clientul tău MCP să aștepte cu get_request.
Cât costă API-ul Mage?
Nu există abonament sau taxă lunară. Fiecare generare se plătește în Gems, la prețul afișat al modelului, iar 1.000 de Gems costă 1 $ la pachetul standard. Pagina fiecărui model afișează prețul cu setările implicite, iar fiecare răspuns indică taxarea exactă. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este. O cerere pe care soldul tău nu o poate acoperi este refuzată înainte de orice taxare.
Am nevoie de un abonament Mage ca să folosesc API-ul?
Nu. API-ul funcționează exclusiv cu Gems. Planurile de abonament și generarea nelimitată din aplicație nu se aplică cererilor API, deci orice cont Mage cu Gems îl poate apela.
Pot folosi rezultatele din API în scop comercial?
Da. Conținutul creat cu Mage, inclusiv prin API și serverul MCP, poate fi folosit în scop comercial. Menționarea sursei este apreciată, dar nu este obligatorie.
Care sunt limitele de utilizare?
Un cont poate avea simultan 20 de generări în coadă sau în curs. O trimitere peste această limită este refuzată cu 429 și nu costă nimic. Scrie la [email protected] pentru a crește limita pentru cazul tău de utilizare.
Poate agentul meu AI să folosească API-ul Mage?
Da. Agenții pot apela API-ul REST cu o cheie sau se pot conecta la serverul MCP Mage, care oferă Claude, ChatGPT, Claude Code, Grok și Cursor șaisprezece instrumente gata făcute pentru alegerea unui model, afișarea prețului, generare și preluarea rezultatului. Vezi serverul MCP.
Există un SDK pentru API-ul Mage?
Da. Pachetul oficial @mage-space/sdk de pe npm și mage-space de pe PyPI sunt open source și tipizate pentru fiecare model. Trimit cererea, așteaptă rezultatul, reîncearcă în siguranță și încarcă fișiere în locul tău. Utilizatorii ComfyUI pot instala pachetul de noduri comfyui-mage. Vezi SDK-urile Mage.
Folosesc deja alt API de generare. Ce trebuie să schimb?
Îndreaptă clientul către https://api.mage.space/v1, trimite cheia Mage ca token Bearer și asociază-ți câmpurile cu pagina modelului: prompt, aspect_ratio, resolution, duration și model_id funcționează la fel pentru toate modelele Mage. Cererile sunt asincrone, așa că trimite cererea și apoi interoghează periodic status_url.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.

Obține o cheie APICitește documentația API