API Mage · Model video
API Plum
Sunet în fiecare clip, până la 2K
POST https://api.mage.space/v1/plum/generatePe 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_id | Nume | Implicit |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | Da |
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âmp | Valori |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 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âmp | Rol |
|---|---|
| first_image | Imaginea primului cadru. |
| last_image | Imaginea pentru ultimul cadru. |
| image | Imaginea de referință. |
| additional_images | Imagini de referință suplimentare. |
| videos | Videoclipurile 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
API Raspberry
Personaje aduse la viață dintr-un prim cadru
Wan Video v2.2 API
Video open-weights cu variantă Lightning
Berry API
Video fidel referințelor tale
Blueberry API
Fixează primul și ultimul cadru
API Cherry
Familia noastră principală de modele video
Grok Video API
Grok Imagine, în mișcare
Întrebări frecvente
Întrebări frecvente
Cât costă API-ul Plum?
Care este endpoint-ul API-ului Plum?
Ce modele Plum pot apela?
Acceptă Plum imagini de referință sau personaje?
Pot folosi Plum din Claude sau ChatGPT?
Cât timp sunt păstrate rezultatele Plum?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.