How do I generate a video using grok-imagine-video API?

Отправьте POST-запрос с моделью 'grok-imagine-video', указав текстовый промпт и необязательный источник изображения/видео; в ответ придёт идентификатор задачи, затем опрашивайте этот идентификатор, пока статус видео не станет 'done'.

What input formats does grok-imagine-video accept?

Модель принимает естественно-языковой текстовый промпт и необязательные URL изображений (или изображения в формате base64) для анимации; для редактирования предоставляется URL видео.

What are the maximum video duration and resolution options?

Модель поддерживает генерацию видео продолжительностью до 15 секунд и разрешением до 720p с настраиваемыми соотношениями сторон, например 16:9 или 1:1.

Can I animate a still image into a video with this model?

Да, вы можете анимировать статичное изображение на основе вашего текстового промпта, используя URL изображений или закодированные изображения в запросе.

Does grok-imagine-video support editing existing videos?

Да — укажите URL исходного видео и инструкции по редактированию; результат сохраняет исходную длительность и разрешение видео.

How does moderation work in grok-imagine-video outputs?

Сгенерированные видео проходят модерацию контента; помеченный контент может быть отфильтрован или заблокирован во время генерации.

Is the video generation asynchronous?

Да, API возвращает идентификатор запроса, который вы опрашиваете, чтобы узнать, когда видео готово к загрузке.

How should I handle expired video URLs?

Загруженные видео следует сохранять оперативно; временные URL могут истечь и стать недоступными после генерации.

Доступный API Grok Imagine Video | image-to-video

📘 Технические характеристики Grok Imagine Video

Спецификация	Подробности
Идентификатор модели	grok-imagine-video
Провайдер	xAI
Тип	ИИ для генерации и редактирования видео
Типы входных данных	Текст (промпт); необязательное изображение или видео Текстовые промпты (естественный язык); необязательный ввод изображения (image→video); необязательный video_url для редактирования существующих клипов. Максимальная длительность входного видео для редактирования отличается в зависимости от эндпойнта — сообщалось о ~8.7s для некоторых сценариев редактирования.
Типы выходных данных	Видео .mp4 по временной ссылке
Диапазон длительности (генерация)	1–15 секунд
Разрешение	480p, 720p (настраиваемое)
Соотношения сторон	1:1, 16:9, 9:16
Поддержка редактирования	Да — анимирует и изменяет видео до 8.7s
Модерация	Включена модерация контента
Цены	Плата за секунду, зависит от разрешения

🚀 Что такое Grok Imagine Video?

Grok Imagine Video — это продвинутая модель xAI для генерации и редактирования видео, доступная через CometAPI. Она позволяет разработчикам создавать короткие пользовательские видео по текстовым промптам на естественном языке, а также по желанию анимировать статичные изображения или редактировать существующие клипы. Модель поддерживает настраиваемую длину, разрешение и соотношение сторон, а встроенная модерация контента обеспечивает соблюдение политики.

🧠Основные возможности (что отличает Grok Imagine)

Нативный звук + липсинк: Генерация синхронизированного фонового звука, эффектов и короткой речи/закадрового текста с приблизительной синхронизацией движений губ.
Image→Video / редактирование по промпту: Анимация статичного изображения или редактирование существующих кадров с помощью текстовых промптов (удаление/замена объектов, ретайминг, рестайлинг).
Быстрые итерации и низкая задержка: Спроектировано для быстрых циклов обратной связи, подходящих для творческих процессов и прототипирования продуктов.
Production 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, мульти-шотовое связывание)	Разная поддержка звука; разная зрелость API

⚠️ Ограничения

Максимальная длина видео — 15 секунд.
При редактировании сохраняется длина входного видео (≤ 8.7s).
Сгенерированные URL-адреса недолговечны — скачивайте без промедления.

Как получить доступ и интегрировать Grok Imagine Video

Шаг 1: Зарегистрируйтесь для получения ключа API

Войдите на cometapi.com. Если вы ещё не являетесь нашим пользователем, пожалуйста, сначала зарегистрируйтесь. Войдите в вашу консоль CometAPI. Получите ключ API для доступа к интерфейсу. Нажмите “Add Token” в разделе API token в личном кабинете, получите ключ токена: sk-xxxxx и отправьте.

Шаг 2: Отправьте запросы к API `Grok Imagine Video`

Выберите эндпойнт “grok-imagine-video” для отправки API-запроса и задайте тело запроса. Метод и тело запроса берутся из документации API на нашем сайте. На нашем сайте также доступен тест в Apifox для вашего удобства. Замените <YOUR_API_KEY> на ваш реальный ключ CometAPI из вашего аккаунта. Где вызывать: GROKГенерация видео и Редактирование видео.

Шаг 3: Отправьте запросы к API `Grok Imagine Video`

Введите текст или загрузите изображение (вы можете дополнительно предоставить исходное изображение для анимации). Grok Imagine AI API анализирует ваш ввод и подготавливает контент для URL. Поддерживаются как преобразование текст→видео, так и изображение→видео.

Исходное изображение можно предоставить как:

Публичный URL, указывающий на изображение
Данные в формате base64-encoded data URI ( например, data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

Шаг 4: Получите и проверьте результаты

Обработайте ответ API, чтобы получить сгенерированный результат. После отправки API немедленно возвращает request_id; используйте конечную точку GET, чтобы проверить статус и получить сгенерированное видео. Редактирование видео выполняется асинхронно; возможно, вам придётся опрашивать этот эндпойнт несколько раз, пока задача не будет завершена. Пожалуйста, скачайте результат своевременно.

Цены для Grok Imagine Video

Изучите конкурентоспособные цены на Grok Imagine Video, разработанные для различных бюджетов и потребностей использования. Наши гибкие планы гарантируют, что вы платите только за то, что используете, что упрощает масштабирование по мере роста ваших требований. Узнайте, как 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.

Пример кода и API для Grok Imagine Video

Получите доступ к исчерпывающим примерам кода и ресурсам API для Grok Imagine Video, чтобы упростить процесс интеграции. Наша подробная документация предоставляет пошаговые инструкции, помогая вам использовать весь потенциал Grok Imagine Video в ваших проектах.

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