Mage API · Video modeli
Plum API
Her klipte ses, 2K'ya kadar
POST https://api.mage.space/v1/plum/generateBir bakışta
Plum API, Plum Fast ve diğer 2 varyantı Mage üzerinden POST https://api.mage.space/v1/plum/generate ile çalıştırır. Varsayılan ayarlardaki bir istek 173 Gems (yaklaşık 0,173 $) tutar, abonelik gerekmez. Plum, kayıtlı karakterleri, referansları ve ses referanslarını istemde @handle ile alır.
- VideoÇıktı
- 3Varyantlar
- 173Klip başına Gems, varsayılan
- $0.173Yaklaşık, USD
Genel bakış
Plum API ne yapar?
Her klipte ses bulunan ve 2K çıkışa kadar destekleyen tam özellikli video. Başlangıç ve bitiş kareleri, 9 adede kadar referans veya Characters ve Voices; 4 ila 15 saniye.
Mage'in her klipte üretilmiş ses sunan ve 2K'ya kadar çıktı veren tam özellikli video modeli: Plum, daha hızlı Plum Max ve en hızlı, en düşük maliyetli Plum Fast olarak sunuluyor.
Girdi olarak first_image, last_image, image, additional_images, videos kabul eder.
Hızlı başlangıç
Plum API'yi çağırma
MAGE_API_KEY'i ayarla, /plum/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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-fast"
}' | 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-fast',
});
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-fast",
})
print(request["result"]["url"])Modeller
Plum model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Evet |
Seçenekler
Plum parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| 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 |
Girdiler
Plum'ın kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| first_image | İlk kare görseli. |
| last_image | Son kare görseli. |
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
| videos | Kaynak videolar. |
Kurallar
Plum API'nin uyguladığı kurallar
- İlk ve son kareler referans görsellerle birlikte kullanılamaz: yalnızca birini gönder.
- `plum-max` ve `plum-fast` modellerinde son kare, bir ilk kareyle birlikte kullanılmalıdır.
- Video düzenleme için 2 ila 15 saniye uzunluğunda tam olarak bir kaynak video, bir çıktı `duration` değeri ve bahsedilen karakterler ile referanslar dahil en fazla 2 referans görsel gerekir. Kare, ses referansı veya karakter sesi kabul etmez: sesi olan bir karakterden bahsetmek için `use_character_voices: false` gönder.
- `plum-max` modelinde kaynak video, çıktıdan saniye başına daha yüksek bir oranla ücretlendirilir; bu yüzden 768P çözünürlükte bir düzenleme `plum-max` üzerinde `plum` modelinden daha pahalıdır.
Diğer video modelleri
Mage'deki diğer yapay zeka video oluşturma API'leri
Raspberry API
İlk kareden canlanan karakterler
Seedance API
Seedance, sıkı filtreli
Wan 3.0 API
Wan 3.0, sıkı filtreli
Wan Video v2.2 API
Lightning varyantlı açık ağırlıklı video modeli
Berry API
Referanslarına sadık kalan video
Blueberry API
İlk ve son kareyi sabitle
SSS
Sık sorulan sorular
Plum API ne kadar?
Plum API uç noktası nedir?
Hangi Plum modellerini çağırabilirim?
Plum referans görselleri veya karakterleri destekliyor mu?
Plum'ı Claude veya ChatGPT üzerinden kullanabilir miyim?
Plum sonuçları ne kadar süre saklanır?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.