Skip to main content
xAI빠름높음

Grok Imagine Video

xAI의 Grok Imagine Video 모델로 비디오를 생성합니다. 텍스트-비디오, 이미지-비디오 변환, 그리고 기존 짧은 비디오 클립 편집을 지원합니다.

580 크레딧
5초 기준(기본값) — 초당 과금 (117/초, 1~15초)
해상도·화면비와 무관한 균일한 초당 과금
텍스트-비디오 및 이미지-비디오 생성 지원
비디오 편집 모드 — 기존 짧은 클립(최대 8.7초)을 프롬프트로 수정
480p 또는 720p 출력, 최대 15초
입력 이미지의 화면비를 자동으로 감지

지금 바로 실행해보세요

콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요

로그인 후 사용해보기

AI 어시스턴트에서 사용하기

이 모델의 사용법을 Claude, ChatGPT 등에 복사

빠른 시작

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "xai/grok-imagine-video",
  "input": {
    "prompt": "a penguin walks away from the camera, towards a large snowy mountaintop in the distance",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

파라미터

파라미터타입필수기본값설명
promptstringYes-비디오 생성을 위한 텍스트 프롬프트
imagestringNo-비디오 생성 기준이 되는 입력 이미지 (이미지-비디오). jpg, jpeg, png, webp 지원
videostringNo-편집할 입력 비디오 (비디오 편집 모드). 직접 링크, 최대 8.7초. mp4, mov, webm 지원
durationintegerNo5비디오 길이 초 (1~15). 비디오 편집 시 무시됨
resolutionstringNo720p비디오 해상도. 비디오 편집 시 무시됨
720p480p
aspect_ratiostringNoauto화면 비율. 텍스트-비디오는 16:9, 이미지-비디오는 입력 이미지의 비율이 기본값. 비디오 편집 시 무시됨
auto16:94:31:19:163:43:22:3

파일 입력 방법

이 모델의 imagevideo 파라미터에 파일을 전달하는 방법은 3가지입니다.

추천

간편 업로드 (Multipart)

POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=xai/grok-imagine-video" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

이미지 URL 전달

공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.

{
  "model": "xai/grok-imagine-video",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}
File Upload 문서에서 Presigned URL 방식 등 더 자세한 업로드 방법을 확인하세요.

공통 파라미터

POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.

파라미터타입필수기본값설명
modelstringYes-모델 식별자
inputobjectYes-위 테이블의 모델별 파라미터를 포함하는 객체
output_folderstringNo-결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가)
webhook_urlstringNo-완료 시 호출할 Webhook URL
is_publicbooleanNofalsetrue 시 결과물을 영구 공개 URL로도 제공

예제

텍스트-비디오 (720p)

텍스트 프롬프트만으로 5초 클립 생성

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "xai/grok-imagine-video",
  "input": {
    "prompt": "a penguin walks away from the camera, towards a large snowy mountaintop in the distance",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

롱 클립 (15초)

최대 길이인 15초, 동일한 균일 초당 요금으로 과금

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "xai/grok-imagine-video",
  "input": {
    "prompt": "a lone astronaut walking across a red Martian desert as twin suns set on the horizon",
    "duration": 15,
    "resolution": "480p",
    "aspect_ratio": "21:9"
  }
}'

팁 & 모범 사례

1해상도·화면비와 무관하게 초당 $0.05 균일 요금이므로 파일 크기가 중요하지 않다면 720p를 선택하세요
2길이는 1~15초이며, 길어질수록 비례해서 과금되고 별도 할인은 없습니다
3비디오 편집 모드에서는 duration·resolution 입력이 무시되고 원본 클립 길이가 유지됩니다
4aspect_ratio를 auto로 두면 텍스트 프롬프트는 16:9, 이미지 입력은 해당 이미지 비율을 자동으로 사용합니다

사용 사례

소셜 콘텐츠용 빠른 텍스트-비디오 클립
정지 이미지를 짧은 모션으로 애니메이션화
텍스트 지시로 기존 비디오 클립 편집
균일 요금으로 최대 15초까지 길이 실험
명시적 화면비를 활용한 세로·정사각형 클립 제작