소개
필수 첫 프레임을 보내고 움직임을 설명합니다. 중간 키프레임으로 배경이 바뀌는 시점을 정할 수 있습니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 영상 |
| 배포사 | xAI |
| 시작 자료 | 장면 설명, 필수 시작 이미지 또는 참조 이미지 1~7장 |
| 프롬프트 한도 | 최대 4,096자 |
| 클립 길이 | 1~15초, 기본 6초 |
| 텍스트·이미지 애니메이션 해상도 | 480p(기본), 720p, 1080p |
| 참조 영상 해상도 | 480p 또는 720p |
| 텍스트 캔버스 비율 | 16:9(기본), 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 이미지 애니메이션은 auto도 제공 |
| 이미지 애니메이션 안내 | 필수 시작 이미지, 선택 마지막 이미지, 시간 지정 keyframes 최대 4장, 선택 참조 1장 |
| 반복 제한 | 시작·마지막 프레임 일치, loop와 |
| 생성 오디오 | 기본 켜짐, 꺼도 같은 요금 |
| 청구 방식 | 영상 초와 해상도별 과금, reference-to-video는 참조당 추가 요금, 실패 요청 무료 |
| 파일 보관 | 생성 영상 파일은 14일 후 삭제 |
핵심 기능 및 하이라이트
속삭임 뒤에 이어지는 반응
황혼의 옥상 바에서 등이 드러나는 빨간 드레스의 여성이 남성에게 기대 ‘Let's get out of here’라고 속삭입니다. 6초 480p 샘플에 이 대사와 남성의 미소·손잡는 행동이 담겼습니다. 짧은 대화는 화자, 인용 대사, 상대의 반응을 정해 계획하고 반환 음성과 움직임을 함께 검토합니다.
대사와 함께 건너는 배
테스트에서 작은 어선이 갈매기가 도는 해뜰 무렵 피오르를 건넜습니다. 6초 결과에는 소리와 선장의 인용 대사가 포함됐습니다.
3초에 온실로 도착
테스트에서 비 오는 등불 골목은 요청한 3초 keyframe에 밝은 빅토리아풍 온실로 바뀌었습니다. 전체는 소리가 있는 6초 장면이었습니다.
처음으로 돌아오는 종이학
흰 종이학이 파란 탁자에서 부드럽게 움직이는 4초 반복 테스트로 시작과 마지막 프레임이 일치했습니다.
무용수와 종이 새를 한 스튜디오에
검은 연습복의 무용수가 흰 스튜디오에서 천천히 움직이며 종이학이 근처에 떠 있었습니다. 두 참조가 6초 848x480 결과를 안내했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 동작과 배경을 적고 원한다면 따옴표로 묶은 대사를 더합니다. 최대 4,096자이며 프롬프트 길이에 따른 요금 단계는 없습니다. 1자 이상 · 4096자 이하 |
image_url | 예 | 애니메이션의 시작 프레임 이미지는 필수입니다. 시작 장면을 정하며 별도 가격 단계를 만들지 않습니다. 1자 이상 |
last_image_url | 아니요 | 마지막 프레임은 선택 사항입니다. loop와 함께 쓸 수 없으므로 loop를 켜면 생략하십시오. 1자 이상 |
reference_image_urls | 아니요 | 참조 이미지 1장을 선택적으로 추가하고 프롬프트에서 @image1로 지정합니다. image-to-video는 초 수와 해상도에 따라 과금합니다. 1개 이하 |
aspect_ratio | 아니요 | auto로 시작 이미지의 비율을 따르거나 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3을 선택합니다. 공통 기본값은 16:9이며 해상도 단가는 바뀌지 않습니다. |
keyframes | 아니요 | 중간 이미지를 최대 4장 제공하고 각각 time_seconds로 영상이 해당 이미지를 거칠 시점을 지정합니다. 키프레임 수에 따른 별도 단가는 없습니다. 기본값: |
loop | 아니요 | 반복하도록 처음과 끝 프레임을 맞춥니다. last_image_url은 함께 보내지 마십시오. 기본값: |
resolution | 아니요 | 480p, 720p 또는 1080p를 선택합니다. 480p가 기본이며 더 높은 해상도는 초당 단가도 높아집니다. |
duration_seconds | 아니요 | 길이는 1–15초로 지정합니다. 생략 시 6초이며 길어질수록 청구할 초 수가 증가합니다. |
generate_audio | 아니요 | 기본 설정은 사운드트랙 생성입니다. 비활성화하면 오디오 트랙을 제외하며 요금은 달라지지 않습니다. 기본값: |
요금
정지 이미지 애니메이션은 선택한 해상도 단계와 출력 초 수로 과금합니다. 사운드트랙 선택은 단가에 영향을 주지 않으며 실패 시 비용이 발생하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.028 / 초 |
| $0.0505 / 초 |
| $0.09 / 초 |
활용 사례
대사로 이끄는 이야기 순간
짧은 인용 대사 하나와 보이는 반응으로 상호작용을 만듭니다. 옥상 샘플은 6초 유성 클립에서 속삭인 제안, 미소, 손잡는 행동을 연결합니다.
도착 시점을 계획한 전환
정한 초에 중간 이미지를 넣어 장소 변경을 안내합니다. 골목·온실 테스트는 6초 장면의 3초에 햇빛 드는 온실에 도달했습니다.
정지 이미지에서 반복 동작
loop를 켜고 시작 이미지가 원점으로 돌아오는 움직임을 만듭니다. 테스트에서는 시작·끝 일치 설정을 따랐습니다. 반복 배치 전 재생 연결부를 확인합니다.
참조로 조립한 장면
인물·소품·장소용 이미지를 따로 주고 프롬프트의 @image 역할을 지정합니다. 참조 작업은 1~7장을 받으며 제공한 각 참조에 과금합니다.
기존 편집에 넣을 무음 장면
기존 사운드트랙을 쓸 때 생성 오디오를 끕니다. 테스트에서는 오디오 트랙이 없었고 영상 요금은 선택 길이와 해상도로 정해졌습니다.
프롬프트 가이드 및 실전 팁
장면의 출발 자료를 고릅니다
글로 쓴 장면은 텍스트, 필수 시작 정지 이미지는 image-to-video, 여러 이미지로 안내할 구도는 reference-to-video를 선택합니다.
행동과 소리를 설명합니다
대상, 의상, 장소, 빛, 다루기 쉬운 행동을 적습니다. 대사를 따옴표로 감싸고 누가 말할지 지정합니다.
시간과 출력을 고릅니다
1~15초, 지원 화면비, 해상도 단계를 정합니다. 정지 이미지 애니메이션은 필요에 따라 시간 지정 keyframes와 마지막 이미지 또는 loop를 추가합니다.
클립을 검토하고 저장합니다
움직임과 대사를 확인하고 반복 연결부나 시간 지정 전환을 살펴봅니다. 생성 파일은 14일 후 삭제되므로 그 전에 채택 영상을 받습니다.
시작 정지 이미지에서 움직임 지시
image-to-video는 필수 image_url과 움직임 지시로 시작합니다. Grok Imagine Video 1.5는 생성 소리와 함께 1~15초 동안 시작 프레임을 움직입니다. 처음 구도가 중요할 때 사용하고 끝이나 중간 순간에 필요한 이미지 안내를 추가합니다.
last_image_url은 마지막 프레임, keyframes는 시간 지정 중간 이미지, loop는 시작·끝 일치를 담당합니다. 선택 참조 한 장도 시각적 안내를 추가합니다. 모든 업로드를 같은 입력으로 다루지 말고 장면 목적에 맞게 고릅니다.
파라미터 안내
| 파라미터 | 역할 | 선택 또는 한도 |
|---|---|---|
image_url | 시작 프레임 | 필수 |
| prompt | 움직임, 장소, 선택 대사 | 최대 4,096자 |
aspect_ratio | 출력 화면비 | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 기본 16:9 |
| resolution | 출력 단계 | 480p, 720p, 1080p, 기본 480p |
duration_seconds | 길이 | 1~15초, 기본 6 |
generate_audio | 생성 사운드 | 기본 켜짐 |
last_image_url | 마지막 프레임 안내 | 선택, loop와 함께 사용 불가 |
reference_image_urls | 시각 참조 안내 | 선택 1장, @image1로 지정 |
| keyframes | 정한 순간의 중간 이미지 | 최대 4장, 각각 time_seconds |
| loop | 시작·끝 프레임 일치 | last_image_url과 함께 사용 금지 |
시작 비율을 따르려면 auto를 선택하고 아니면 용도에 맞는 지원 비율을 고릅니다. 넓은 시야라는 문구는 구도 설명이며 aspect_ratio가 형태를 선택합니다.
시작, 중간, 끝 계획
정한 초에 장소 도착
특정 순간에 특정 이미지를 지나야 하면 keyframes에 클립 내 time_seconds를 지정합니다. 제공 전환 테스트는 비 오는 등불 골목에서 시작해 6초 영상의 3초에 햇빛 드는 온실에 도달합니다.
카메라 이동, 빛의 변화, 도착 환경으로 열리는 과정을 프롬프트에 적습니다. 시간 지정 이미지는 예정된 시각 목표이며 이미지 사이 동작 지시를 대체하지 않습니다.
도착과 귀환 선택
제공 구도로 끝내려면 마지막 이미지를, 시작으로 돌아오려면 loop를 고릅니다. 둘은 함께 쓸 수 없으므로 제출 전 결말을 정합니다.
반복은 종이 사물이 흔들리다가 시작 자세로 돌아오는 등 한정된 동작을 설명합니다. 반복 재생으로 연결부를 봅니다. 테스트는 프레임 일치 설정을 따랐지만 선택 동작 자체도 검토해야 합니다.
기존 구도에서 작성
움직일 대상과 방향·속도를 적은 뒤 카메라 움직임을 따로 정합니다. 인물 장면은 30대 이상과 구체적인 옷·분위기·빛을 적습니다.
인물 사진에서는 시작 이미지의 이브닝드레스와 따뜻한 조명을 유지하며 창 쪽을 보고 웃다가 돌아보게 할 수 있습니다. 선택 참조는 @image1로 부르고 역할을 설명합니다. 사용 권한이 있는 사진과 음성을 쓰고 성인을 묘사하며 사칭하지 않습니다.
인용 대사를 생성 사운드에 넣을 수 있습니다. 무음이면 generate_audio를 끕니다. 테스트는 오디오 트랙 없이 반환됐습니다. 채택할 때 소리와 움직임을 함께 봅니다.
관찰된 동작
각 요청에서 마지막 프레임, loop, keyframes 제어를 확인했습니다. 유성 6초 전환은 3초에 온실에 도달했습니다. 해당 제어와 전환의 근거이며 임의 이미지 사이 모든 움직임을 보장하지 않습니다.
생성 후 시작, 요청 중간 순간, 끝을 제공 이미지와 비교하고 그 사이 움직임도 살펴봅니다.
과금과 보관
길이와 해상도로 과금하며 상위 단계는 초당 더 비쌉니다. 소리를 꺼도 같고 실패 요청은 무료입니다. 모델 페이지 현재 요금을 참고합니다. 생성 영상은 14일 후 삭제되므로 채택 파일을 그 전에 저장합니다.
제한과 관련 선택지
요청이 배포사의 필터에 의해 표시되면 비용 청구 없이 거부 처리합니다. 중간 안내는 4장까지이며 loop와 마지막 이미지를 함께 보내지 않습니다. 필수 시작 이미지 외 선택 참조는 1장입니다.
필수 시작 사진이 없으면 text-to-video, 여러 시각 자료로 구성하려면 1~7장과 480p·720p를 지원하는 reference-to-video를 사용합니다. 시작 프레임, 시간 지정 도착, loop가 요청 이유라면 image-to-video를 유지합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-imagine-video-1.5/image-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 6,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.











