비디오 생성

텍스트 기반 비디오 생성, 이미지 기반 비디오 생성 및 Video-to-Video Remix를 지원합니다.

POST/v1/video/generations

Grok 비디오 생성 작업을 생성하며 텍스트 기반 비디오 생성, 이미지 기반 비디오 생성 및 Video-to-Video Remix를 지원합니다.

모델 ID 예시는 grok-imagine-video입니다. 예시는 MODEL_ID를 사용하며 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Grok 비디오 생성 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Grok 비디오 모델 ID입니다. 예를 들어 grok-imagine-video입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

생성하거나 다시 그릴 비디오 내용을 설명합니다.

길이1 <= length

duration?integer

비디오 길이이며 단위는 초입니다. 텍스트／이미지 기반 비디오 생성에만 적용됩니다. 범위는 1–15이며 기본값은 5입니다. Remix 모드는 이 필드를 지원하지 않으며 출력 길이는 입력 비디오와 같고 최대 8.7초입니다.

범위1 <= value <= 15

기본값5

images?array<string>

이미지 기반 비디오 생성에 사용하는 입력 이미지 목록입니다. image와 둘 중 하나만 지정하면 됩니다.

image?string

이미지 기반 비디오 생성에 사용하는 단일 이미지입니다. 공개 URL 또는 Base64 Data URI일 수 있습니다. images와 둘 중 하나만 지정하면 됩니다.

metadata?

업스트림에 전달하는 확장 매개변수입니다. 이 객체로 seed, negative_prompt, fps 등 Grok이 지원하는 다른 고급 매개변수를 전달할 수 있습니다.

플랫폼은 요청 매개변수에 따라 사용 한도 소모량을 동적으로 계산합니다. 대사 및 재현을 위해 애플리케이션에서도 metadata를 함께 보관해야 합니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "구름 위의 사이버펑크 도시",
    "duration": 5,
    "image": "https://example.com/init-frame.png",
    "metadata": {
      "resolution": "720p"
    }
  }'

{
  "id": "xai-task-12345"
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`