API Plum

Sekilas info

API Plum menjalankan Plum Max dan 1 varian lainnya lewat Mage di POST https://api.mage.space/v1/plum/generate. Permintaan dengan pengaturan default berharga 338 Gems (sekitar $0,338), tanpa langganan. Plum menggunakan karakter, referensi, dan referensi audio tersimpan lewat @handle di prompt.

• Video

  Output

• 2

  Varian

• 338

  Gems per klip, default

• $0.338

  Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan Plum API

Video berfitur lengkap dengan audio di setiap klip dan output hingga 2K. Frame awal dan akhir, hingga 9 referensi atau Characters, serta Voices; durasi 4 hingga 15 detik.

Model video berfitur lengkap dari Mage dengan audio buatan AI di setiap klip dan output hingga 2K, tersedia sebagai Plum dan Plum Max yang lebih cepat.

Menerima first_image, last_image, image, additional_images, videos sebagai input.

Mulai cepat

Panggil Plum API

Setel MAGE_API_KEY, kirim ke /plum/generate, lalu pantau status_url sampai permintaan selesai.

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

Model

Nilai model_id Plum

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

Opsi

Parameter Plum

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

Input

Input media yang diterima Plum

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

Aturan

Aturan yang diterapkan Plum API

• Frame pertama dan terakhir tidak dapat digabungkan dengan gambar referensi: kirim salah satunya saja.
• Di `plum-max`, frame terakhir harus dipasangkan dengan frame pertama.
• Pengeditan video membutuhkan tepat satu video sumber berdurasi 2 hingga 15 detik, `duration` output, dan hingga 2 gambar referensi, termasuk karakter dan referensi yang disebutkan. Pengeditan ini tidak menerima frame, referensi audio, atau suara karakter: kirim `use_character_voices: false` untuk menyebut karakter yang memiliki suara.
• Di `plum-max`, video sumber ditagih dengan tarif per detik yang lebih tinggi daripada output, sehingga pada 768P biaya pengeditan di `plum-max` lebih mahal daripada di `plum`.

Model video lainnya

API pembuat video AI lainnya di Mage

FAQ

Pertanyaan yang sering diajukan

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

Terkait

• API pembuat video AI
• Referensi Plum API
• Playground Plum
• Semua model API
• Server MCP Mage