NezhaGate
grok-imagine-video-1.5

Grok Imagine Video 1.5 · API

POST https://nezhagate.com/v1/videos/generations

Grok Imagine Video 1.5 영상 생성(비동기): duration은 4~15 사이의 정수 초, 해상도 480P / 720P, 화면 비율 16:9 / 9:16 / 1:1 / 4:3 / 3:4. 이미지-투-비디오는 image를 넣으세요(참조 최대 7장, 2장 이상이면 최대 10초). 작업 ID를 돌려주고(HTTP 202) GET /v1/videos/jobs/{id}를 status=succeeded가 될 때까지 폴링하면 결과가 data[0].url에 담깁니다. 건당 과금: 480P $0.30 / 720P $0.40(기본값 720P). 같은 등급 안에서는 가장 짧은 클립과 가장 긴 클립의 값이 같습니다. 실패 시 전액 환불합니다.

플레이그라운드에서 사용해 보기 →

인증

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

콘솔에서 API 키를 만들면 시작할 수 있습니다.

요청 본문

파라미터타입필수설명
model string 모델 ID. 여기서는 grok-imagine-video-1.5입니다.
prompt string 영상의 내용, 카메라, 움직임을 설명하는 텍스트 프롬프트. 최대 5000 바이트(UTF-8. 한글 한 글자는 3바이트).
duration integer 아니오 길이(초). 4~15 사이의 정수이며 기본값은 15, 즉 가장 긴 값입니다. 건당 과금이라 길이가 가격을 바꾸지 않습니다. seconds로도 쓸 수 있습니다. 참조 이미지를 2장 이상 넣으면 상한이 10초로 내려갑니다.
resolution string 아니오 해상도: 480P $0.30 / 720P $0.40(기본값 720P). 가격은 길이가 아니라 해상도에 따라 달라집니다.
size string 아니오 화면 비율: 16:9 / 9:16 / 1:1 / 4:3 / 3:4(기본값 16:9). aspect_ratio로도 쓸 수 있습니다. 이 모델은 21:9를 지원하지 않습니다.
image string 아니오 이미지-투-비디오: 참조 이미지를 넣으세요(공개 URL, data: URI, base64). 텍스트-투-비디오라면 생략하세요.
images array 아니오 참조 이미지 여러 장. 최대 7장입니다. 상한을 넘으면 잘라내지 않고 거절합니다. reference_images로도 쓸 수 있습니다.

요청 예시

cURL
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-video-1.5", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

응답

200 · JSON
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "grok-imagine-video-1.5"
}

비동기 영상 작업 (제출 → 폴링)

모델은 하나이고 파라미터로 종류를 고릅니다: tier=lite/fast/quality, resolution=720p/1080p/4k (1080p/4k는 quality 필요), size=16:9/9:16, duration=4s/6s/8s. 이미지-투-비디오는 image 파라미터를 추가하세요(첫 프레임). HTTP 202와 작업 ID를 반환하며, status=succeeded가 될 때까지 폴링하면 결과가 data[0].url에 담깁니다(재호스팅된 mp4, 약 1~2분).

curl · 제출 (텍스트-투-비디오)
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-video-1.5", "prompt": "노을 속에서 서핑하는 고양이", "tier": "quality", "resolution": "1080p", "size": "16:9", "duration": "8s"}'
이미지-투-비디오: image 파라미터도 함께 보내세요(첫 프레임 참조 — 공개 URL, data: URI, base64 모두 가능).
응답 예시
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "grok-imagine-video-1.5" }
curl · 폴링
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
응답 예시
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "succeeded",
  "model": "grok-imagine-video-1.5",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}

건당 과금하며 실패 시 전액 환불합니다. 실패하거나 시간이 초과된 렌더링은 예치된 크레딧을 자동으로 돌려줍니다.

오류 코드

Code설명
401API 키가 없거나 유효하지 않음
402잔액 부족 또는 키 한도 초과
400지원하지 않는 모델 또는 파라미터
429업스트림 요청 한도 초과
502모든 업스트림 경로가 실패