동영상 생성 및 자산 관리

Kling v4 및 Seedance 모델을 사용하여 동영상을 생성하고 공인 미디어 자산을 참조합니다.

네이티브 동영상 엔드포인트를 통해 동영상 생성 작업을 제출하고 공인 미디어 자산을 관리합니다.

POST/v1/videos

요청 본문

필드타입필수 여부설명
promptstring예원하는 동영상 장면 및 카메라 움직임에 대한 텍스트 설명.
modelstring아니요동영상 모델 식별자(예: kling-v4 또는 doubao-seedance-2-0-260128).
duration_secondsnumber아니요동영상 생성 시간(초 단위, 최대 300의 양수, duration 별칭도 지원).
Additional fieldsobject아니요추가 동영상 파라미터(resolution, aspect_ratio, first_frame_url, last_frame_url 등)는 업스트림 엔진으로 투명하게 전달됩니다.

Seedance 공인 자산

POST/v1/seedance/assets
GET/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 비동기 작업 수명 주기 계약을 제공합니다.