Grok Imagine Video icon
Video 제공: xAI

Grok Imagine API

xAI의 Grok Imagine을 하나의 통합 API로 사용해 AI 비디오를 생성하세요. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 갖추었으며 별도의 xAI 계정을 관리할 필요가 없습니다.

Grok Imagine Video을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

model: "grok-imagine-video"

Grok Imagine Video의 특별한 점

네이티브 동기화 오디오

배경 음악·효과음·환경음과 립싱크된 대사나 노래를 비디오와 같은 과정에서 생성합니다. 별도의 오디오 단계가 필요 없습니다.

충실한 이미지→비디오

가장 강력한 모드에서는 소스 이미지를 첫 프레임으로 삼아 애니메이션화하며 피사체의 정체성·스타일·조명·색상을 보존합니다.

Aurora 엔진의 모션 일관성

프레임을 순차적으로 생성해 클립 전반에서 피사체·조명·카메라를 안정적으로 유지하며, 머리카락·물·천·미세 표정에 대한 물리 시뮬레이션도 정교합니다.

완결된 비디오 워크플로

텍스트→비디오, 이미지→비디오, 비디오→비디오, 샷을 이어 붙이는 비디오 확장, 룩을 유지하는 참조 기반 생성을 모두 다룹니다.

빠른 변형 생성

클립이 1분 이내로 렌더링되며, 빠른 A/B 테스트를 위해 여러 창의적 변형을 한 번에 생성할 수 있습니다.

Grok Imagine Video(으)로 제작

Apiframe의 Grok Imagine Video API로 생성한 출력 예시입니다.

A 5-second clip animating this portrait, the subject smiles, looks to camera, and says a short greeting, soft studio light.

A 5-second product clip, a slow push-in on a bottle as condensation forms, gentle rim light, light ambient sound.

A 5-second clip of this landscape coming alive, wind through the grass, drifting clouds, birds crossing, natural ambience.

A 5-second character clip, the figure turns and walks toward camera, dust kicking up, a low footstep rumble.

A 5-second sci-fi shot of a crystal-powered rocket launching from a red desert planet, roaring engine audio.

A 5-second anime-style clip of a girl on a rooftop at sunset, hair in the breeze, soft city ambience.

개요

엔드포인트
POST /v2/videos/generate
모델 ID
grok-imagine-video
파라미터 키
grokParams
모달리티
비디오
제공업체
xAI
평균 완료 시간
~180s

기능

화면 비율1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
길이6초, 10초, 15초
이미지 입력지원
평균 시간~180초

빠른 시작

API 키와 함께 POST /v2/videos/generate 요청을 한 번 보내면 Grok Imagine Video로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "grok-imagine-video",
        "grokParams": {
            "reference_images": [
                "https://example.com/input.jpg"
            ]
        }
    }'
import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "grok-imagine-video",
        "grokParams": {
            "reference_images": [
                "https://example.com/input.jpg"
            ]
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }
const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "grok-imagine-video",
    "grokParams": {
      "reference_images": [
        "https://example.com/input.jpg"
      ]
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 AcceptedjobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"
import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])
let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Grok Imagine Video 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터 유형 필수 기본값 허용값 / 범위 설명
prompt string 필수 생성할 내용에 대한 텍스트 설명.
model string 필수 "grok-imagine-video" "grok-imagine-video" 이 엔드포인트의 모델 식별자.
grokParams.reference_images string[] (URLs) 선택 Reference images

자주 묻는 질문

Grok Imagine Video API에 대한 일반적인 질문입니다.

Grok Imagine Video는 무엇인가요?

Grok Imagine 제품군에 포함된 xAI의 비디오 모델로, Aurora 엔진을 기반으로 이미지나 텍스트를 네이티브 동기화 오디오가 포함된 짧은 시네마틱 클립으로 변환합니다.

오디오를 생성하나요?

네. 배경 음악·효과음·환경음과 립싱크된 대사나 노래를 비디오와 같은 과정에서 네이티브로 생성합니다.

어떤 입력을 지원하나요?

텍스트→비디오, 이미지→비디오, 비디오→비디오, 비디오 확장, 참조 기반 생성을 지원합니다.

얼마나 빠른가요?

클립은 보통 1분 이내로 렌더링되며 여러 변형을 동시에 생성할 수 있습니다.

어디에서 사용할 수 있나요?

Apiframe는 물론 Grok 앱과 xAI의 각 서비스에서 사용할 수 있습니다.

아직 궁금한 점이 있으신가요?

Grok Imagine Video API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Grok Imagine Video을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작
모든 모델을 위한 하나의 API
웹훅, SDK 및 멱등성
제공업체 계정 불필요

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.