grok-imagine-video-1.5-preview

Grok Imagine Video 1.5는 1080p를 포함해 텍스트로 1~15초 동영상을 만듭니다. 모델 자체는 이미지 애니메이션, 시각적 참고 자료, 키프레임 연출, 오디오 트랙을 지원합니다.

Ailoot · 동영상 POST /v1/videos/generations grok-imagine-video-1.5-preview

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

동영상 장면 만들기

Grok Imagine Video 1.5는 텍스트 설명과 시각 자료로 동영상을 생성하는 xAI 모델입니다. 현재 Ailoot 호출 방식에는 텍스트 생성이 공개되어 있습니다. 모델 자체의 추가 모드는 이미지 애니메이션, 참고 자료 사용, 장면의 기준 프레임 지정을 가능하게 합니다.

결과는 비동기로 만들어집니다. 작업을 설정한 뒤 식별자로 준비 상태를 확인합니다. xAI에 따르면 과정은 장면의 복잡도, 길이, 해상도에 따라 몇 분이 걸릴 수 있습니다. 작업 식별자를 받았다고 동영상이 준비된 것은 아닙니다.

길이, 비율, 해상도

생성되는 동영상은 1~15초입니다. 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3을 선택할 수 있습니다. 텍스트의 기본 비율은 16:9입니다. 이미지 애니메이션에서는 기본적으로 원본 비율을 유지합니다.

텍스트와 시작 이미지의 생성에는 480p, 720p, 1080p를 사용할 수 있습니다. 기본은 480p이며, 참고 자료 모드는 720p로 제한됩니다. 모델에 1080p가 있다는 이유로 모든 모드에 적용할 수는 없습니다.

외형 제어

xAI 참고 자료 모드는 최대 7개 이미지를 입력받습니다. 시작 프레임을 고정하지 않고 인물, 사물, 의상, 기타 시각적 특징을 지정합니다. 반복되는 캐릭터, 제품 소개, 서로 다른 연출 사이에서 필요한 외형 유지에 사용하는 방식입니다.

첫 프레임, 마지막 프레임, 중간 프레임

1.5 버전은 정확한 첫 프레임, 정확한 마지막 프레임, 또는 둘 모두를 고정할 수 있습니다. 마지막 프레임만 지정하면 모델이 시작 부분을 직접 구성하고 지정된 이미지로 이어집니다. 두 경계를 지정하면 그 사이의 움직임을 만듭니다. 텍스트 지시로 움직임과 카메라 작업을 구체화할 수 있습니다.

동영상 안의 스토리보드를 위해 최대 4개 키프레임을 고정할 수 있습니다. 각 시간은 시작 이후와 끝 이전에 엄격하게 위치해야 하며, 1/3초 격자에 맞춰 연결합니다. 같은 격자 시점으로 반올림되는 두 프레임은 거부됩니다. 이를 피하려면 사이에 최소 1/3초를 두세요. 첫 프레임과 마지막 프레임은 이 네 개의 중간 프레임과 별도로 지정합니다.

기준 프레임은 시각적 참고 자료와 미리 제공된 목소리를 함께 사용할 수 있습니다. 하나라도 프레임을 고정하면 텍스트 설명은 선택 사항입니다. 이미지 순서 자체가 장면을 정합니다. 키프레임은 동영상 편집 모드와 함께 사용할 수 없습니다. 이런 xAI 기능이 공개된 Ailoot 텍스트 생성에서 사용 가능하다는 뜻은 아닙니다.

사운드와 목소리

생성된 동영상에는 기본으로 오디오 트랙이 포함되며 무음 결과도 제공합니다. xAI의 목소리 참고 모드에서는 최대 3개 기본 목소리를 선택해 장면의 발화 참여자와 연결할 수 있습니다.

자체 오디오 파일을 음성 샘플로 전달하는 것은 이 모델의 일반 기능이 아닙니다. xAI가 요청에 따라 별도로 제공합니다. 기본 목소리와 업로드한 오디오는 서로 다른 입력 유형입니다.

작업 모드

텍스트 생성은 새로운 장면을 만들고, 시작 이미지는 출발점을 정하며, 참고 자료는 외형을 유도하고, 고정 프레임은 시간상의 시각적 지점을 정합니다. 모드마다 제한이 있으므로 한 방식의 설정을 다른 방식에 무조건 적용해서는 안 됩니다.

Ailoot · 동영상 POST /v1/videos/generations grok-imagine-video-1.5-preview

grok-imagine-video-1.5-preview

xAI /grok-imagine-video-1.5-preview

시작하기

허용 입력: 텍스트
결과: 동영상

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot · 동영상 POST /v1/videos/generations

입력: text
출력: video
출력 형식: mp4

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 grok-imagine-video-1.5-preview	기본값—
필드`prompt`	유형`string`	요건선택 사항	값과 한도 최소 길이: 1	기본값—
필드`duration`	유형`integer`	요건선택 사항	값과 한도 최솟값: 1 최댓값: 15 조건: duration과 seconds를 동시에 제공하지 마세요. 단위: 초	기본값1
필드`seconds`	유형`integer\|integer_string`	요건선택 사항	값과 한도 최솟값: 1 최댓값: 15 대안: duration	기본값—
필드`resolution`	유형`string`	요건선택 사항	값과 한도 480p, 720p, 1080p	기본값480p
필드`aspect_ratio`	유형`string`	요건선택 사항	값과 한도 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 조건: 이미지 입력을 제공하고 화면 비율을 생략하면 공급자는 이미지의 화면 비율을 그대로 사용합니다.	기본값16:9
필드`size`	유형`string`	요건선택 사항	값과 한도 1280x720, 720x1280, 1920x1080, 1080x1920 조건: 이 값과 resolution/aspect_ratio를 함께 지정하면 서로 일치해야 합니다.	기본값—
필드`image`	유형`object`	요건선택 사항	값과 한도 조건: 실제로 지원되는 입력 이미지입니다. 프롬프트 생략을 허용합니다.	기본값—

입력 자료 조합

텍스트로 동영상 생성 · 필수: prompt

이미지로 동영상 생성 · 필수: image

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`material_types`	명세text
매개변수`required`	명세null
매개변수`optional_controls`	명세null

수명 주기: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

메서드 형식과 ID는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다.

요금

Ailoot 메서드 요금

Ailoot 동영상POST /v1/videos/generations

입력: US$0.01 입력 이미지당
출력: US$0.25 1080p 해상도 초당
출력: US$0.08 480p 해상도 초당
출력: US$0.14 720p 해상도 초당

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot · 동영상

동영상 예제

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

결과 수신 및 저장

Ailoot · 동영상

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

작업 상태 확인

GET · 상태 조회

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

기타 콘텐츠 조회

GET · 콘텐츠 조회

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

완료된 결과 모두 보관

완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.

상태 JSON 전체와 실제 request_id를 보존하세요. status=done인 완료 응답에는 소유한 콘텐츠 URL이 있는 video.url이 포함됩니다. 보고된 길이와 반환된 모든 결과 필드를 유지하세요.

원래 응답을 확인해야 할 경우

기존 원래 작업을 조회하세요. 전송 결과를 알 수 없는 요청을 절대로 다시 제출하지 마세요.

응답 필드

필드	유형
필드`request_id`	유형string
필드`id`	유형string
필드`status`	유형string
필드`video.url`	유형owned signed content URL
필드`video.duration`	유형number
필드`video.respect_moderation`	유형boolean

오류와 다음 단계

응답	조건	다음 단계
응답400 · `invalid_request_error`	조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음	다음 단계새 생성 요청 전에 표시된 필드를 수정하세요.
응답409 · `video_not_ready`	조건원래 결과 콘텐츠를 아직 사용할 수 없음	다음 단계원래 반환된 ID를 폴링하고 Retry-After를 준수하세요.
응답`server_error`	조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다	다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요.

별칭

모델 별칭

Ailoot grok-imagine-video-1.5-preview

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

grok-imagine-video-1.5-preview