xai/grok-imagine-video-1.5-preview에 대한 API 레퍼런스입니다. 이 모델은 Comfy Router가 xAI로부터 제공합니다.
빠른 시작
Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다.
모델 ID: xai/grok-imagine-video-1.5-preview
엔드포인트: POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5-preview
- Wait for the result
- Queue and collect later
스키마
입력
string
기본값:"\"16:9\""
생성된 비디오의 화면 비율가능한 값:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3integer
기본값:"8"
비디오 재생 시간(초). 범위 [1, 15]. 기본값 8.범위:
1 ~ 15object
xAI 엔드포인트용 입력 이미지 객체
string
이미지 입력의 유형가능한 값:
image_urlstring
필수
입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI)
string
사용할 모델. 지원 대상: grok-imagine-video(기본값), grok-imagine-video-1.5-preview, grok-imagine-video-1.5. 지원 중단된 grok-imagine-video-beta id는 grok-imagine-video의 별칭입니다.
object
생성된 비디오의 선택적 출력 대상
string
필수
비디오 생성을 위한 프롬프트. 최대 4,096자.
object[]
비디오 생성을 안내하는 하나 이상의 레퍼런스 이미지(레퍼런스 기반 비디오 생성 모드). image와 함께 사용할 수 없습니다. Router는 application/json만 전달하며 이 객체와 XAIImageObject 모두 file_id를 허용하지 않으므로, 이 경로에서는 파일 기반 이미지 입력이 지원되지 않습니다.
string
필수
레퍼런스 이미지의 URL. HTTPS URL(공개) 또는 base64로 인코딩된 데이터 URL(예: data:image/jpeg;base64,…)을 지원합니다.
string
출력 비디오의 해상도
string
출력 비디오의 크기
string
최종 사용자를 나타내는 고유 식별자
GET /v2/models/xai/grok-imagine-video-1.5-preview/openapi.json에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다.
출력
string
요청이 입력 검열로 인해 차단된 경우 차단 사유를 포함합니다
string
비디오 생성에 사용된 모델
string
지연된 요청의 상태: “pending” 또는 “done”가능한 값:
pending, doneobject
비디오 생성 요청에 대한 사용량 정보
integer
이 요청의 비용을 USD 틱으로 나타낸 값입니다. 1 미국 센은 100,000,000틱이므로 1 미국 달러는 10,000,000,000틱입니다.
object
xAI에서 생성된 비디오
integer
생성된 비디오의 재생 시간(초)
boolean
모델이 생성한 비디오가 검열 규칙을 준수하는지 여부
string
생성된 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않은 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없는 경우에는 이 필드가 xAI 자체의 수명이 짧은 URL을 그대로 유지합니다. NULLABLE:
url이 비어 있는 성공은 완료된 생성이 아닙니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요.예시
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 유효성 검사 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대체 방법.