Přeskočit na obsah

Mage API · Model pro video

Plum API

Zvuk v každém klipu, až do 2K

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

Stručně

Plum API spouští Plum Max a 1 další variantu přes Mage na POST https://api.mage.space/v1/plum/generate. Požadavek ve výchozím nastavení stojí 338 Gems (zhruba 0,338 $), bez předplatného. Plum v promptu přijímá uložené postavy, reference a zvukové reference přes @handle.

  • VideoVýstup
  • 2Varianty
  • 338Gems za klip, výchozí
  • $0.338Přibližně v USD

Přehled

Co umí Plum API

Plnohodnotné video se zvukem v každém klipu a výstupem až do 2K. Úvodní a koncový snímek, až 9 referencí nebo Characters a Voices; 4 až 15 sekund.

Plnohodnotný videomodel Mage s generovaným zvukem v každém klipu a výstupem až do 2K, ve variantách Plum a rychlejší Plum Max.

Jako vstup přijímá first_image, last_image, image, additional_images, videos.

Rychlý start

Volání Plum API

Nastav MAGE_API_KEY, odešli požadavek na /plum/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Plum

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
plumPlum
plum-maxPlum MaxAno

Možnosti

Parametry Plum

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
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

Vstupy

Mediální vstupy, které Plum přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
first_imageObrázek prvního snímku.
last_imageObrázek posledního snímku.
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.
videosZdrojová videa.

Pravidla

Co Plum API vynucuje

  • První a poslední snímek nelze kombinovat s referenčními obrázky: pošli jedno nebo druhé.
  • U `plum-max` musí být poslední snímek spárován s prvním snímkem.
  • Úprava videa vyžaduje přesně jedno zdrojové video o délce 2 až 15 sekund, výstupní `duration` a nejvýše 2 referenční obrázky, včetně zmíněných postav a referencí. Nepřijímá snímky, zvukové reference ani hlasy postav: pokud chceš zmínit postavu s hlasem, pošli `use_character_voices: false`.
  • U `plum-max` se zdrojové video účtuje vyšší sazbou za sekundu než výstup, takže při 768P stojí úprava na `plum-max` víc než na `plum`.

Další video modely

Další API pro generování videa na Mage

  • Video · od 360 Gems

    Raspberry API

    Postavy oživené z prvního snímku

  • Video · od 40 Gems

    Wan Video v2.2 API

    Video s otevřenými váhami a variantou Lightning

  • Video · od 189 Gems

    Berry API

    Video věrné tvým referencím

  • Video · od 360 Gems

    Blueberry API

    Zafixuj první a poslední snímek

  • Video · od 618 Gems

    Cherry API

    Naše vlajková řada video modelů

  • Video · od 375 Gems

    Grok Video API

    Grok Imagine v pohybu

Časté dotazy

Často kladené otázky

Kolik stojí Plum API?
Požadavek na Plum ve výchozím nastavení (Plum Max) stojí 338 Gems, zhruba 0,338 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku uvádí odpověď. Neúspěšná generace se vrací; generace zablokovaná pravidly obsahu Mage ne.
Jaký je endpoint Plum API?
POST https://api.mage.space/v1/plum/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na který se dotazuješ na výsledek.
Které modely Plum můžu volat?
plum (Plum), plum-max (Plum Max). Výchozí je Plum Max.
Podporuje Plum referenční obrázky nebo postavy?
Plum přijímá first_image, last_image, image, additional_images, videos. Plum v promptu přijímá uložené postavy, reference a zvukové reference přes @handle.
Můžu používat Plum z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Plum jménem. Tvůj asistent si přečte jeho možnosti přes get_model a před generováním uvede cenu.
Jak dlouho se výsledky Plum uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.