비디오 API
텍스트 프롬프트로 비디오를 생성합니다. 항상 비동기로 동작하며, task_id를 반환합니다. 작업 상태는 /api/v1/tasks/:taskId로 조회합니다.
엔드포인트
POST
/api/v1/videos/generations공통 요청 파라미터
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
model* | string | * 필수 | 사용할 비디오 모델 ID | - |
prompt* | string | * 필수 | 비디오 설명 프롬프트. 장면, 카메라 움직임, 분위기 등을 포함하면 좋습니다. | - |
duration | number | 선택 | 비디오 길이 (초). 모델별 최대 길이가 다릅니다. | - |
resolution | string | 선택 | 비디오 해상도 720p1080p4K | 720p |
callback_url | string | 선택 | 비디오 생성 완료 시 호출할 콜백 URL. POST 요청으로 결과를 전달합니다. | - |
응답 필드
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
task_id* | string | * 필수 | 비동기 작업 ID. 비디오 생성은 항상 비동기로 처리됩니다. | - |
status* | string | * 필수 | 작업 상태. "queued" | "running" | "completed" | "failed" | - |
estimated_time | number | 선택 | 예상 소요 시간 (초) | - |
코드 예제
curl -X POST https://api.billing-ai.kr/api/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "경복궁에 벚꽃이 흩날리는 장면, 시네마틱 카메라 워크",
"duration": 10,
"resolution": "1080p"
}'