메인 콘텐츠로 건너뛰기

개요

Grok Imagine Video는 xAI 동영상 모델을 위한 공식 채널입니다. 요청은 APIYI에 의해 공식 xAI API로 릴레이되며, 가격은 xAI 정가와 동일하고 생성된 초 및 해상도에 따라 과금됩니다. 이 API는 텍스트-동영상 및 이미지-동영상을 지원하는 OpenAI Videos 호환 비동기 태스크 엔드포인트(/v1/videos)이며, 모든 동영상에는 오디오 트랙이 포함됩니다. 사용 가능한 모델은 세 가지입니다:
  • grok-imagine-video: 기본 모델, 480p / 720p
  • grok-imagine-video-1.5: 최신 모델, 480p / 720p / 1080p
  • grok-imagine-video-1.5-lite: 경량화된 1.5 모델, 480p / 720p에서 가장 저렴한 가격 제공
🔒 이 채널은 GrokOfficial 그룹이 필요하며, 신청 시 부여됩니다Grok Imagine Video는 Default 그룹에 포함되어 있지 않습니다. 이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 크게 다르므로, 컴플라이언스 리스크를 제한하기 위해 접근 권한을 선별적으로 부여합니다:
  • 누적 사용 금액이 $1,000+인 기존 고객: 지원팀에 문의하여 사용 사례를 설명해 주시면 확인 후 활성화해 드립니다
  • 그 외 모든 사용자: WeCom 지원팀을 통해 신청하고 사용 사례와 콘텐츠 검수 제어 장치를 설명해 주시면 승인 후 활성화해 드립니다
GrokOfficial 그룹이 없는 Token은 **503**를 반환합니다. 이는 서비스 장애가 아닌 권한 문제입니다. 아래의 그룹 설정을 참고하십시오.
⚠️ size가 없으면 기본값은 480p 및 8초입니다해상도나 재생 시간 없이 제출하면 동영상이 480p, 8초로 생성 및 과금됩니다. 720p / 1080p 또는 더 짧은 클립을 원하시면 size(예: "1280x720") 및 seconds을 명시적으로 전달하십시오.

동영상 생성 API

인터랙티브 Playground를 통해 텍스트-동영상 / 이미지-동영상 작업을 제출합니다.

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 를 호출하십시오. …

  1. 모델을 하나 선택하십시오: 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를 참조하십시오.
  • 구간별 충전 보너스가 추가로 적용됩니다. 대규모 비즈니스 고객의 경우 영업팀에 문의하여 전용 요율을 안내받으실 수 있습니다.

그룹 설정

Grok Imagine Video는 Default 그룹에 포함되어 있지 않습니다. 이 모델은 Grok Imagine 공식 이미지와 공유되는 **GrokOfficial 그룹(xAI와 동일한 가격, 즉 위의 표 참조)**에 속해 있으며, 접근 권한을 신청해야 합니다.

접근 권한 신청 대상

신청 방법

1

WeCom 고객지원 문의

WeCom 고객지원 또는 이메일([email protected])로 신청해 주십시오. GrokOfficial(Grok Imagine 공식) 권한을 신청한다고 명시해 주시기 바랍니다.
2

사용 목적 및 검토 제어 방안 설명

동영상의 용도, 최종 사용자, 그리고 귀사 측에서 실행하는 콘텐츠 검토 및 수동 점검 방식의 세 가지 항목을 포함해 주십시오. 구체적일수록 심사가 빨라집니다.
3

승인 후 Token 그룹 전환

승인되면 계정에 GrokOfficial이(가) 활성화됩니다. 콘솔의 Token 페이지로 이동하여 이 채널에 사용하는 Token을 GrokOfficial(으)로 전환하고, 과금 방식을 Pay-as-you-go Priority 또는 Pay-as-you-go(으)로 설정하십시오.
접근 권한이 부여되기 전 표시 내용: GrokOfficial 그룹이 없는 Token은 **503(현재 그룹에 사용 가능한 채널 없음)**을 반환합니다. 재시도해도 해결되지 않으며, 먼저 그룹을 활성화해야 합니다.Pay-per-request 과금 방식을 사용하지 마십시오: 이 채널은 초당 과금되므로, 요청당 과금 Token은 라우팅될 수 없으며 동일하게 503을 반환합니다.
규정 준수 안내: 접근 권한이 부여된 후 생성된 콘텐츠에 대한 책임은 호출자에게 있습니다. 현지 법률 및 규정을 준수하십시오. 불법 콘텐츠, 타인의 초상권이나 지식재산권을 침해하는 콘텐츠, 미성년자에게 부적절한 콘텐츠를 생성해서는 안 됩니다. 일반 소비자 대상 배포의 경우 자체 검토 레이어를 추가하십시오. 배경 정보: 해외 모델 호출 규정 준수 안내. 오남용이 발견될 경우 그룹 접근 권한이 회수됩니다.

기술 사양

엔드포인트

기본 도메인은 https://api.apiyi.com, 보조 도메인은 https://b.apiyi.com입니다. 전체 코드 예제: 동영상 생성 API.

엔드투엔드 흐름 (Python)

주요 파라미터

size (해상도 및 가로세로 비율)

size은(는) WIDTHxHEIGHT 픽셀을 사용하며, 게이트웨이는 더 짧은 변을 기준으로 해상도 티어를 선택하고 가로세로 비율을 지원되는 가장 가까운 비율로 맞춥니다: "480p" / "720p" / "1080p"를 직접 전달하거나, size을(를) 생략하고 xAI 기본 필드인 resolution(480p / 720p / 1080p) 및 aspect_ratio(예: 9:16)을(를) 함께 보낼 수도 있습니다. 둘 다 제공된 경우 resolution / aspect_ratio이(가) 우선 적용됩니다. 둘 다 지정하지 않으면 동영상은 480p로 생성됩니다.
grok-imagine-video은(는) 480p / 720p만 지원하며, 1080p급 size은(는) 400: grok-imagine-video resolution must be one of 480p, 720p을(를) 반환합니다.

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

1~2초 및 480p로 prompt 테스트

과금은 초 단위로 이루어지므로 720p / 1080p로 최종 길이를 렌더링하기 전에 짧은 저해상도 클립으로 결과물을 확인하십시오. grok-imagine-video-1.5-lite은(는) 480p / 720p 요율이 가장 낮아 대량 탐색 작업에 적합합니다.
2

항상 size 및 seconds 전달

해당 값을 생략하면 480p 및 8초로 지정되며, 이는 “왜 이렇게 비싼가요” 및 “왜 이렇게 흐릿한가요”라는 의문이 생기는 가장 흔한 원인입니다.
3

전체 제한 시간을 설정하고 5~10초마다 폴링

작업은 일반적으로 20초에서 2분 이내에 완료됩니다. 더 빠르게 폴링하더라도 얻을 수 있는 이점이 없습니다. 전체 대기 시간은 최대 10분으로 제한하고, 시간 초과 시 문제 해결을 위해 작업 ID를 기록하십시오.
4

모더레이션 차단 처리

상태 응답에서 error.code을(를) 확인하십시오. moderation_blocked은(는) 작업이 차단되었고 동영상이 없으며 과금되었음을 의미합니다. 그대로 재시도하기보다는 내용을 수정하여 다시 제출하십시오.
5

동영상 즉시 저장

/content에서 작업이 completed 상태가 되는 즉시 다운로드하십시오. 다운로드 링크를 장기간 보관하거나 최종 사용자에게 제공하지 마십시오.

오류 코드 및 재시도

자주 묻는 질문

거의 확실하게 권한 문제입니다. Token 그룹에 GrokOfficial이(가) 없거나 Token의 과금 모드가 요청당 결제인 경우입니다. 전자의 경우 그룹 설정을 통해 신청하시고, 후자의 경우 과금 모드를 Pay-as-you-go Priority 또는 Pay-as-you-go(으)로 전환하십시오.
해당 설정은 기본값입니다. size 및 seconds을(를) 지정하지 않으면 작업이 480p, 8초 기준으로 생성되고 과금됩니다. size(예: "1280x720") 및 seconds을(를) 명시적으로 전달하십시오.
상태 응답에서 error.code: "moderation_blocked"을(를) 확인하십시오. 해당 항목이 있다면 xAI의 콘텐츠 검토 정책에 의해 동영상이 차단된 것입니다. 작업 상태는 여전히 completed(으)로 보고되지만 동영상이 제공되지 않으며, 과금도 진행됩니다(xAI는 차단된 동영상에 대해서도 비용을 청구합니다). prompt나 입력 이미지를 조정한 후 다시 제출하십시오.
아닙니다. 동영상에는 기본적으로 오디오 트랙이 포함되며, xAI의 가격 정책에 따라 오디오를 꺼도 가격이 낮아지지 않습니다.
이미지-투-비디오는 입력 이미지의 프레임을 따릅니다. 특정 화면 비율을 원하시면 제출 전에 입력 이미지를 해당 비율로 자르십시오.
본 채널은 현재 텍스트-투-비디오 및 단일 입력 이미지를 사용하는 이미지-투-비디오만 지원합니다. 동영상 편집, 확장 등의 기능은 아직 지원되지 않으며, 추후 지원 시 본 페이지에 업데이트될 예정입니다.
  • 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

관련 문서