이미지로 영상 생성 sora-2
POST
/v1/video/create
sora-2-all 비디오 모델을 사용해 여러 장의 이미지와 프롬프트로 통합 포맷의 동영상을 생성합니다.
정적인 이미지를 세로 또는 가로 방향의 쇼트 영상으로 빠르게 변환하는 데 유용합니다.
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
images
string[]
Required
이미지 URL 배열입니다. 각 요소는 공개로 접근 가능한 이미지 URL 이어야 합니다.
model
string
Required
모델 이름입니다. 예: 'sora-2-all'.
orientation
string
Required
비디오 방향:
- portrait: 세로
- landscape: 가로
prompt
string
Required
비디오의 내용과 스타일을 설명하는 텍스트 프롬프트입니다.
size
string
Required
비디오 크기입니다. 예: 'small'(약 720p), 'large' 등.
duration
integer
Required
비디오 길이(초 단위). 예: 10 또는 15.
watermark
string
Required
워터마크 제어:
- 기본값 true: 가능하면 워터마크 없는 비디오를 우선 생성하고, 실패 시 워터마크가 포함된 버전으로 폴백합니다.
- false 전달 시: 반드시 워터마크 없는 비디오를 생성하며, 제거 오류가 발생하면 자동으로 재시도합니다.
Responses
비디오 생성 작업이 성공적으로 생성됨
application/json
object
id
string
Required
작업 상태 및 결과를 조회할 때 사용하는 작업 ID 입니다.
status
string
Required
작업 상태입니다. 예: 'pending', 'processing', 'succeeded', 'failed'.
status_update_time
integer
Required
상태가 마지막으로 업데이트된 시각(밀리초 단위)입니다.