완료 후, `metadata.content_url`에는 바로 접속 가능한 비디오 주소가 제공됩니다. 아래 콘텐츠 인터페이스를 사용하여 다운로드할 수도 있습니다.

응답(실패)

{
'id': 'task_12345',

'object': 'video',

'status': 'failed',

'error': { 'message': '실패 사유' }
}

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 폴링() {
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 (요청 + 폴링)
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. 폴링
while True:

data = requests.get(f{BASE}/v1/videos/{task_id}, headers=headers).json()
if data["status"] == "completed":

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(&34;result.mp4, &34;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: } `
returns "video-ds-2.0
,

"messages: [{"role: "user, "content: "햇살 아래 달리는 고양이, 영화 같은 영상, 9:16}]

}

채팅 완료를 반환합니다.
 형식은 `message.content`이며, 작업 상태와 `/v1/videos/{task_id}` 링크가 포함됩니다. 이 링크를 클릭하면 작업이 완료되면 영상이 재생됩니다. 채팅 로비 페이지에서 이 메서드를 사용합니다.



두 진입점(/v1/videos/generations 및 /v1/chat/completions)은 동일한 작업 시스템을 공유하므로 서로 충돌하지 않습니다. 직접 통합하려면 표준 `/v1/videos/*` 인터페이스를 사용하는 것이 좋습니다.
 






오류 코드







상태 코드

의미








401

토큰이 없거나 만료되었거나 유효하지 않습니다




403

잔액이 부족하거나 현재 그룹에 이 모델에 대한 권한이 없습니다




404

작업 ID가 존재하지 않거나 현재 사용자에게 속하지 않거나 모델이 구성되지 않았습니다.




409

비디오 콘텐츠를 준비하지 못했습니다(작업이 아직 진행 중입니다). 대기열/생성 중)


429

속도 제한 트리거


502

상위 공급자가 실패했거나 유효하지 않은 결과를 반환했습니다