개요
Grok Imagine Video는 xAI 동영상 모델을 위한 공식 채널입니다. 요청은 APIYI에 의해 공식 xAI API로 릴레이되며, 가격은 xAI 정가와 동일하고 생성된 초 및 해상도에 따라 과금됩니다. 이 API는 텍스트-동영상 및 이미지-동영상을 지원하는 OpenAI Videos 호환 비동기 태스크 엔드포인트(/v1/videos)이며, 모든 동영상에는 오디오 트랙이 포함됩니다.
사용 가능한 모델은 세 가지입니다:
grok-imagine-video: 기본 모델, 480p / 720pgrok-imagine-video-1.5: 최신 모델, 480p / 720p / 1080pgrok-imagine-video-1.5-lite: 경량화된 1.5 모델, 480p / 720p에서 가장 저렴한 가격 제공
동영상 생성 API
Grok Imagine 공식 이미지
GrokOfficial 그룹 — xAI와 동일한 티어별 가격이 책정되는 이미지 생성입니다.AI 에이전트로 연동하기
이 prompt를 복사하여 Codex / Claude Code / Cursor에 붙여넣으십시오
먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 docs URL 뒤에 .md 추가), 사용 중인 스택에 맞는 코드를 작성합니다. 비동기 3단계 흐름, 480p / 8초 기본값, 과금되는 검토 차단, 동영상을 즉시 저장하는 요건이 이미 포함되어 있습니다.
이 프로젝트에서 Grok Imagine 동영상 생성(text-to-video + image-to-video)을 연동/문제 해결합니다.
코드를 작성하기 전에 문서를 확인하십시오. 이 페이지의 일반 텍스트 버전을 가져오려면 https://docs.apiyi.com/en/api-capabilities/grok-imagine-video/overview.md 를 호출하십시오. …
- 모델을 하나 선택하십시오:
grok-imagine-video,grok-imagine-video-1.5또는grok-imagine-video-1.5-lite…
총 8가지 요구사항 — 아래 버튼을 사용하여 전체 버전을 복사하십시오
모델 및 요금
요금은 xAI의 정가와 동일하며 생성된 동영상 초당 기준으로 과금됩니다. 요율은 모델 및 해상도에 따라 달라집니다:- 비용 = 초 수 × 초당 요율 + 입력 이미지 수 × 이미지당 요금. 예시:
grok-imagine-video에서 1초 480p 이미지-투-비디오 작업의 경우 = 1 × $0.05 + 1 × $0.002 = $0.052(당사 테스트 청구 내역과 일치). - 기본값도 과금됩니다:
size/seconds를 지정하지 않으면 작업이 480p로 8초 동안 실행되며,grok-imagine-video기준 $0.40가 부과됩니다. - 오디오는 별도로 과금되지 않습니다: 동영상에는 기본적으로 오디오 트랙이 포함되며, 이를 비활성화해도 요금이 할인되지 않습니다.
- 검토 차단 시에도 과금됩니다: xAI는 모더레이션 시스템에 의해 차단된 동영상에 대해서도 요금을 청구하며, 당사 또한 동일한 기준으로 과금합니다. 자세한 내용은 FAQ를 참조하십시오.
- 구간별 충전 보너스가 추가로 적용됩니다. 대규모 비즈니스 고객의 경우 영업팀에 문의하여 전용 요율을 안내받으실 수 있습니다.
그룹 설정
접근 권한 신청 대상
신청 방법
WeCom 고객지원 문의
GrokOfficial(Grok Imagine 공식) 권한을 신청한다고 명시해 주시기 바랍니다.사용 목적 및 검토 제어 방안 설명
승인 후 Token 그룹 전환
GrokOfficial이(가) 활성화됩니다. 콘솔의 Token 페이지로 이동하여 이 채널에 사용하는 Token을 GrokOfficial(으)로 전환하고, 과금 방식을 Pay-as-you-go Priority 또는 Pay-as-you-go(으)로 설정하십시오.GrokOfficial 그룹이 없는 Token은 **503(현재 그룹에 사용 가능한 채널 없음)**을 반환합니다. 재시도해도 해결되지 않으며, 먼저 그룹을 활성화해야 합니다.Pay-per-request 과금 방식을 사용하지 마십시오: 이 채널은 초당 과금되므로, 요청당 과금 Token은 라우팅될 수 없으며 동일하게 503을 반환합니다.기술 사양
엔드포인트
엔드투엔드 흐름 (Python)
주요 파라미터
size (해상도 및 가로세로 비율)
size은(는) WIDTHxHEIGHT 픽셀을 사용하며, 게이트웨이는 더 짧은 변을 기준으로 해상도 티어를 선택하고 가로세로 비율을 지원되는 가장 가까운 비율로 맞춥니다:
"480p" / "720p" / "1080p"를 직접 전달하거나, size을(를) 생략하고 xAI 기본 필드인 resolution(480p / 720p / 1080p) 및 aspect_ratio(예: 9:16)을(를) 함께 보낼 수도 있습니다. 둘 다 제공된 경우 resolution / aspect_ratio이(가) 우선 적용됩니다. 둘 다 지정하지 않으면 동영상은 480p로 생성됩니다.
seconds (재생 시간)
문자열("5") 또는 숫자(5) 형태의 1~15 사이의 정수이며, 기본값은 8입니다. 범위를 벗어난 값은 400: duration must be an integer between 1 and 15을(를) 반환합니다. 비용은 초 단위에 비례하므로 테스트 시에는 1~2초를 사용하는 것이 좋습니다.
input_reference (이미지 투 비디오)
입력 이미지 1개를 전달하면 작업을 이미지 투 비디오로 전환할 수 있습니다. 다음 세 가지 형식 중 어느 것이든 사용할 수 있습니다:
- 공개 이미지 URL:
"input_reference": "https://example.com/first-frame.jpg" - base64 데이터 URI:
"input_reference": "data:image/jpeg;base64,/9j/4AAQ..." - Multipart 파일 업로드:
-F "[email protected]"
prompt을(를) 사용하여 움직임과 카메라 워크를 설명하십시오(예: “고양이가 천천히 고개를 돌린다”). 출력 프레임은 입력 이미지를 따릅니다. 입력 이미지는 장당 $0.002(grok-imagine-video) 또는 $0.01(1.5 / 1.5-lite)의 추가 비용이 발생합니다.
모범 사례
1~2초 및 480p로 prompt 테스트
grok-imagine-video-1.5-lite은(는) 480p / 720p 요율이 가장 낮아 대량 탐색 작업에 적합합니다.항상 size 및 seconds 전달
전체 제한 시간을 설정하고 5~10초마다 폴링
모더레이션 차단 처리
error.code을(를) 확인하십시오. moderation_blocked은(는) 작업이 차단되었고 동영상이 없으며 과금되었음을 의미합니다. 그대로 재시도하기보다는 내용을 수정하여 다시 제출하십시오.동영상 즉시 저장
/content에서 작업이 completed 상태가 되는 즉시 다운로드하십시오. 다운로드 링크를 장기간 보관하거나 최종 사용자에게 제공하지 마십시오.오류 코드 및 재시도
자주 묻는 질문
모든 호출에서 503이 반환됩니다 — 채널에 장애가 발생했습니까?
모든 호출에서 503이 반환됩니다 — 채널에 장애가 발생했습니까?
GrokOfficial이(가) 없거나 Token의 과금 모드가 요청당 결제인 경우입니다. 전자의 경우 그룹 설정을 통해 신청하시고, 후자의 경우 과금 모드를 Pay-as-you-go Priority 또는 Pay-as-you-go(으)로 전환하십시오.동영상이 왜 480p 및 8초로 생성됩니까?
동영상이 왜 480p 및 8초로 생성됩니까?
size 및 seconds을(를) 지정하지 않으면 작업이 480p, 8초 기준으로 생성되고 과금됩니다. size(예: "1280x720") 및 seconds을(를) 명시적으로 전달하십시오.작업이 완료되었다고 표시되는데 다운로드할 동영상이 없습니까?
작업이 완료되었다고 표시되는데 다운로드할 동영상이 없습니까?
error.code: "moderation_blocked"을(를) 확인하십시오. 해당 항목이 있다면 xAI의 콘텐츠 검토 정책에 의해 동영상이 차단된 것입니다. 작업 상태는 여전히 completed(으)로 보고되지만 동영상이 제공되지 않으며, 과금도 진행됩니다(xAI는 차단된 동영상에 대해서도 비용을 청구합니다). prompt나 입력 이미지를 조정한 후 다시 제출하십시오.오디오를 제외하면 더 저렴합니까?
오디오를 제외하면 더 저렴합니까?
이미지-투-비디오 결과물 크기가 전송한 이미지 크기와 일치하지 않는 이유는 무엇입니까?
이미지-투-비디오 결과물 크기가 전송한 이미지 크기와 일치하지 않는 이유는 무엇입니까?
동영상 편집, 확장 또는 다중 참조 이미지가 지원됩니까?
동영상 편집, 확장 또는 다중 참조 이미지가 지원됩니까?
세 가지 모델 중 어떤 것을 선택해야 합니까?
세 가지 모델 중 어떤 것을 선택해야 합니까?
- 1080p 필요 시 →
grok-imagine-video-1.5(최고 품질) 또는grok-imagine-video-1.5-lite(더 저렴함) - 적은 예산으로 480p / 720p 대량 작업 시 →
grok-imagine-video-1.5-lite(초당 $0.02 / $0.03) - 이미 기본 모델을 사용 중이며 480p / 720p만 필요한 경우 →
grok-imagine-video
관련 문서
- Grok Imagine 동영상 생성 API - Playground가 포함된 제출 엔드포인트 레퍼런스
- Grok Imagine 공식 이미지 - 동일 그룹, 티어별 xAI와 동일한 가격 책정
- Grok 모델 가이드 - xAI 텍스트 모델
- 충전 보너스