Pembuatan video

Buat video dengan Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse dan MiniMax dari prompt, dari frame awal (dan frame akhir jika diinginkan), atau dari gambar referensi, video dan audio. Pembuatan video memerlukan beberapa menit, jadi mulai prosesnya lalu periksa kembali.

Mulai, periksa status, unduh

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

Semua model video bekerja dengan cara yang sama: ubah model dan format permintaannya tetap sama. Panduan model menjelaskan keunggulan masing-masing: Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu dan PixVerse.

Parameter

Memulai dari gambar

Frame pertama dan terakhir

Animasikan gambar diam: video dimulai persis dari first_frame. Tambahkan last_frame agar video berakhir pada gambar tersebut, sehingga Anda bisa mengatur awal dan akhir adegan. MiniMax starts dari gambar referensi sebagai gantinya.

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

Gambar referensi

Berikan hingga 10 gambar (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu dan PixVerse take none) dan rujuk sesuai urutannya dalam prompt (@Image1, @Image2…): orang, produk, dan tempat dalam gambar akan muncul di video.

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

Video dan audio referensi

Berikan video untuk meniru penampilan dan gerakan seseorang, gerakan kamera, atau adegan, serta audio untuk suara, melodi, atau efek suara. Rujuk sesuai urutannya dalam prompt, seperti gambar: @Video1, @Audio1. Referensi ini bisa digabung dengan gambar referensi, tetapi tidak dengan frame pertama.

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

Model membaca setiap detik video referensi, jadi durasi tersebut juga dikenakan biaya, dengan tarif sebagian dari harga per detik: video 5 s dengan referensi 10 s dikenakan biaya untuk durasi 5 detiknya ditambah 10 detik referensi. Audio referensi tidak dikenakan biaya tambahan. Setiap objek video menampilkan durasi referensi yang ditagihkan (reference_seconds).

Mengedit dan memperpanjang video

Atur reference_mode ke edit untuk mengubah video referensi (mengganti orang atau objek, menambahkan atau menghapus sesuatu, mengganti musik), atau ke extend untuk melanjutkannya ke depan atau ke belakang. Jelaskan perubahan dalam prompt: “Ganti mobil di @Video1 dengan mobil di @Image1”, “Lanjutkan @Video1 saat penari meninggalkan panggung”.

• Pengeditan mempertahankan format dan durasi video, jadi jangan sertakan aspect_ratio dan seconds. Biayanya dihitung berdasarkan durasi video referensi terpanjang, yang harus berdurasi 4 hingga 30 detik.
• Perpanjangan mempertahankan format video; seconds menentukan durasi video baru.
• Tanpa reference_mode, model menentukan tindakan dari prompt, dan prompt yang mengarah ke pengeditan saat seconds atau aspect_ratio diatur bisa gagal (video yang gagal tidak dikenakan biaya).

Aturan gambar

• PNG, JPEG, atau WebP, dalam bentuk tautan https publik atau data URL, hingga 10 MB.
• 300 hingga 6000 piksel pada setiap sisi, dan rasio lebar atau tinggi tidak melebihi 5:2. Data URL yang tidak memenuhi ketentuan ini langsung ditolak dengan pesan yang menjelaskan alasannya. Tautan dibaca saat proses video dimulai: jika tautan bukan gambar yang dapat digunakan, video gagal dengan invalid_image, tanpa biaya.
• Frame atau referensi, tidak bisa keduanya dalam satu permintaan.
• Permintaan menggunakan JSON: gambar dikirim sebagai tautan atau data URL, bukan unggahan multipart.

Objek video

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

Endpoint lainnya

Pembayaran video

Biaya video adalah harga per detik (berdasarkan resolusi) dikalikan durasinya; lebih murah Kling dan PixVerse cost per detik tanpa suara; durasi video referensi dikenai sebagian dari harga tersebut per detik. Saat Anda memulai pembuatan video, biayanya dicadangkan dari saldo Anda; saldo dipotong setelah video selesai, dan dana dikembalikan jika gagal. Video yang gagal tidak dikenai biaya.