메인 콘텐츠로 건너뛰기
작업 유형에 맞는 제공업체 워크플로를 선택하여 CometAPI 동영상 모델 문서를 사용하세요. 대부분의 동영상 엔드포인트는 비동기 작업을 생성하므로 작업 ID를 저장하고 폴링을 사용해 결과를 가져오세요. 모델별 페이지에서 콜백 지원을 문서화한 경우에만 콜백을 추가하세요.

동영상 API 선택

Seedance 동영상 생성

Seedance 동영상 작업을 생성합니다.

HappyHorse 동영상 생성

HappyHorse 텍스트-동영상 작업을 생성합니다.

MiniMax H3 동영상 생성

MiniMax H3 텍스트-동영상 또는 참조 이미지 동영상 작업을 생성합니다.

Flux 3 동영상 생성

Flux 3 텍스트-동영상 또는 이미지-동영상 작업을 생성합니다.

Veo 3 동영상 생성

Veo 동영상 작업을 생성합니다.

Wan 동영상 생성

Wan 텍스트-동영상 또는 이미지-동영상 작업을 생성합니다.

xAI 동영상 생성

xAI 동영상 작업을 생성합니다.

Vidu 동영상 생성

Vidu 텍스트-동영상 또는 이미지-동영상 작업을 생성합니다.

Omni 동영상 생성(베타)

베타 Omni 동영상 작업을 생성합니다.

Kling 텍스트-동영상 작업 생성

텍스트 프롬프트(Prompt)로 Kling 동영상을 생성합니다.

Runway 모델 사용

이미지, 동영상 또는 오디오 작업에 사용할 Runway 모델을 선택합니다.

동영상 작업 생성 및 폴링

동영상 기능을 지원하는 모델 ID를 모델 페이지 또는 모델 디렉터리에서 사용하세요. 아래 예에서는 POST /v1/videos로 동영상 작업을 생성한 다음, 작업이 최종 상태에 도달할 때까지 반환된 작업 ID를 폴링합니다.
이 예에서는 자리 표시자로 your-video-model-id를 사용합니다. 요청을 실행하기 전에 모델 페이지 또는 모델 디렉터리 에서 사용할 수 있는 동영상 모델 ID로 바꾸세요.
다음을 여세요: Seedance 동영상 생성 및 Seedance 동영상 조회 에서 API 플레이그라운드와 엔드포인트 스키마를 사용할 수 있습니다.
단일 직접 요청으로 작업을 생성합니다:
반환된 ID로 작업을 한 번 조회합니다:

응답 예시

성공적인 생성 응답은 다음과 같을 수 있습니다. 폴링하기 전에 작업 ID를 저장하세요:
성공적인 폴링 응답은 다음과 같을 수 있습니다. 완료된 응답에는 video_url가 포함될 수 있습니다. 일부 제공업체 형식에서는 모델별 결과 필드를 사용하거나, 해당 경로가 문서화된 경우 동영상 콘텐츠 경로를 사용합니다:

예시 모델 레코드

이 예시 모델 카탈로그 응답은 /api/models 형식과 비디오 모델 레코드 구조 하나를 보여 줍니다. 전체 모델 목록은 아닙니다.
cURL

일반적인 오류

작업 핸들러에서 반환하기 전에 생성 응답의 ID를 저장하세요.
상태 확인 사이에 지연 및 백오프를 추가하세요.
선택한 비디오 엔드포인트에 대해 문서화된 기간 및 해상도 필드를 사용하세요.
video_url은 선택 사항으로 처리하고, 가능한 경우 모델별 결과 필드 또는 콘텐츠 경로를 대신 사용하세요.
폴링을 신뢰할 수 있는 기준으로 사용하고 콜백 URL이 POST 요청을 수락하는지 확인하세요.

오류 코드 및 재시도 전략

프롬프트(Prompt), 파일, 기간 또는 크기 필드가 수정될 때까지 재시도하지 마세요.
API 키가 존재하고 유효해질 때까지 재시도하지 마세요.
재시도하기 전에 작업 ID, 기본 URL, 경로 및 모델 ID를 확인하세요.
재시도하기 전에 업로드 크기를 줄이세요.
지수 백오프로 재시도하고 생성 또는 폴링 동시성을 줄이세요.
백오프를 적용해 작업 생성을 재시도하세요. 작업이 종료 오류 상태에 도달하지 않는 한 기존 작업은 계속 폴링하세요.

가격 및 모델 디렉터리

모델 페이지

문서에서 CometAPI가 모델 ID를 제공하는 방식을 알아보세요.

모델 디렉터리

모델의 사용 가능 여부와 기능을 살펴보세요.

가격

모델을 호출하기 전에 가격을 확인하세요.
마지막 수정일 2026년 10월 27일