หลังจากเสร็จสิ้น `metadata.content_url` จะให้ที่อยู่ของวิดีโอที่สามารถเข้าถึงได้โดยตรง นอกจากนี้ยังสามารถดาวน์โหลดได้โดยใช้ส่วนติดต่อเนื้อหาด้านล่าง

การตอบสนอง (ล้มเหลว)

{
"id": "task_12345",
"object": "video",
"status": "failed",
"error": { "message": "Failure reason" }
}

3. ดาวน์โหลดเนื้อหาวิดีโอ

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


ส่งคืนรหัส 409 Conflict หากงานไม่เสร็จสมบูรณ์ (ยังอยู่ในคิว/กำลังสร้าง)

รองรับการดาวน์โหลดแบบแบ่งส่วน/การเล่นแบบลากและวางโดยใช้ส่วนหัวคำขอ 

ส่งคืน  


ตัวอย่างแบบเต็ม
JavaScript (fetch + polling)
const BASE = process.env.KOZEAI_BASE_URL;
const KEY = process.env.KOZEAI_API_KEY;
const headers = { Authorization: `Bearer ${KEY}` };

// 1. ส่งงาน
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: 'วิดีโอโฆษณาที่ราบรื่นของขวดน้ำหอมบนกระจก',
seconds: 15,
aspect_ratio: '9:16',

}),
});
const task = await submit.json();
const taskId = task.id;

// 2. โพลล์จนกว่าจะเสร็จสมบูรณ์
async function poll() {
while (true) {
const res = await fetch(`${BASE}/v1/videos/${taskId}`, { headers });

const data = await res.json();
if (data.status === 'completed') 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. รับที่อยู่ของวิดีโอ
console.log('ที่อยู่ของวิดีโอ:', 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": f"Bearer {KEY}"}

# 1. ส่งงาน
resp = requests.post(

f"{BASE}/v1/videos/generations",
headers=headers,
json={
"model": "video-ds-2.0",
"prompt": "วิดีโอภาพยนตร์ความยาว 9:16 นาทีของแมววิ่งผ่านน้ำอุ่น แสงแดด",
"วินาที": 15,
"อัตราส่วนภาพ": "9:16",
},
)
task_id = resp.json()["id"]

# 2. การสำรวจ
ในขณะที่เป็นจริง:
data = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers).json()
if data["status"] == "completed":
break
if data["status"] == "failed":
raise RuntimeError(data.get("error", {}).get("message", "failed"))
time.sleep(5)

# 3. ดาวน์โหลด
mp4 = requests.get(f"{BASE}/v1/videos/{task_id}/content", headers=headers)
with open("result.mp4", "wb") as f: f.write(mp4.content)


เรียกใช้ในอินเทอร์เฟซการเสร็จสิ้นการแชท (การใช้งานที่เข้ากันได้)

สามารถเรียกใช้โมเดลวิดีโอผ่าน /v1/chat/completions ได้เช่นกัน ซึ่งช่วยให้สามารถนำไคลเอนต์แชทกลับมาใช้ใหม่ได้
 เมื่อทำการร้องขอ เพียงแค่ส่งชื่อโมเดลวิดีโอใน `model` และระบบจะแปลงเป็นงานวิดีโอโดยอัตโนมัติ:

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

"messages: [{"role: "user, "content: "a cat running in the sunlight, cinematic, 9:16}]

}

ส่งคืนสถานะการเสร็จสิ้นการแชท
 รูปแบบคือ `message.content` ซึ่งประกอบด้วยสถานะของงานและลิงก์ `/v1/videos/{task_id}` ลิงก์นี้จะเล่นวิดีโอเมื่อเสร็จสิ้น หน้าล็อบบี้แชทใช้เมธอดนี้



ทั้งสองจุดเข้าใช้งาน (/v1/videos/generations และ /v1/chat/completions) ใช้ระบบงานเดียวกันและไม่ขัดแย้งกัน สำหรับการเข้าถึงโดยตรง สำหรับการผสานรวม ขอแนะนำให้ใช้อินเทอร์เฟซมาตรฐาน `/v1/videos/*`






รหัสข้อผิดพลาด







รหัสสถานะ

ความหมาย








401

โทเค็นหายไป หมดอายุ หรือไม่ถูกต้อง




403

ยอดเงินคงเหลือไม่เพียงพอ หรือกลุ่มปัจจุบันไม่มีสิทธิ์สำหรับโมเดลนี้




404

รหัสงาน ไม่มีอยู่ หรือไม่เกี่ยวข้อง สำหรับผู้ใช้ปัจจุบัน หรือโมเดลยังไม่ได้กำหนดค่า




409

เนื้อหาวิดีโอไม่พร้อม (งานยังอยู่ในคิว/กำลังสร้าง)


429

กำลังเรียกใช้ขีดจำกัดอัตรา


502

ซัพพลายเออร์ต้นทางล้มเหลวหรือส่งผลลัพธ์ที่ไม่ถูกต้อง