Ugrás a tartalomhoz

Mage API · Videómodell

Plum API

Hang minden klipen, akár 2K-ig

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

Dióhéjban

A Plum API a Plum Max modellt és még 1 másik változatot futtat a Mage-en keresztül a POST https://api.mage.space/v1/plum/generate végponton. Az alapbeállításokkal egy kérés 338 Gembe kerül (kb. 0,338 $), előfizetés nélkül. A Plum a promptban @handle-lel megadott mentett karaktereket, referenciákat és hangreferenciákat fogad.

  • VideóKimenet
  • 2Variánsok
  • 338Gems klipenként, alapértelmezett
  • $0.338Körülbelül, USD-ben

Áttekintés

Mit tud a Plum API

Teljes funkcionalitású videó hanggal minden klipben, akár 2K kimenettel. Kezdő- és zárókép, legfeljebb 9 referencia vagy Characters, valamint Voices; 4–15 másodperc.

A Mage teljes funkcionalitású videómodellje, minden klipben generált hanggal és akár 2K kimenettel, Plum néven és a gyorsabb Plum Max változatként.

A first_image, last_image, image, additional_images, videos bemeneteket fogadja el.

Gyors kezdés

A Plum API meghívása

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /plum/generate végpontra, és kérdezd le a status_url címet, amíg a kérés be nem fejeződik.

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

Modellek

Plum model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
plumPlum
plum-maxPlum MaxIgen

Beállítások

Plum paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
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

Bemenetek

A Plum által elfogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
first_imageAz első képkocka képe.
last_imageAz utolsó képkocka képe.
imageA referenciakép.
additional_imagesTovábbi referenciaképek.
videosA forrásvideók.

Szabályok

Milyen szabályokat érvényesít a Plum API

  • Az első és az utolsó kocka nem kombinálható referenciaképekkel: csak az egyik fajtát küldd.
  • A `plum-max` modellen az utolsó képkockát csak első képkockával együtt lehet megadni.
  • A videószerkesztéshez pontosan egy 2–15 másodperces forrásvideó, egy kimeneti `duration` érték és legfeljebb 2 referenciakép kell, az említett karaktereket és referenciákat is beleszámítva. Nem fogad képkockákat, hangreferenciákat vagy karakterhangokat: küldj `use_character_voices: false` értéket, ha olyan karaktert említesz, akinek van hangja.
  • A `plum-max` modellen a forrásvideót másodpercenként magasabb díjjal számoljuk, mint a kimenetet, ezért 768P-nél a szerkesztés a `plum-max` modellen többe kerül, mint a `plum` modellen.

További videómodellek

További videógeneráló API-k a Mage-en

  • Videó · 360 Gemtől

    Raspberry API

    Karakterek életre keltése egy első képkockából

  • Videó · 40 Gemtől

    Wan Video v2.2 API

    Nyílt súlyozású videómodell Lightning változattal

  • Videó · 189 Gemtől

    Berry API

    Videó, amely hű marad a referenciáidhoz

  • Videó · 360 Gemtől

    Blueberry API

    Rögzítsd az első és az utolsó képkockát

  • Videó · 618 Gemtől

    Cherry API

    Zászlóshajó videómodellcsaládunk

  • Videó · 375 Gemtől

    Grok Video API

    A Grok Imagine mozgásban

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Plum API?
Egy Plum kérés az alapbeállításokkal (Plum Max) 338 Gembe kerül, ez kb. 0,338 $. Más felbontások, hosszak és változatok módosítják az árat; a válasz megadja a pontos díjat. A sikertelen generálás árát visszatérítjük; azt viszont nem, amelyet a Mage tartalmi szabályzata blokkol.
Mi a Plum API végpontja?
POST https://api.mage.space/v1/plum/generate egy Authorization: Bearer fejléccel, amely a Mage API-kulcsodat tartalmazza. A válasz tartalmaz egy status_url címet, amelyet lekérdezhetsz az eredményért.
Mely Plum modelleket hívhatom meg?
plum (Plum), plum-max (Plum Max). Az alapértelmezett a Plum Max.
Támogatja a Plum a referenciaképeket vagy a karaktereket?
A Plum elfogadja a first_image, last_image, image, additional_images, videos paramétereket. A Plum a promptban @handle-lel megadott mentett karaktereket, referenciákat és hangreferenciákat fogad.
Használhatom a Plumot Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP-szervert a Claude-hoz, a ChatGPT-hez, a Claude Code-hoz, a Grokhoz vagy a Cursorhoz, és kérd név szerint a Plumot. Az asszisztensed a get_model segítségével olvassa ki a lehetőségeit, és generálás előtt megmondja az árat.
Meddig őrződnek meg a Plum eredményei?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.