Setelah selesai, `metadata.content_url` akan memberikan alamat video yang dapat diakses langsung; video tersebut juga dapat diunduh menggunakan antarmuka konten di bawah ini.

Respons (gagal)

{
id: task_12345,
objek: video,
status: gagal,
error: { pesan: Alasan kegagalan }
}

3. Unduh konten video

curl -L "$KOZEAI_BASE_URL/v1/videos/task_12345/content" \
-H "Authorization: Bearer $KOZEAI_API_KEY" \
-o result.mp4


Mengembalikan 409 Conflict jika tugas belum selesai (Masih dalam antrian/sedang dibuat).

Mendukung pengunduhan tersegmentasi/pemutaran seret dan lepas menggunakan header permintaan .

Mengembalikan . 


Contoh lengkap
JavaScript (fetch + polling)
const BASE = process.env.KOZEAI_BASE_URL;
const KEY = process.env.KOZEAI_API_KEY;
const headers = { Authorization: `Bearer ${KEY}` };

// 1. Kirim tugas
const submit = await fetch(`${BASE}/v1/videos/generations`, {
method: 'POST',
headers: { ...headers, 'Content-Type': 'application/json' },

body: JSON.stringify({
model: 'video-ds-2.0',
prompt: 'Video komersial yang halus tentang botol parfum di atas kaca',
seconds: 15,
aspect_ratio: '9:16',

}),
});

const task = await submit.json();

const taskId = task.id;

// 2. Polling sampai selesai
async function poll() {
while (true) {
const res = await fetch(`${BASE}/v1/videos/${taskId}`, { headers });

const data = await res.json();

if (data.status === 'complete') return data;

if (data.status === 'failed') throw new Error(data.error?.message || 'failed');
await new Promise((r) ==> setTimeout(r, 5000));

}
}
const done = await poll();

// 3. Dapatkan alamat video
console.log('Alamat video:', done.metadata?.content_url
|| `${BASE}/v1/videos/${taskId}/content`);


Python (requests + polling)
import os, time, requests

BASE = os.environ["KOZEAI_BASE_URL"]
KEY = os.environ["KOZEAI_API_KEY"]
headers = {"Authorization": fPembawa {KEY}}

# 1. Kirim tugas
resp = requests.post(

f{BASE}/v1/videos/generations,
headers=headers,
json={
model: video-ds-2.0,
prompt: Sebuah video sinematik berdurasi 9:16 tentang seekor kucing yang berlari di bawah sinar matahari yang hangat,

detik: 15,

rasio_aspek: 9:16,

},
)
task_id = resp.json()[id]

# 2. Polling
while True:

data = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers).json()
if data["status"] == "complete":
break
if data["status"] == "failed":
raise RuntimeError(data.get("error", {}).get("message", "failed"))
time.sleep(5)

# 3. Unduh
mp4 = requests.get(f"{BASE}/v1/videos/{task_id}/content", headers=headers)
with open("result.mp4", "wb") as f: f.write(mp4.content)


Dipanggil di antarmuka penyelesaian obrolan (penggunaan yang kompatibel)

Model video juga dapat dipanggil melalui /v1/chat/completions, sehingga memudahkan penggunaan kembali klien obrolan.
 Saat membuat permintaan, cukup berikan nama model video di `model`, dan sistem akan secara otomatis mengubahnya menjadi tugas video:

curl $KOZEAI_BASE_URL/v1/chat/completions
 \
-H Authorization: Bearer $KOZEAI_API_KEY \
-H Content-Type: application/json \
-d {
Model: } `
mengembalikan "video-ds-2.0
,

"pesan: [{"peran: "pengguna, "konten: "seekor kucing berlari di bawah sinar matahari, sinematik, 9:16}]

}

Mengembalikan penyelesaian obrolan
 Formatnya adalah `pesan.konten`, yang berisi status tugas dan tautan `/v1/videos/{task_id}`. Tautan ini akan memutar video setelah selesai. Halaman lobi obrolan menggunakan metode ini.



Kedua titik masuk (/v1/videos/generations dan /v1/chat/completions) berbagi sistem tugas yang sama dan tidak saling bertentangan. Untuk integrasi langsung, disarankan untuk menggunakan antarmuka standar `/v1/videos/*`.
 






Kode Kesalahan







Status Kode

Arti








401

Token hilang, kedaluwarsa, atau tidak valid




403

Saldo tidak mencukupi, atau grup saat ini tidak memiliki izin untuk model ini




404

ID Tugas Tidak ada, atau tidak dimiliki oleh pengguna saat ini; atau model belum dikonfigurasi.




409

Konten video belum siap (tugas masih mengantri/membuat)


429

Tingkat pemicu batas


502

Pemasok hulu gagal atau mengembalikan hasil yang tidak valid