Mage API · Pembuatan video
API pembuat video AI dari teks atau gambar
Teks ke video, gambar ke video, frame awal dan akhir, serta referensi ke video dari 15 model, dipimpin Cherry 2 Pro andalan Mage, dengan audio di banyak klip.
POST https://api.mage.space/v1/{model}/generateSekilas info
API pembuat video Mage adalah REST API di https://api.mage.space/v1 yang menjalankan 15 model teks ke video dan gambar ke video, termasuk Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video, dan Wan. Kirim prompt beserta frame atau referensi opsional, pantau permintaannya, lalu unduh MP4. Setiap klip dibayar dengan Gems sesuai model, resolusi, dan durasi.
- 15model video
- $0.02Default termurah, per klip
- 20Proses generate bersamaan
- $0Biaya bulanan
Model
Semua model video di Mage API
Harga dihitung per proses generate, dalam Gems. 1.000 Gems seharga $1 pada paket standar, dan paket yang lebih besar memberi bonus Gems. Harga bergantung pada model, resolusi, dan durasi; yang ditampilkan adalah harga dengan pengaturan default, dan setiap respons mencantumkan biaya pastinya di billing.gems_charged. Proses generate yang gagal akan dikembalikan Gems-nya; yang diblokir oleh kebijakan konten Mage tidak.
| Model | Terbaik untuk | Nilai model_id | Harga default |
|---|---|---|---|
| Berry | Video yang setia pada referensimu | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Tentukan frame awal dan akhir | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Keluarga video andalan kami | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, dalam gerak | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video sehari-hari, tanpa pengaturan | kiwi | 270 Gems ($0.27) |
| Lemon | Semua fitur video, dengan harga lebih bersahabat | lemon | 245 Gems ($0.245) |
| LTX Video | Video open-weights yang cepat untuk iterasi | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Ganti subjek video apa pun, gerakannya tetap utuh | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime dalam gerak, dengan audio opsional | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video open cepat dengan suara stereo | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Suara di setiap klip, hingga 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Karakter hidup dari frame pertama | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, dengan filter ketat | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, dengan filter ketat | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Video open-weights dengan varian Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Mulai cepat
Buat video dengan Berry 2
Atur MAGE_API_KEY, kirim permintaannya, lalu lakukan polling sampai selesai. Ganti berry di URL dengan model mana pun di atas.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])Cara kerjanya
Dari kunci API sampai media jadi dalam tiga panggilan
Semua model memakai satu skema autentikasi, satu siklus permintaan asinkron, dan nama field yang sama.
Buat kunci API
Masuk ke Mage, buka API → API Keys, lalu buat kunci. Kunci diawali mage_sk_ dan hanya ditampilkan sekali. Satu akun bisa memiliki 10 kunci aktif.
Kirim permintaan generasi
Kirim POST dengan body JSON ke https://api.mage.space/v1/{model}/generate beserta header Authorization: Bearer. Respons langsung kembali dengan request_id, status, dan status_url. Sertakan header Idempotency-Key agar percobaan ulang tidak pernah membayar dua kali.
Cek status dan unduh
Lakukan polling ke status_url sampai statusnya completed, failed, atau cancelled. Permintaan yang selesai membawa result.url berisi file gambar, video, atau audio, yang disimpan selama 30 hari.
Siap untuk produksi
Yang didapat setiap permintaan Mage API
Satu kunci, semua model
37 model gambar, video, dan audio dalam satu REST API dan satu saldo Gems. Ganti model cukup dengan mengubah path URL.
Bayar per generasi
Tanpa langganan dan tanpa minimum pengeluaran. Kamu membeli Gems, lalu setiap permintaan dikenai harga sesuai daftar. Generasi yang gagal akan dikembalikan biayanya, kecuali diblokir oleh kebijakan konten Mage.
Coba ulang dengan aman
Kunci idempotensi membuat pengiriman ulang mengembalikan permintaan asli tanpa dikenai biaya lagi.
Karakter yang konsisten
Simpan karakter atau referensi sekali saja, lalu tulis @handle di prompt mana pun untuk memakainya di semua model yang mendukungnya.
Input berukuran besar
Kirim input gambar, video, dan audio sebagai URL atau data URL, atau unggah file hingga 100 MB lewat unggahan bertanda tangan.
20 generasi berjalan bersamaan
Setiap akun dapat menjalankan 20 generasi sekaligus, dan batasnya bisa dinaikkan sesuai kebutuhanmu. Permintaan yang ditolak tidak pernah dikenai biaya.
Kasus penggunaan
Yang dibuat developer dengan API video
Video pendek dan media sosial
Buat klip vertikal untuk TikTok, Reels, dan Shorts dari prompt atau gambar produk.
Animasikan gambar diam
Ubah frame pertama, atau frame pertama dan terakhir, menjadi gerakan dengan model image-to-video seperti Lemon dan Kiwi.
Cerita berbasis karakter
Pertahankan karakter yang sama di setiap shot dengan model reference-to-video yang menerima karakter @handle.
Video dengan suara
Plum dan model lainnya menghasilkan ucapan, efek suara, dan suasana bersama gambarnya, serta menerima referensi audio untuk suara.
Iklan dan demo produk
Buat banyak variasi sebuah iklan dan pilih yang terbaik, dengan pengiriman idempoten yang tidak akan menagih dua kali.
Edit klip yang sudah ada
Berry, Plum, dan Grok Video mengedit video sumber yang kamu kirim; Lemon dan MiniMax-H3 juga menerima video referensi.
FAQ
Pertanyaan yang sering diajukan
Apa API pembuat video AI terbaik?
Apakah API video mendukung image-to-video?
Berapa panjang video yang bisa dibuat?
Berapa lama pembuatan sebuah video?
Berapa biaya Mage API?
Apakah aku perlu keanggotaan Mage untuk memakai API?
Bolehkah hasil dari API dipakai untuk tujuan komersial?
Apa saja rate limit-nya?
Bisakah agen AI-ku memakai API Mage?
Apakah ada SDK untuk API Mage?
Aku sudah memakai API generasi lain. Apa yang perlu kuubah?
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.