Grok Imagine Video 1.5

Grok Imagine Video 1.5는 xAI의 동영상 모델입니다. 요청 한 번으로 프롬프트, 또는 프롬프트와 이미지 한 장에서 480p 또는 720p, 16:9, 9:16 또는 1:1의 6~15초 사운드 포함 클립을 만듭니다. 요청을 보내고, 반환된 태스크 ID를 보관한 뒤, 완성된 동영상을 태스크에서 읽어 오세요. 이미지는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.

파라미터

스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.

이미지로 동영상 생성

image_urls에 이미지 한 장을 넣고, prompt에 다음에 무슨 일이 일어나는지 설명하세요. 클립은 그 이미지로 시작하며 이미지의 화면 형태를 유지하므로, 세로 이미지를 넣으면 aspect_ratio 설정과 관계없이 세로 클립이 됩니다.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

미디어 입력

이미지는 공개 HTTP(S) URL입니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. 10 MB 이하의 JPG 또는 PNG 이미지를 사용하세요.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Grok Imagine Video 1.5는 동영상 초 단위로 과금되며, 요율은 해상도로 정해집니다:

cost = duration × rate per second for the resolution

텍스트로 동영상 생성과 이미지로 동영상 생성의 비용은 같습니다. 길이는 요청이 접수될 때 확정되므로, 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다:

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

태스크 조회

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 태스크 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 태스크를 새로 만들지 마세요.

완료된 태스크

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

저희 테스트에서 8초 720p 클립은 AAC 오디오 트랙이 포함된 MP4(H.264)로, 16:9는 1280 × 720, 9:16은 720 × 1280, 1:1은 720 × 720으로 제출 후 111133초 만에 도착했습니다. 480p 클립은 4584초 만에 도착했습니다.

오류

태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 태스크 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

• 피사체, 장소, 카메라 움직임, 조명과 원하는 소리를 설명하세요. 오디오는 화면과 함께 생성됩니다.
• 480p로 초안을 만든 뒤, 같은 요청으로 최종 샷을 720p로 렌더링하세요.
• 세로 동영상은 aspect_ratio: "9:16" 또는 세로 이미지를 보내세요.
• 지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

관련 자료

• Grok Imagine Video 1.5 Playground와 가격
• Kling 3.0 Turbo API 레퍼런스
• OpenAPI 다운로드
• 복사 가능한 Markdown