Langsung ke konten

Mage API · Model video

API Plum

Suara di setiap klip, hingga 2K

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

Sekilas info

API Plum menjalankan Plum Fast dan 2 varian lainnya lewat Mage di POST https://api.mage.space/v1/plum/generate. Satu permintaan dengan pengaturan default berharga 173 Gems (sekitar $0,173), tanpa langganan. Plum menerima karakter, referensi, dan referensi audio yang tersimpan lewat @handle di prompt.

  • VideoOutput
  • 3Varian
  • 173Gems per klip, default
  • $0.173Perkiraan, 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 Mage dengan fitur lengkap, dengan audio yang dihasilkan di setiap klip dan output hingga 2K, tersedia sebagai Plum, Plum Max yang lebih cepat, dan Plum Fast yang tercepat dan paling hemat.

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.

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

Model

Nilai model_id Plum

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

model_idNamaDefault
plumPlum
plum-maxPlum Max
plum-fastPlum FastYa

Opsi

Parameter Plum

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

KolomNilai
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

Input

Input media yang diterima Plum

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

KolomPeran
first_imageGambar frame pertama.
last_imageGambar frame terakhir.
imageGambar referensi.
additional_imagesGambar referensi tambahan.
videosVideo sumber.

Aturan

Aturan yang diterapkan Plum API

  • Frame pertama dan terakhir tidak dapat digabungkan dengan gambar referensi: kirim salah satunya saja.
  • Pada `plum-max` dan `plum-fast`, 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

  • Video · mulai dari 360 Gems

    Raspberry API

    Karakter yang hidup dari frame pertama

  • Video · mulai dari 618 Gems

    API Seedance

    Seedance, dengan filter ketat

  • Video · mulai dari 245 Gems

    API Wan 3.0

    Wan 3.0, dengan filter ketat

  • Video · mulai dari 40 Gems

    Wan Video v2.2 API

    Video open-weights dengan varian Lightning

  • Video · mulai dari 189 Gems

    Berry API

    Video yang tetap setia pada referensimu

  • Video · mulai dari 360 Gems

    Blueberry API

    Tentukan frame pertama dan terakhir

FAQ

Pertanyaan yang sering diajukan

Berapa biaya Plum API?
Satu permintaan Plum dengan pengaturan default (Plum Fast) berharga 173 Gems, sekitar $0,173. Resolusi, durasi, dan varian lain akan mengubah harganya; biaya pastinya tercantum di respons. Generasi yang gagal dikembalikan Gems-nya, sedangkan yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint Plum API?
POST https://api.mage.space/v1/plum/generate dengan header Authorization: Bearer yang berisi API key Mage kamu. Respons menyertakan status_url untuk memantau hasilnya.
Model Plum apa saja yang bisa kupanggil?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Defaultnya adalah Plum Fast.
Apakah Plum mendukung gambar referensi atau karakter?
Plum menerima first_image, last_image, image, additional_images, videos. Plum menggunakan karakter, referensi, dan referensi audio yang tersimpan lewat @handle di prompt.
Bisakah aku memakai Plum dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Plum dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat.
Berapa lama hasil Plum disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

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

CharactersKomunitas