Mage API · Model video
API Plum
Suara di setiap klip, hingga 2K
POST https://api.mage.space/v1/plum/generateSekilas 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_id | Nama | Default |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Ya |
Opsi
Parameter Plum
Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.
| Kolom | Nilai |
|---|---|
| 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 |
Input
Input media yang diterima Plum
Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.
| Kolom | Peran |
|---|---|
| first_image | Gambar frame pertama. |
| last_image | Gambar frame terakhir. |
| image | Gambar referensi. |
| additional_images | Gambar referensi tambahan. |
| videos | Video 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
Raspberry API
Karakter yang hidup dari frame pertama
API Seedance
Seedance, dengan filter ketat
API Wan 3.0
Wan 3.0, dengan filter ketat
Wan Video v2.2 API
Video open-weights dengan varian Lightning
Berry API
Video yang tetap setia pada referensimu
Blueberry API
Tentukan frame pertama dan terakhir
FAQ
Pertanyaan yang sering diajukan
Berapa biaya Plum API?
Apa endpoint Plum API?
Model Plum apa saja yang bisa kupanggil?
Apakah Plum mendukung gambar referensi atau karakter?
Bisakah aku memakai Plum dari Claude atau ChatGPT?
Berapa lama hasil Plum disimpan?
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.