Grok Imagine 1.5 API: 이미지를 짧은 영상으로 변환

제품 사진 한 장, 인물 프로필 사진 또는 풍경 정지 이미지를 별도의 영상 생성 계정에 로그인할 필요 없이 바로 사용 가능한 짧은 영상 클립으로 만들 수 있습니다. Grok Imagine 1.5의 이미지-투-비디오 엔드포인트는 이미지 URL, 움직임을 설명하는 선택적 프롬프트, 그리고 재생 시간을 입력받아 hiapi의 비동기 작업 API를 통해 렌더링된 .mp4 파일을 반환합니다.

이번 실습에서는 동일한 소스 이미지와 두 가지 다른 프롬프트를 사용하여 표현 방식이 결과를 얼마나 크게 바꿀 수 있는지 보여주고, 이어서 실제 요청 스키마, 가격 책정을 분석하고 바로 복사할 수 있는 코드 예제를 제공합니다.

소스 이미지

아래 두 클립은 모두 이 동일한 정지 이미지에서 시작합니다. 두 요청 사이에 기본 이미지는 전혀 변경되지 않았으며, 오직 prompt 필드만 다릅니다.

버전 1: 짧은 티저 스타일의 팬

프롬프트: "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing." 재생 시간: 4.

버전 2: 더 긴 궤도 샷

프롬프트: "Camera slowly orbits around the subject, revealing the scene from a new angle." 재생 시간: 8.

동일한 정지 이미지, 동일한 모델, 완전히 다른 두 가지 카메라 움직임 — 요청에 전용 모션 강도나 카메라 경로 파라미터가 없기 때문에 여기서는 거의 전적으로 프롬프트가 역할을 합니다.

실제 요청 스키마

전체 모델 문서 및 실시간 가격은 Grok Imagine 1.5 이미지-투-비디오 모델 페이지에서 확인하세요. 요청 본문은 의도적으로 매우 작게 설계되었습니다:

{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "image_urls": ["https://your-public-host.com/source.jpg"],
    "prompt": "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.",
    "duration": 4
  }
}

호출 전에 알아야 할 세 가지:

• image_urls는 공개 HTTP(S) URL이어야 합니다. 모델이 이미지를 직접 가져오므로 요청 본문에 원시 바이트를 업로드할 수 없습니다. 소스 이미지가 로컬에만 있다면 먼저 공개 스토리지 버킷에 업로드하세요.
• duration은 1에서 15초 사이의 정수입니다. aspect_ratio, resolution 또는 모션 강도 필드가 없습니다. 출력 구도는 소스 이미지를 따르며, 해상도는 요청 파라미터가 아니라 가격 티어(480p 또는 720p)에 의해 결정됩니다.
• prompt는 선택 사항이지만 창의적인 작업의 대부분을 담당합니다. 그 외에 카메라를 유도할 수 있는 것이 없기 때문입니다.

작업 제출 및 폴링

hiapi의 모든 영상 및 이미지 모델과 마찬가지로 이 모델은 동기 엔드포인트가 아닌 통합 비동기 작업 API를 통해 실행됩니다. 생성에는 실제 시간이 소요되므로 먼저 작업을 제출하고, 완료 상태를 폴링한 다음, 링크가 만료되기 전에 결과를 다운로드해야 합니다.

# 1. Submit the task
curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5/image-to-video",
    "input": {
      "image_urls": ["https://your-public-host.com/source.jpg"],
      "prompt": "Camera slowly orbits around the subject, revealing the scene from a new angle.",
      "duration": 8
    }
  }'
# => {"id": "task_...", "status": "pending"}

# 2. Poll until it's done
curl -s https://api.hiapi.ai/v1/tasks/task_... \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# => {"id": "task_...", "status": "success", "output": [{"url": "https://...mp4"}]}

status가 success로 바뀌면 즉시 output[0].url을 다운로드하세요. 영구 링크가 아닌 시간 제한 링크이므로 만료되기 전에 바이트를 직접 소유한 스토리지에 저장해야 합니다.

가격 책정 및 재생 시간 계산

대량 작업의 예산을 책정하기 전에 hiapi 가격 페이지에서 현재 수치를 확인하세요. 이 글을 작성하는 시점 기준으로 grok-imagine-1.5/image-to-video는 출력 초당 과금됩니다:

해상도	초당 가격
480p	$0.015
720p	$0.0282

4초 480p 클립의 비용은 $0.06이며, 동일한 클립을 720p로 만들면 약 $0.11입니다. 가격이 생성당 고정 요금이 아니라 재생 시간에 비례하기 때문에 최종 편집본을 확정하기 전에 동일한 정지 이미지로 여러 프롬프트 변형을 테스트하는 비용이 저렴합니다. 이 글의 두 클립은 합쳐서 $0.20보다 훨씬 적게 들었습니다.

자주 묻는 질문

프롬프트로 설명하는 대신 카메라 움직임을 직접 제어할 수 있나요? 아니요. 이 엔드포인트의 스키마에는 전용 모션 강도, 카메라 경로 또는 줌 파라미터가 없습니다. 카메라 동작은 전적으로 prompt를 어떻게 서술하느냐에 따라 결정됩니다.

출력 해상도가 소스 이미지와 일치하나요? 구도는 소스 이미지의 가로세로 비율을 따르지만, 해상도(480p 또는 720p)는 별도 필드로 설정하는 것이 아니라 가격 티어의 선택입니다. 플랫폼 모델에 가끔 파라미터가 추가되므로 위에 링크된 모델 페이지에서 현재 스키마를 확인하세요.

출력을 충분히 빨리 다운로드하지 않으면 어떻게 되나요? 완료된 작업의 output[0].url은 시간 제한이 있습니다. 기간을 놓치면 작업을 다시 제출하고 생성 비용을 다시 지불해야 합니다. 만료된 링크를 다시 받을 수는 없습니다.

한 번의 요청으로 여러 정지 이미지를 애니메이션화할 수 있나요? image_urls는 URL 하나를 받지만, 작업 하나당 소스 이미지 하나로 클립 하나를 생성합니다. 대량 작업의 경우 각 정지 이미지당 작업을 하나씩 제출하고 각각 폴링하세요. 비동기 모델이므로 여러 작업을 동시에 진행할 수 있습니다.

---

자신의 이미지로 시도해 볼 준비가 되셨나요? Grok Imagine 1.5 이미지-투-비디오 모델 페이지에서 자신만의 프롬프트로 짧은 클립을 생성하거나, 기존 파이프라인에 통합하려면 비동기 작업 API 문서부터 시작하세요.