grok-imagine-video API를 사용하여 비디오를 생성하려면 어떻게 해야 하나요?

텍스트 프롬프트와 선택적 이미지/비디오 소스를 포함하여 model 'grok-imagine-video'로 POST 요청을 보내면 작업 ID가 반환됩니다. 그런 다음 비디오 상태가 'done'이 될 때까지 이 ID를 폴링합니다.

grok-imagine-video는 어떤 입력 형식을 지원하나요?

애니메이션을 위해 자연어 프롬프트와 선택적 이미지 URL(또는 base64 이미지)을 받을 수 있으며, 편집의 경우 비디오 URL을 제공합니다.

최대 비디오 길이와 해상도 옵션은 무엇인가요?

이 모델은 최대 15초 길이의 비디오 생성과 최대 720p 해상도를 지원하며, 16:9 또는 1:1과 같은 화면비를 구성할 수 있습니다.

이 모델로 정지 이미지를 비디오로 애니메이션화할 수 있나요?

예, 요청에서 이미지 URL 또는 인코딩된 이미지를 사용하여 프롬프트에 따라 정지 이미지에 움직임을 부여할 수 있습니다.

grok-imagine-video는 기존 비디오 편집을 지원하나요?

예 — 소스 비디오 URL과 편집 지시사항을 제공하면 출력은 원본 비디오의 길이와 해상도를 유지합니다.

grok-imagine-video 출력에서 검토는 어떻게 작동하나요?

생성된 비디오는 콘텐츠 검토 대상이며, 문제가 있는 콘텐츠는 생성 중 필터링되거나 차단될 수 있습니다.

비디오 생성은 비동기식인가요?

예, API는 요청 ID를 반환하며 비디오를 다운로드할 준비가 되었는지 확인하기 위해 이를 폴링합니다.

만료된 비디오 URL은 어떻게 처리해야 하나요?

다운로드된 비디오는 신속히 저장해야 하며, 임시 URL은 만료되어 생성 후 접근할 수 없게 될 수 있습니다.

저렴한 Grok Imagine Video API | image-to-video

📘 Grok Imagine Video 기술 사양

사양	세부 정보
Model ID	grok-imagine-video
Provider	xAI
Type	비디오 생성 및 편집 AI
Input Types	텍스트(프롬프트); 선택적 이미지 또는 비디오 자연어 텍스트 프롬프트; 선택적 이미지 입력(이미지→비디오); 기존 클립 편집을 위한 선택적 video_url. 엔드포인트에 따라 편집 입력 비디오의 최대 길이가 다름 — 일부 편집 플로우에서 보고된 값은 ~8.7s.
Output Types	임시 URL을 통한 .mp4 비디오
Duration Range (generate)	1–15초
Resolution	480p, 720p(구성 가능)
Aspect Ratios	1:1, 16:9, 9:16
Edit Support	예 — 최대 8.7s 길이의 비디오를 애니메이션화 및 수정
Moderation	콘텐츠 모더레이션 포함
Pricing	초당 과금, 해상도에 따라 상이

🚀 Grok Imagine Video란?

Grok Imagine Video는 CometAPI를 통해 제공되는 xAI의 고급 비디오 생성 및 편집 AI 모델입니다. 개발자는 자연어 프롬프트만으로 짧고 맞춤형 비디오를 생성하고, 선택적으로 정지 이미지를 애니메이션화하거나 기존 클립을 편집할 수 있습니다. 출력 길이, 해상도, 화면비를 구성할 수 있으며, 내장된 콘텐츠 모더레이션으로 정책 준수를 보장합니다.

🧠 주요 기능(Grok Imagine의 차별점)

네이티브 오디오 + 립싱크: 환경음, 효과음, 짧은 음성/내레이션을 동기화하여 생성하며, 대략적인 립싱크를 제공합니다.
이미지→비디오 / 프롬프트 편집: 정지 이미지를 애니메이션화하거나 텍스트 프롬프트를 통해 기존 영상을 편집(객체 제거/교체, 리타이밍, 재스타일링).
빠른 반복 & 낮은 지연: 크리에이티브 워크플로와 제품 프로토타이핑에 적합한 빠른 피드백 루프에 맞춰 설계.
프로덕션 API: Imagine API는 배치 생성, 편집 파이프라인 통합, 엔터프라이즈 제어를 위한 프로그래매틱 엔드포인트를 제공합니다.
다중 “모드”/스타일: 사용자 노출용 모드(보고된 예: Normal / Fun / Spicy 또는 유사 프리셋)로 스타일 또는 허용 수준에 따라 출력 경향을 조절(참고: 과거 “Spicy” 모드는 NSFW를 허용한 전례가 있음).

모델(회사)	최대 해상도(공개)	최대 클립 길이(공개)	네이티브 오디오	강점	주의사항
Grok Imagine (xAI)	720p	6–15s	예	빠른 반복, 우수한 비용/지연, 통합 편집, 네이티브 오디오	720p 제한; 모더레이션 관련 우려; 현실 세계 충실도 편차
Sora (OpenAI)	720p–1080p(티어에 따라 상이)	짧음(6–15s)	예	높은 시각적 충실도; OpenAI 스택과 강력한 통합	더 높은 비용; 제한적인 모더레이션/제어
Veo (Google DeepMind)	최대 1080p+	짧음(가변)	예	강한 포토리얼리즘, 안정적인 모션	비용 상향; 공개 실험 기회 제한
Runway Gen-4.5	1080p+	짧음(가변)	예	크리에이티브 워크플로 채택, 높은 충실도	비용 높음; 크리에이티브 툴링 중심
Vidu / Kling / Pika(전문 업체 다수)	최대 1080p	짧음(가변)	혼합	일부는 특화 기능 제공(Smart Cuts, multi-shot chaining)	오디오 지원 다양; API 성숙도 상이

⚠️ 한계

최대 비디오 길이는 15초로 제한됩니다.
편집은 입력 비디오 길이를 유지합니다(≤ 8.7s).
생성된 URL은 일시적입니다 — 신속히 다운로드하세요.

Grok Imagine Video 액세스 및 통합 방법

1단계: API 키 신청

cometapi.com에 로그인하세요. 아직 사용자라면 먼저 회원가입을 진행하세요. CometAPI console에 로그인합니다. 인터페이스의 액세스 자격인증 API 키를 발급받습니다. 개인 센터의 API 토큰에서 “Add Token”을 클릭해 토큰 키: sk-xxxxx를 발급받아 제출하세요.

2단계: `Grok Imagine Video` API로 요청 전송

엔드포인트 “grok-imagine-video”를 선택해 API 요청을 보내고 요청 본문을 설정합니다. 요청 메서드와 요청 본문은 당사 웹사이트의 API 문서에서 확인할 수 있습니다. 편의를 위해 Apifox 테스트도 제공합니다. 계정의 실제 CometAPI 키로 <YOUR_API_KEY>를 교체하세요. 호출 위치: GROK 비디오 생성 및 비디오 편집.

3단계: `Grok Imagine Video` API로 요청 전송

텍스트를 입력하거나 이미지를 업로드하세요(선택적으로 애니메이션화할 원본 이미지를 제공할 수 있음). Grok Imagine AI API가 입력을 분석하고 URL로 제공할 콘텐츠를 준비합니다. 텍스트-투-비디오와 이미지-투-비디오 변환을 모두 지원합니다.

원본 이미지는 다음과 같이 제공할 수 있습니다.

이미지를 가리키는 공개 URL
base64로 인코딩된 데이터 URI(예: data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

4단계: 결과 조회 및 검증

API 응답을 처리하여 생성된 결과를 가져옵니다. 제출 후 즉시 request_id가 반환되며, GET 엔드포인트를 사용해 상태를 확인하고 생성된 비디오를 조회하세요. 비디오 편집은 비동기식이므로 작업이 완료될 때까지 이 엔드포인트를 여러 번 폴링해야 할 수 있습니다. 즉시 다운로드하세요.

Grok Imagine Video 가격

[모델명]의 경쟁력 있는 가격을 살펴보세요. 다양한 예산과 사용 요구에 맞게 설계되었습니다. 유연한 요금제로 사용한 만큼만 지불하므로 요구사항이 증가함에 따라 쉽게 확장할 수 있습니다. [모델명]이 비용을 관리 가능한 수준으로 유지하면서 프로젝트를 어떻게 향상시킬 수 있는지 알아보세요.

Pricing Overview

Category	Item	Price
Input Pricing	Text	N/A (Free)
	Image	$0.0016
	Video per second	$0.008
Output Pricing	480p	$0.04
(Per second by resolution)	720p	$0.056

Note: When generating video via API, you are charged per second. You will also be charged when using video or images as input.

Grok Imagine Video의 샘플 코드 및 API

[모델 이름]의 포괄적인 샘플 코드와 API 리소스에 액세스하여 통합 프로세스를 간소화하세요. 자세한 문서는 단계별 가이드를 제공하여 프로젝트에서 [모델 이름]의 모든 잠재력을 활용할 수 있도록 돕습니다.

Python
JavaScript
Curl

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("
Step 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

Python Code Example

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("\nStep 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

JavaScript Code Example

// Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com/grok/v1";

const headers = {
  "Authorization": `Bearer ${api_key}`,
  "Content-Type": "application/json",
};

// ============================================================
// Step 1: Create Video Generation Task
// ============================================================
console.log("Step 1: Creating video generation task...");

const createPayload = {
  model: "grok-imagine-video",
  prompt: "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
  duration: 10,
  aspect_ratio: "16:9",
  resolution: "720p",
};

const createResponse = await fetch(`${base_url}/videos/generations`, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(createPayload),
});

const createResult = await createResponse.json();
console.log("Create response:", JSON.stringify(createResult, null, 2));

const taskId = createResult?.request_id || createResult?.id;
if (!taskId) {
  console.log("Error: Failed to get task ID from response");
  process.exit(1);
}

console.log(`Task ID: ${taskId}`);

// ============================================================
// Step 2: Poll for Task Status
// ============================================================
console.log("\nStep 2: Polling task status...");

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

while (true) {
  const queryResponse = await fetch(`${base_url}/videos/${taskId}`, {
    method: "GET",
    headers: headers,
  });

  const queryResult = await queryResponse.json();
  const data = queryResult?.data || {};
  const status = data?.status || "unknown";
  const progress = data?.progress || "0%";
  console.log(`Status: ${status}, Progress: ${progress}`);

  if (["FAILURE", "failed"].includes(status)) {
    console.log("Video generation failed!");
    console.log(`Reason: ${data?.fail_reason}`);
    process.exit(1);
  }

  if (status === "SUCCESS") {
    const videoUrl = data?.data?.video?.url;
    console.log("Video generation completed!");
    console.log(`Video URL: ${videoUrl}`);
    break;
  }

  await sleep(10000);
}

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

BASE_URL="https://api.cometapi.com/grok/v1"

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
echo "Step 1: Creating video generation task..."

CREATE_RESPONSE=$(curl -s --location --request POST "${BASE_URL}/videos/generations" \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }')

echo "Create response: $CREATE_RESPONSE"

# Extract task ID using jq (install with: brew install jq)
TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.request_id // .id')

if [ "$TASK_ID" == "null" ] || [ -z "$TASK_ID" ]; then
  echo "Error: Failed to get task ID from response"
  exit 1
fi

echo "Task ID: $TASK_ID"

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
echo ""
echo "Step 2: Polling task status..."

while true; do
  QUERY_RESPONSE=$(curl -s --location --request GET "${BASE_URL}/videos/${TASK_ID}" \
    --header "Authorization: Bearer $COMETAPI_KEY")

  STATUS=$(echo "$QUERY_RESPONSE" | jq -r '.data.status')
  PROGRESS=$(echo "$QUERY_RESPONSE" | jq -r '.data.progress')
  echo "Status: $STATUS, Progress: $PROGRESS"

  if [ "$STATUS" == "FAILURE" ] || [ "$STATUS" == "failed" ]; then
    echo "Video generation failed!"
    echo "$QUERY_RESPONSE" | jq -r '.data.fail_reason'
    exit 1
  fi

  if [ "$STATUS" == "SUCCESS" ]; then
    VIDEO_URL=$(echo "$QUERY_RESPONSE" | jq -r '.data.data.video.url')
    echo "Video generation completed!"
    echo "Video URL: $VIDEO_URL"
    break
  fi

  sleep 10
done