Langsung ke konten

Mage API · Model video

Cherry API

Keluarga model video andalan kami

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

Sekilas info

Cherry API menjalankan Cherry 2 Pro dan 4 varian lainnya lewat Mage di POST https://api.mage.space/v1/cherry/generate. Satu permintaan dengan pengaturan default berharga 618 Gems (sekitar $0,618), tanpa langganan. Cherry bisa memakai karakter, referensi, dan referensi audio yang tersimpan lewat @handle di prompt.

  • VideoOutput
  • 5Varian
  • 618Gems per klip, default
  • $0.618Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan Cherry API

Video sinematik dengan audio, dari Cherry Mini untuk draf hingga Cherry 2 Pro, model kami yang paling canggih, dengan klip hingga 30 detik, banyak referensi atau Characters, dan pengeditan dari video sumber.

Lini video unggulan Mage dengan gerakan sinematik dan audio: Cherry Mini, Cherry, Cherry Pro, Cherry 2, dan Cherry 2 Pro yang paling canggih. Model Cherry 2 bisa membuat klip hingga 30 detik.

Menerima image, additional_images, dan videos sebagai input.

Mulai cepat

Panggil Cherry API

Setel MAGE_API_KEY, kirim ke /cherry/generate, lalu polling status_url sampai permintaan selesai.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
  "model_id": "cherry-2-pro"
}' | 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('cherry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'cherry-2-pro',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("cherry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "cherry-2-pro",
})

print(request["result"]["url"])

Model

Nilai model_id Cherry

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

model_idNamaDefault
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProYa

Opsi

Parameter Cherry

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
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Input

Input media yang diterima Cherry

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

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.
videosVideo sumber.

Aturan

Aturan yang diterapkan Cherry API

  • Pengeditan video membutuhkan tepat satu video sumber, berdurasi 4 sampai 30 detik di `cherry-2` dan `cherry-2-pro`, serta 2 sampai 15 detik di model lainnya.
  • Di `cherry-2` dan `cherry-2-pro`, hasil edit mempertahankan durasi dan rasio aspek video sumbernya: `duration` dan `aspect_ratio` diabaikan, dan harganya mengikuti durasi video.

Model video lainnya

API pembuat video AI lainnya di Mage

  • Video · mulai dari 375 Gems

    Grok Video API

    Grok Imagine, dalam gerak

  • Video · mulai dari 270 Gems

    Kiwi API

    Video sehari-hari, tanpa setup

  • Video · mulai dari 245 Gems

    Lemon API

    Semua fitur video dengan harga lebih bersahabat

  • Video · mulai dari 20 Gems

    LTX Video API

    Video open-weights yang cepat untuk iterasi

  • Video · mulai dari 1.856 Gems

    Magejutsu API

    Ganti subjek video apa pun, gerakannya tetap utuh

  • Video · mulai dari 147 Gems

    Melon API

    Anime dalam gerak, dengan audio opsional

FAQ

Pertanyaan yang sering diajukan

Berapa biaya Cherry API?
Satu permintaan Cherry dengan pengaturan default (Cherry 2 Pro) berharga 618 Gems, sekitar $0.618. Resolusi, durasi, dan varian lain mengubah harganya; respons menampilkan biaya persisnya. Pembuatan yang gagal akan dikembalikan biayanya; yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint Cherry API?
POST https://api.mage.space/v1/cherry/generate dengan header Authorization: Bearer yang berisi API key Mage-mu. Respons menyertakan status_url untuk di-polling guna mendapatkan hasilnya.
Model Cherry apa saja yang bisa kupanggil?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). Defaultnya adalah Cherry 2 Pro.
Apakah Cherry mendukung gambar referensi atau karakter?
Cherry menerima image, additional_images, dan videos. Cherry juga menerima karakter, referensi, dan referensi audio tersimpan lewat @handle di prompt.
Bisakah aku memakai Cherry dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Cherry langsung dengan namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harganya sebelum membuat konten.
Berapa lama hasil Cherry 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