API pembuat video AI dari teks atau gambar

Sekilas info

API pembuat video Mage adalah REST API di https://api.mage.space/v1 yang menjalankan 12 model text-to-video dan image-to-video, termasuk Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video, dan Wan. Kirim prompt beserta frame atau referensi opsional, pantau statusnya dengan polling, lalu unduh MP4. Setiap klip dibayar dengan Gems sesuai model, resolusi, dan durasi.

• 12

  model video

• $0.02

  Default termurah, per klip

• 20

  Proses generate bersamaan

• $0

  Biaya 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.

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.

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"

// 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);

# 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.

1. 01

   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.

2. 02

   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.

3. 03

   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

Kasus penggunaan

Yang dibuat developer dengan API video

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 gambar AI
• API pembuat audio AI
• Server MCP Mage
• SDK Mage
• Mage untuk ComfyUI
• Semua model API
• Playground API
• Dokumentasi API