Skip to main content
POST
cURL
이 베타 엔드포인트를 사용해 Omni 비디오 작업을 생성합니다. API는 즉시 작업 ID를 반환하므로, 반환된 id를 저장하고 작업이 최종 상태에 도달할 때까지 폴링하세요. 베타 POST /v1/videosmultipart/form-data를 사용합니다. 스칼라 제어값은 form 필드로 전달하세요.

입력 모드 선택

이 페이지에서는 model=omni-fast를 사용하세요.

길이, 비율, 해상도 설정

Omni는 입력과 선택한 route에 따라 생성 안정성이 달라질 수 있으므로 베타로 표시됩니다. 첫 번째 요청은 작게 시작한 다음, 특정 렌더링 길이나 프레임 크기에 의존하기 전에 완료된 비디오를 확인하세요. 이 엔드포인트는 베타이므로, aspect_ratioresolution은 생성 선호값으로 간주하고 최종 픽셀에 의존하기 전에 다운로드한 MP4를 확인하세요.

작업 흐름

1

작업 생성

multipart form 요청을 보내고 반환된 id를 저장합니다.
2

작업 폴링

statuscompleted 또는 failed가 될 때까지 Omni 비디오 조회를 호출합니다.
3

결과 다운로드

작업이 completed 상태가 되면 Omni 비디오 콘텐츠 조회를 호출해 MP4 파일을 다운로드합니다.

인증

Authorization
string
header
필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data
model
enum<string>
필수

Omni model ID for this endpoint. Use omni-fast for text-to-video.

사용 가능한 옵션:
omni-fast
예시:

"omni-fast"

prompt
string
필수

Text prompt that describes the video to generate.

예시:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds
string
기본값:4

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

예시:

"4"

aspect_ratio
enum<string>
기본값:16:9

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"

resolution
string

Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.

예시:

"720p"

응답

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
필수

Task ID. Use this value with retrieve and content endpoints.

예시:

"task_example"

object
string
필수

Object type. Video tasks return video.

예시:

"video"

model
string
필수

Model ID used for the task.

예시:

"omni-fast"

status
enum<string>
필수

Task lifecycle status. Poll until the value is completed, failed, or error.

사용 가능한 옵션:
queued,
in_progress,
completed,
failed,
error
예시:

"queued"

progress
integer
필수

Task progress as a coarse percentage.

필수 범위: 0 <= x <= 100
예시:

0

created_at
integer
필수

Task creation time as a Unix timestamp in seconds.

예시:

1779938152

task_id
string

Compatibility alias for id when present.

예시:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

예시:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

예시:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.