동영상

일관된 제품 맵을 유지하기 위해 해외 문서 구조에 비디오 생성이 포함되어 있지만 퍼블릭 엔드포인트 가용성은 해외 OpenAPI 스키마 및 계정 구성에서 확인되어야 합니다.

요구

비디오 엔드포인트가 활성화되면 비동기 작업 모델이 필요합니다. 생성 요청에는 일반적으로 프롬프트, 모델, 기간, 종횡비, 선택적 프레임 또는 참조 미디어가 포함됩니다. 모든 요청은 베어러 인증을 사용합니다.

Authorization: Bearer KITTA_API_KEY

GET /api/openapi.json에서 반환된 엔드포인트 경로만 사용하세요. 다른 배포의 경로를 해외 클라이언트로 복사하지 마십시오.

응답

비디오 작업 응답은 일반적으로 작업 ID와 상태를 먼저 반환한 다음 완료 후 결과 비디오 URL을 반환합니다. 비디오 생성은 브라우저 세션보다 오래 지속될 수 있으므로 작업 ID와 원본 프로젝트 ID를 함께 저장하십시오.

청구 및 크레딧

비디오 작업은 비용이 많이 들 수 있습니다. 장기간, 고해상도 또는 일괄 생성에 대한 사용자 확인을 시행합니다. 배치를 생성하기 전에 프로필을 확인하고 크레딧이 부족하면 대기열을 일시 중지하세요.

오류

잘못된 프롬프트, 지원되지 않는 모델, 연결할 수 없는 참조 미디어, 부족한 크레딧, 처리 실패를 처리합니다. 스키마가 비디오 엔드포인트를 노출하지 않는 경우 숨겨진 경로를 시도하는 대신 기능을 사용할 수 없는 것으로 표시합니다.

현재 공개 엔드포인트

검증된 모델은 GET /api/open/v1/media/models?mediaType=video, 작업 생성은 POST /api/open/v1/media/videos/jobs, 조회는 GET /api/open/v1/media/videos/jobs/{jobId}를 사용합니다. 생성 요청에는 고유한 Idempotency-Key가 필수이며, 같은 키로 재시도하면 중복 생성이나 과금 없이 최초 응답을 반환합니다. 웹 회원 크레딧이 아닌 API 쿼터를 사용하며 생성, 저장, 비동기 처리 또는 시간 초과 실패 시 멱등하게 환불됩니다.