Berry API

Sekilas info

Berry API menjalankan Berry 2 dan 1 varian lain lewat Mage di POST https://api.mage.space/v1/berry/generate. Satu permintaan dengan pengaturan default dikenai biaya 189 Gems (sekitar $0,189), tanpa langganan. Berry menerima karakter tersimpan dan referensi lewat @handle di prompt.

• Video

  Output

• 2

  Varian

• 189

  Gems per klip, default

• $0.189

  Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan Berry API

Video yang tetap setia pada setiap referensi yang kamu berikan. Satu frame awal, hingga 9 referensi atau Characters, atau video sumber untuk diedit; durasi 3 hingga 15 detik hingga 1080p.

Model video berbasis referensi dari Mage, setia pada gambar yang kamu berikan; Berry 2 adalah versi terbarunya. Gunakan frame pertama atau gambar referensi, atau video sumber untuk diedit.

Menerima first_image, image, additional_images, video sebagai input.

Mulai cepat

Panggil Berry API

Setel MAGE_API_KEY, kirim ke /berry/generate, lalu poll status_url sampai permintaan selesai.

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

Model

Nilai model_id Berry

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

Opsi

Parameter Berry

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

Input

Input media yang diterima Berry

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

Aturan

Aturan yang diterapkan Berry API

• Frame pertama tidak bisa dikombinasikan dengan gambar referensi.
• Pengeditan video hanya berjalan di `berry`, bukan `berry-2`: kirim `model_id: "berry"` dengan video sumber berdurasi 3 sampai 60 detik.

Model video lainnya

API pembuat video AI lainnya di Mage

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 video AI
• Referensi Berry API
• Playground Berry
• Semua model API
• Server MCP Mage