비디오 API 선택
Seedance 비디오 생성
Seedance 비디오 작업을 생성합니다.
HappyHorse 비디오 생성
HappyHorse 텍스트-투-비디오 작업을 생성합니다.
MiniMax H3 비디오 생성
MiniMax H3 텍스트-투-비디오 또는 참조 이미지 기반 비디오 작업을 생성합니다.
Flux 3 동영상 생성
Flux 3 텍스트-동영상 또는 이미지-동영상 작업을 생성합니다.
Sora 2 비디오 생성
Sora 2 비디오 작업을 생성합니다.
Sora 2 비디오 가져오기
Sora 비디오 작업을 조회합니다.
Veo 3 비디오 생성
Veo 비디오 작업을 생성합니다.
Wan 비디오 생성
Wan 텍스트-투-비디오 또는 이미지-투-비디오 작업을 생성합니다.
xAI 비디오 생성
xAI 비디오 작업을 생성합니다.
Vidu 비디오 생성
Vidu 텍스트-투-비디오 또는 이미지-투-비디오 작업을 생성합니다.
Omni 비디오 생성 (베타)
베타 Omni 비디오 작업을 생성합니다.
Kling 텍스트-투-비디오 작업 생성
텍스트 프롬프트로 Kling 비디오를 생성합니다.
Runway 이미지-투-비디오 작업 생성
이미지로 Runway 비디오를 생성합니다.
동영상 작업 생성 및 폴링
동영상 기능을 지원하는 모델 ID는 모델 페이지 또는 모델 디렉터리에서 선택해 사용하세요. 아래 예시에서는POST /v1/videos로 동영상 작업을 생성한 다음, 작업이 종료 상태에 도달할 때까지 반환된 작업 ID를 폴링합니다.
응답 예시
성공적인 생성 응답은 다음과 같을 수 있습니다. 폴링하기 전에 작업 ID를 저장하세요:video_url가 포함될 수 있습니다. 일부 제공업체 형식은 모델별 결과 필드를 사용하거나, 해당 경로가 문서화된 경우 동영상 콘텐츠 경로를 사용합니다:
모델 레코드 예시
이 예시 모델 카탈로그 응답은
/api/models 엔벨로프와 하나의 비디오 모델 레코드 형태를 보여 줍니다. 전체 모델 목록은 아닙니다.cURL
일반적인 오류
작업 ID 누락
작업 ID 누락
작업 핸들러에서 반환하기 전에 생성 응답의 ID를 저장하세요.
폴링이 너무 빠름
폴링이 너무 빠름
상태 확인 사이에 지연 및 백오프를 추가하세요.
지원되지 않는 duration 또는 size
지원되지 않는 duration 또는 size
선택한 비디오 엔드포인트에 문서화된 duration 및 resolution 필드를 사용하세요.
video_url 누락
video_url 누락
video_url를 선택 사항으로 처리하고, 가능하면 모델별 결과 필드 또는 콘텐츠 경로를 대신 사용하세요.콜백을 받지 못함
콜백을 받지 못함
폴링을 신뢰할 수 있는 정보원으로 사용하고 콜백 URL이 POST 요청을 수락하는지 확인하세요.
오류 코드 및 재시도 전략
400
400
프롬프트(Prompt), 파일, duration 또는 size 필드를 수정하기 전에는 재시도하지 마세요.
401
401
API 키가 존재하고 유효해질 때까지 재시도하지 마세요.
404
404
재시도하기 전에 작업 ID, 기본 URL, 경로 및 모델 ID를 확인하세요.
413
413
재시도하기 전에 업로드 크기를 줄이세요.
429
429
지수 백오프를 적용해 재시도하고 생성 또는 폴링 동시성을 줄이세요.
500 또는 503
500 또는 503
백오프를 적용해 작업 생성을 재시도하세요. 작업이 최종 오류에 도달하지 않는 한 기존 작업의 폴링을 계속하세요.
가격 및 모델 디렉터리
모델 페이지
CometAPI가 문서에서 모델 ID를 제공하는 방법을 알아보세요.
모델 디렉터리
모델 가용성과 기능을 살펴보세요.
가격
모델을 호출하기 전에 가격을 확인하세요.