동영상 생성 및 자산 관리
Kling v4 및 Seedance 모델을 사용하여 동영상을 생성하고 공인 미디어 자산을 참조합니다.
네이티브 동영상 엔드포인트를 통해 동영상 생성 작업을 제출하고 공인 미디어 자산을 관리합니다.
POST
/v1/videos요청 본문
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
prompt | string | 예 | 원하는 동영상 장면 및 카메라 움직임에 대한 텍스트 설명. |
model | string | 아니요 | 동영상 모델 식별자(예: kling-v4 또는 doubao-seedance-2-0-260128). |
duration_seconds | number | 아니요 | 동영상 생성 시간(초 단위, 최대 300의 양수, duration 별칭도 지원). |
| Additional fields | object | 아니요 | 추가 동영상 파라미터(resolution, aspect_ratio, first_frame_url, last_frame_url 등)는 업스트림 엔진으로 투명하게 전달됩니다. |
Seedance 공인 자산
POST
/v1/seedance/assetsGET
/v1/seedance/assets/{asset_id}- 자산 등록: 필수 항목인
sourceUrl,assetType(image또는video) 및 선택적displayName이 포함된 JSON으로POST /v1/seedance/assets(operationId: seedance_assets.create)를 호출합니다. - URI 참조: 프레임 URL 또는 고급 파라미터에서
asset://{asset_id}를 사용하여 등록된 미디어를 직접 참조합니다. - 테넌트 격리: 자산은 테넌트의 현재 자산 라이브러리로 격리되며 업스트림 저장소에 대해 검증됩니다.
작업 상태 및 결과 다운로드
GET
/v1/videos/{task_id}- 상태 폴링:
GET /v1/videos/{task_id}(operationId: legacy_media.video.get)를 통해 작업 상태를 조회하며,queued,submitting,submitted,running,ingesting_artifacts,cancel_requested,completed,failed,cancelled등 9가지 상태를 지원합니다. - 결과 다운로드: 작업이 성공적으로 완료되면
GET /v1/videos/{task_id}/content에서 동영상 바이너리 파일을 다운로드합니다. - Kling v4 지원: 텍스트-동영상, 첫 프레임 이미지-동영상, 마지막 프레임 전환 모드를 완벽히 지원합니다.
호환 별칭
- 기존 미디어 별칭:
POST /openai/v1/videos는POST /v1/videos의 기존 별칭(legacy_media.video.create.alias)으로 동일한 구조를 따릅니다. - 기존 작업 라우트:
POST /v1/videos/generations는CreateVideoGenerationRequest형식의 페이로드를 허용합니다. - 통합 비동기 파이프라인:
POST /v1/async-tasks/video-generations는 표준화된 v4 비동기 작업 수명 주기 계약을 제공합니다.