Treci la conținut

API Mage · Model video

API Plum

Sunet în fiecare clip, până la 2K

POST https://api.mage.space/v1/plum/generate

Pe scurt

API-ul Plum rulează Plum Max și încă o variantă prin Mage la POST https://api.mage.space/v1/plum/generate. O cerere cu setările implicite costă 338 Gems (aproximativ 0,338 $), fără abonament. Plum acceptă personaje salvate, referințe și referințe audio prin @handle în prompt.

  • VideoRezultat
  • 2Variante
  • 338Gems per clip, implicit
  • $0.338Aproximativ, în USD

Prezentare generală

Ce face API-ul Plum

Video cu toate funcțiile, cu audio pe fiecare clip și rezoluție de până la 2K. Cadre de început și de final, până la 9 referințe sau Characters, plus Voices; între 4 și 15 secunde.

Modelul video complet al Mage, cu audio generat pe fiecare clip și rezoluție de până la 2K, disponibil ca Plum și ca Plum Max, mai rapid.

Acceptă first_image, last_image, image, additional_images, videos ca date de intrare.

Pornire rapidă

Apelează API-ul Plum

Setează MAGE_API_KEY, trimite cererea la /plum/generate și interoghează status_url până când cererea se finalizează.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "5",
  "model_id": "plum-max"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-max',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

print(request["result"]["url"])

Modele

Valori model_id pentru Plum

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
plumPlum
plum-maxPlum MaxDa

Opțiuni

Parametrii Plum

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Intrări

Fișiere media acceptate de Plum

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
first_imageImaginea primului cadru.
last_imageImaginea pentru ultimul cadru.
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.
videosVideoclipurile sursă.

Reguli

Ce impune API-ul Plum

  • Cadrele de început și de final nu pot fi combinate cu imaginile de referință: trimite doar unul dintre cele două tipuri.
  • Pe `plum-max`, ultimul cadru trebuie asociat cu un prim cadru.
  • Editarea video necesită exact un videoclip sursă de 2 până la 15 secunde, o `duration` de ieșire și cel mult 2 imagini de referință, inclusiv personajele și referințele menționate. Nu acceptă cadre, referințe audio sau voci de personaje: trimite `use_character_voices: false` pentru a menționa un personaj care are voce.
  • Pe `plum-max`, videoclipul sursă se taxează cu un tarif mai mare pe secundă decât cel de ieșire, deci la 768P o editare costă mai mult pe `plum-max` decât pe `plum`.

Mai multe modele video

Alte API-uri de generare video pe Mage

  • Video · de la 360 Gems

    API Raspberry

    Personaje aduse la viață dintr-un prim cadru

  • Video · de la 40 Gems

    Wan Video v2.2 API

    Video open-weights cu variantă Lightning

  • Video · de la 189 Gems

    Berry API

    Video fidel referințelor tale

  • Video · de la 360 Gems

    Blueberry API

    Fixează primul și ultimul cadru

  • Video · de la 618 Gems

    API Cherry

    Familia noastră principală de modele video

  • Video · de la 375 Gems

    Grok Video API

    Grok Imagine, în mișcare

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Plum?
O cerere Plum cu setările implicite (Plum Max) costă 338 Gems, aproximativ 0,338 $. Alte rezoluții, durate și variante schimbă prețul; răspunsul indică suma exactă taxată. O generare eșuată este rambursată; una blocată de politica de conținut a Mage nu este.
Care este endpoint-ul API-ului Plum?
POST https://api.mage.space/v1/plum/generate, cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
Ce modele Plum pot apela?
plum (Plum), plum-max (Plum Max). Implicit este Plum Max.
Acceptă Plum imagini de referință sau personaje?
Plum acceptă first_image, last_image, image, additional_images, videos. Plum folosește personaje salvate, referințe și referințe audio prin @handle în prompt.
Pot folosi Plum din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Plum pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte de a genera.
Cât timp sunt păstrate rezultatele Plum?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

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