Mage API · Model pro video
Plum API
Zvuk v každém klipu, až do 2K
POST https://api.mage.space/v1/plum/generateStruč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_id | Název | Výchozí |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | Ano |
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.
| Pole | Hodnoty |
|---|---|
| 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 |
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.
| Pole | Role |
|---|---|
| first_image | Obrázek prvního snímku. |
| last_image | Obrázek posledního snímku. |
| image | Referenční obrázek. |
| additional_images | Další referenční obrázky. |
| videos | Zdrojová 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
Raspberry API
Postavy oživené z prvního snímku
Wan Video v2.2 API
Video s otevřenými váhami a variantou Lightning
Berry API
Video věrné tvým referencím
Blueberry API
Zafixuj první a poslední snímek
Cherry API
Naše vlajková řada video modelů
Grok Video API
Grok Imagine v pohybu
Časté dotazy
Často kladené otázky
Kolik stojí Plum API?
Jaký je endpoint Plum API?
Které modely Plum můžu volat?
Podporuje Plum referenční obrázky nebo postavy?
Můžu používat Plum z Claude nebo ChatGPT?
Jak dlouho se výsledky Plum uchovávají?
Začni tvořit s Mage
Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.