Omni 비디오 생성
CometAPI를 통해 POST /v1/videos로 베타 Omni 비디오 작업을 생성한 다음, 작업을 폴링하고 완료된 MP4 파일을 다운로드합니다.
id를 저장하고 작업이 최종 상태에 도달할 때까지 폴링하세요.
베타
POST /v1/videos는 multipart/form-data를 사용합니다. 스칼라 제어값은 form 필드로 전달하세요.
입력 모드 선택
model=omni-fast를 사용하세요.
길이, 비율, 해상도 설정
Omni는 입력과 선택한 route에 따라 생성 안정성이 달라질 수 있으므로 베타로 표시됩니다. 첫 번째 요청은 작게 시작한 다음, 특정 렌더링 길이나 프레임 크기에 의존하기 전에 완료된 비디오를 확인하세요.aspect_ratio와 resolution은 생성 선호값으로 간주하고 최종 픽셀에 의존하기 전에 다운로드한 MP4를 확인하세요.
작업 흐름
작업 생성
id를 저장합니다.작업 폴링
status가 completed 또는 failed가 될 때까지 Omni 비디오 조회를 호출합니다.결과 다운로드
completed 상태가 되면 Omni 비디오 콘텐츠 조회를 호출해 MP4 파일을 다운로드합니다.인증
Bearer authentication. Use your CometAPI API key.
본문
Omni model ID for this endpoint. Use omni-fast for text-to-video.
omni-fast "omni-fast"
Text prompt that describes the video to generate.
"Ocean waves rolling onto a sandy beach at golden hour"
Requested clip duration in seconds. Start with 4 while this endpoint is beta.
"4"
Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.
16:9, 9:16, 1:1 "16:9"
Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.
"720p"
응답
Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"omni-fast"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.