Grok Imagine 1.5 Lite 텍스트 투 비디오 API 사용법? 사운드 효과 내장

TL;DR

• Grok Imagine 1.5 Lite Text to Video(grok-imagine-1.5-lite/text-to-video)는 한 단락의 텍스트로 1–15초, 사운드 효과 내장 비디오를 생성하며, 가로, 세로, 정사각형 일곱 가지 화면 비율을 네이티브로 생성합니다. 모델 페이지 열기에서 바로 체험할 수 있고, 신규 사용자는 가입 시 200 크레딧을 받습니다.
• 가격은 초당 계산: 480P $0.029, 720P(기본) $0.043, 1080P $0.2; 720p 6초 한 편 $0.258.
• 호출은 HiAPI /v1/tasks 인터페이스로: 작업을 제출해 taskId를 받고, 결과를 조회한 뒤 성공하면 output에서 비디오 주소를 가져옵니다(임시 주소이므로 즉시 저장).

할 수 있는 것

• 한 단락으로 화면, 동작, 사운드를 모두 작성: 카메라 움직임과 사운드 효과를 모두 프롬프트에 작성하면 완성 영상에 오디오 트랙이 포함됩니다(끌 수 없고, 추가 요금 없음).
• 1–15초 임의의 정수 초: duration에 원하는 초를 입력, 기본값 6.
• 일곱 가지 화면 비율 네이티브 생성: 16:9, 9:16, 1:1, 4:3, 3:2, 2:3, 3:4——세로와 정사각형은 가로에서 자른 것이 아닙니다.
• 같은 시리즈에 이미지 투 비디오도 있음: grok-imagine-1.5-lite/image-to-video는 이미지 한 장을 업로드해 움직이게 하며, 이미지 투 비디오 연동 가이드를 참고하세요.

두 인터페이스 선택 방법:

	grok-imagine-1.5-lite/text-to-video(이 페이지)	grok-imagine-1.5-lite/image-to-video
입력	텍스트 한 단락	이미지 1장 + 움직임 설명
화면 비율	7가지 중 선택	입력 이미지 따름
추가 요금	없음	건당 $0.015 입력 이미지 비용
적합	제로부터 장면 생성, 광고 크리에이티브	이미 사진이나 제품 이미지가 있는 경우

한마디로: 화면을 제로부터 구상하면 텍스트 투 비디오, 화면이 이미 있으면 이미지 투 비디오; 카피 크리에이티브와 소재 이미지가 모두 갖춰졌을 때는 이미지 투 비디오가 더 통제 가능합니다.

아래는 실제 완성 영상입니다(720p · 6초 · 16:9, 바람 소리와 새소리 내장):

A glass hot-air balloon drifts slowly over a misty valley of terraced rice fields at sunrise. Golden light spills across the water-filled terraces, mist rolls between the hills, a flock of white egrets glides beneath the balloon. Smooth aerial tracking shot, gentle wind sounds and distant birdsong, cinematic, natural colors. No text, no logos.

(한국어 의미: 유리 열기구가 일출 무렵 안개 낀 계단식 논山谷 위를 천천히 떠다닙니다. 황금빛 햇살이 물로 가득 찬 계단식 논 위로 쏟아지고, 옅은 안개가 산 사이로 흐르며, 한 무리의 흰 백로가 열기구 아래로 미끄러지듯 날아갑니다. 부드러운 항공 트래킹 샷, 잔잔한 바람 소리와 먼 곳의 새소리, 영화 같은 느낌, 자연스러운 색감. 텍스트 없음, 로고 없음.)

grok-imagine-1.5-lite/text-to-video, 720P, 6초, 16:9, 1280×720, 사운드 효과 내장, $0.258.전체 영상 보기 →

이 프롬프트로 생성 →

가격: 세 가지 티어 초당

티어	초당	5초	6초	15초
480P	$0.029	$0.145	$0.174	$0.435
720P(기본)	$0.043	$0.215	$0.258	$0.645
1080P	$0.20	$1.00	$1.20	$3.00

HiAPI 현재 가격, 2026년 10월 23일 확인. 1080P는 초당 $0.2로 720P의 약 4.65배——대량 작업은 720p로 시안을 만들고 최종 확정본만 1080P로 업그레이드하는 것을 권장합니다. 실패 시 과금 없음.

두 가지 시작 방법

브라우저 3단계: 모델 페이지 열기 → 프롬프트 붙여넣고 길이, 해상도, 화면 비율 선택 → 생성 클릭, 720p 6초 한 편 $0.258, 영상이 나오면 바로 온라인 미리보기로 확인하고 만족하면 더 많은 소재를 만들지 결정하세요.

API 3단계: POST /v1/tasks 제출 → taskId 획득 → GET /v1/tasks/<taskId>로 success 확인 후 다운로드.

curl: 첫 번째

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "grok-imagine-1.5-lite/text-to-video",
  "input": {
    "prompt": "A glass hot-air balloon drifts slowly over a misty valley of terraced rice fields at sunrise. Golden light spills across the water-filled terraces, mist rolls between the hills, a flock of white egrets glides beneath the balloon. Smooth aerial tracking shot, gentle wind sounds and distant birdsong, cinematic, natural colors. No text, no logos.",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

Python: 제출, 폴링, 다운로드

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "grok-imagine-1.5-lite/text-to-video",
    "input": {
        "prompt": "A glass hot-air balloon drifts slowly over a misty valley of terraced rice fields at sunrise. Golden light spills across the water-filled terraces, mist rolls between the hills, a flock of white egrets glides beneath the balloon. Smooth aerial tracking shot, gentle wind sounds and distant birdsong, cinematic, natural colors. No text, no logos.",
        "duration": 6,
        "resolution": "720p",
        "aspect_ratio": "16:9",
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # 임시 주소, 가능한 빨리 저장
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

파라미터 표

필드	필수	값	설명
prompt	예	1–4096자	화면, 동작, 카메라, 사운드 효과를 한 단락으로 작성
duration	아니오	1–15 임의의 정수, 기본 6	다른 회사 비디오 모델의 열거형 길이와 다름
resolution	아니오	480p / 720p / 1080p, 기본 720p	1080P는 초당 $0.2, 요금 주의
aspect_ratio	아니오	7가지, 기본 16:9	세로, 정사각형 네이티브 생성

요청 본문에 표에 없는 필드가 있으면 바로 400.

마주치게 될 오류

상태 코드	의미	처리 방법
400 INVALID_REQUEST	요청 본문이 유효하지 않음(prompt 누락, duration에 0 또는 16 입력, 표에 없는 필드 전달)	파라미터 표에 맞춰 요청 본문 수정
402 INSUFFICIENT_QUOTA	잔액 부족(과금 없음)	충전 후 재시도
429 RATE_LIMITED	속도 제한 트리거	제출 빈도 낮추기
409 / 422 IDEMPOTENCY_KEY_*	동일한 멱등성 키로 중복 제출	새 Idempotency-Key로 변경

작업 종료 상태 실패에는 CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT 등이 있습니다; 실패 시 과금 없음.

출시 전 주의

• 콜백: 비디오 작업은 시간이 오래 걸리므로 요청 본문 최상위에 "callback": {"url": "https://..."}를 전달해 폴링을 줄이세요.
• 즉시 저장: output의 비디오 주소는 임시이므로 받으면 바로 다운로드하세요.
• 사운드는 끌 수 없음: 무음 소재가 필요하면 후반에서 오디오 트랙을 제거하세요; 가격은 영향 없음.
• 1080P 대량 사용 주의: 초당 $0.2, 6초 한 편 $1.20; 대량 탐색은 480P(한 편 $0.174) 사용.

자주 묻는 질문

• 네, 모든 영상에 사운드 효과가 내장됩니다: 프롬프트에 사운드 효과(바람 소리, 새소리, 대사)를 작성하면 함께 생성됩니다; 끄는 스위치는 없습니다.
• 네, 길이는 임의의 정수 초(1–15)이며 고정 티어에 제한되지 않습니다.
• 네, 세로와 정사각형은 네이티브 생성으로 자르기가 아니며 구도가 가로와 동일하게 완전합니다.
• 네, $10으로 약 38편: 720P 6초 한 편 $0.258; 480P 한 편 $0.174로 $10이면 57편, 크리에이티브 탐색 단계에 충분합니다.
• 네, 세 티어 모두 일곱 가지 화면 비율을 모두 생성 가능, 해상도는 선명도에만 영향, 선택 가능한 비율에는 영향 없음.
• 네, 인물이 대사를 말할 수 있습니다: 프롬프트에 따옴표로 대사를 작성하면(예: 제빵사 사례) 대사와 환경음이 함께 나옵니다.

다음 단계: 열기구 프롬프트로 모델 페이지에서 첫 영상 만들기, 다섯 가지 장면은 텍스트 투 비디오 프롬프트 모음을 참고하세요.