İçeriğe geç

Mage API · Video modeli

Plum API

Her klipte ses, 2K'ya kadar

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

Bir 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_idAdVarsayılan
plumPlum
plum-maxPlum Max
plum-fastPlum FastEvet

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.

AlanDeğerler
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

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.

AlanRol
first_imageİlk kare görseli.
last_imageSon kare görseli.
imageReferans görsel.
additional_imagesEk referans görseller.
videosKaynak 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

  • Video · 360 Gems'ten başlayan fiyatlarla

    Raspberry API

    İlk kareden canlanan karakterler

  • Video · 618 Gem'den başlayan fiyatlarla

    Seedance API

    Seedance, sıkı filtreli

  • Video · 245 Gem'den başlayan fiyatlarla

    Wan 3.0 API

    Wan 3.0, sıkı filtreli

  • Video · 40 Gems'ten başlayarak

    Wan Video v2.2 API

    Lightning varyantlı açık ağırlıklı video modeli

  • Video · 189 Gems'ten başlayarak

    Berry API

    Referanslarına sadık kalan video

  • Video · 360 Gems'ten başlayan fiyatlarla

    Blueberry API

    İlk ve son kareyi sabitle

SSS

Sık sorulan sorular

Plum API ne kadar?
Varsayılan ayarlardaki (Plum Fast) bir Plum isteği 173 Gems, yani yaklaşık 0,173 $ tutar. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta belirtilir. Başarısız olan üretimlerin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenenlerin ücreti iade edilmez.
Plum API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/plum/generate. Yanıt, sonucu sorgulayabileceğin bir status_url içerir.
Hangi Plum modellerini çağırabilirim?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Varsayılan model Plum Fast'tir.
Plum referans görselleri veya karakterleri destekliyor mu?
Plum; first_image, last_image, image, additional_images ve videos girdilerini kabul eder. Plum, kayıtlı karakterleri, referansları ve ses referanslarını istemde @handle ile alır.
Plum'ı Claude veya ChatGPT üzerinden kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Plum'ı adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
Plum sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.

Mage ile geliştirmeye başla

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

CharactersTopluluk