Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Mode Pembuatan

SkyReels V4 otomatis merutekan ke mode yang benar berdasarkan field permintaan — tanpa mode field diperlukan:
Saling eksklusif secara ketat: Field I2V (first_frame_image / end_frame_image / mid_frame_images) dan field Omni (ref_images / ref_videos) tidak dapat digunakan bersama, jika tidak akan mengembalikan 422.
Mekanisme @tag: Saat menggunakan mid_frame_images / ref_images / ref_videos, setiap elemen harus mendeklarasikan tag yang dimulai dengan @ (misalnya, @image1, @Actor-1, @video1), dan tag harus muncul di prompt.Anggap prompt sebagai “skrip” dan tag sebagai “penunjuk karakter” ke aset tertentu (gambar / video). Misalnya, prompt seperti "@Actor-1 walks into the scene of @video1" menginstruksikan sistem untuk memasukkan gambar referensi subjek yang ditautkan ke @Actor-1 dan gerakan referensi yang ditautkan ke @video1 ke dalam proses pembuatan.

Parameter Permintaan

Field Umum

string
wajib
Tersedia dua tingkat model:
Field model harus disediakan secara eksplisit — tidak ada nilai default.
Harga sangat terkait dengan resolusi dan apakah ref_videos digunakan: 1080p jauh lebih mahal daripada 480p / 720p; tier dengan ref_videos (input video) berbiaya ~1,5 ~ 2× dibandingkan yang tanpa itu. Output audio dan video secara bersamaan belum didukung.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Prompt teks, maksimum 1280 tokensJelaskan adegan, subjek, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baik.Saat menggunakan ref_images / ref_videos / mid_frame_images, prompt harus berisi @tag terkait (misalnya, @Actor-1, @video1, @image1).Contoh: "@Actor-1 walks through a neon-lit street at night."
integer
default:"5"
Durasi video output (detik)
  • Rentang: [3, 15]
  • Default: 5
Saat ref_videos.type=reference disediakan, duration ditimpa oleh durasi video referensi (maks. 10 detik).
string
default:"1080p"
Resolusi videoOpsi:
  • 480p
  • 720p
  • 1080p (default)
string
default:"16:9"
Rasio aspekOpsi:
  • 16:9 (default)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
aspect_ratio diabaikan dalam mode I2V (rasio output ditentukan oleh gambar input); juga diabaikan saat Omni dikombinasikan dengan ref_videos.
boolean
default:"true"
Apakah mengoptimalkan prompt secara otomatisJika diaktifkan, sistem otomatis mengoptimalkan prompt Anda untuk hasil pembuatan yang lebih baik.

Field Khusus I2V

string
URL gambar frame pertama (jpg / jpeg / png / gif / bmp)Saat disediakan, gambar ini digunakan sebagai frame awal video.
string
URL gambar frame akhir (jpg / jpeg / png / gif / bmp)Saat disediakan, gambar ini digunakan sebagai frame akhir video. Dapat dikombinasikan dengan first_frame_image untuk kontrol frame pertama dan terakhir.
object[]
Daftar keyframe tengah, hingga 6. Setiap elemen memiliki struktur berikut:

Field Khusus Omni

object[]
Daftar gambar referensi (semua elemen harus memiliki type). Setiap elemen memiliki struktur berikut:
object[]
Daftar video referensi, hingga 1. Setiap elemen memiliki struktur berikut:

Skenario yang Didukung

Skenario berikut didukung oleh keduanya skyreels-v4-fast dan skyreels-v4-std:

Batasan Parameter

Melanggar salah satu di bawah ini akan menyebabkan permintaan ditolak dengan respons 422, tidak ada biaya yang dikenakan:

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Contoh Permintaan

Kasus 1: Teks-ke-Video (Minimal)

Kasus 2: Teks-ke-Video (Parameter Lengkap)

Kasus 3: Gambar-ke-Video - Frame Pertama

Kasus 4: Gambar-ke-Video - Frame Pertama/Akhir + Keyframe Tengah

Kasus 5: Omni - Subjek Referensi Tunggal

Kasus 6: Omni - Multi-Subjek + Video Gerakan Referensi

Kasus ini menggunakan ref_videos.type=reference, sehingga ** duration akan ditimpa oleh durasi aktual video referensi** (maks. 10 detik). Meskipun "duration": 5 dikirim di sini, durasi video final mengikuti video referensi.

Kasus 7: Omni - Kolase Grid

Kasus 8: Omni - Perpanjangan Video (extend)

Kasus 9: Omni - Sinkronisasi Audio (Berbasis Suara)

Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.