Plum API

Bir bakışta

Plum API, Plum Max ve 1 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/plum/generate adresiyle çalıştırır. Varsayılan ayarlardaki bir istek 338 Gem (yaklaşık 0,338 $) tutar, abonelik gerekmez. Plum, kayıtlı karakterleri, referansları ve ses referanslarını istemde @handle ile alır.

• Video

  Çıktı

• 2

  Varyantlar

• 338

  Klip başına Gems, varsayılan

• $0.338

  Yaklaşı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 çıkışa kadar destekleyen tam özellikli video modeli: Plum ve daha hızlı olan Plum Max.

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.

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"

// 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);

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

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.

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.

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.

Kurallar

Plum API'nin uyguladığı kurallar

• İlk ve son kareler referans görsellerle birlikte kullanılamaz: yalnızca birini gönder.
• `plum-max` modelinde 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

SSS

Sık sorulan sorular

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

İlgili

• Yapay zeka video oluşturma API'si
• Plum API referansı
• Plum playground
• Tüm API modelleri
• Mage MCP sunucusu