---
title: "ring-video-create"
description: "Инструмент MCP — сценарный медиапайплайн, авто-still через firstFramePrompt, I2V, миниатюры, remaster"
locale: "ru"
---
# `ring-video-create`

Генерирует короткое видео из текстового prompt. **Сценарный путь:** передайте **`firstFramePrompt`**, чтобы автоматически создать still (ImageConductor), затем I2V с **grok-imagine-video-1.5** @ 480p. Опциональные текстовые оверлеи **`thumbnail`** на первом кадре.

Создайте **`scripted-video-generation-request-*.json`** (см. [Scripted media pipeline](/docs/development/scripted-media-pipeline.md)) или передайте напрямую **`firstFramePrompt`** + скомпилированный prompt **`DIALOGUE:`**. Вручную возиться с `imageUrl` не нужно.

  
- **[Сценарный медиапайплайн](/docs/development/scripted-media-pipeline.md)** — JSON Schema запроса, CLI, линза режиссёра.

  
- **[Генеративные видео](/docs/development/generative-videos.md)** — Полный справочник VideoConductor, CLI, линза истины.

  
- **[ring-image-create](/docs/mcp/ring-image-create.md)** — Автономная генерация still (вызывается через firstFramePrompt).

## Режимы качества и стоимость

| `qualityMode` | Модель | Разрешение | ~$/сек | Примечания |
|---------------|--------|------------|--------|-------|
| **`draft`** (по умолчанию) | `grok-imagine-video` | 480p | $0.05 | T2V — без `imageUrl` |
| **`draft_i2v`** | `grok-imagine-video-1.5` | **480p** | **$0.08** | **I2V + prompt** — нужен `imageUrl` |
| **`production`** | `grok-imagine-video` | 720p | $0.05 | T2V remaster |
| **`production_i2v`** | `grok-imagine-video-1.5` | 720p | $0.14 | I2V remaster |

**Авто:** `draft` + `imageUrl` → `draft_i2v` без явной передачи `draft_i2v`.

## Параметры

| Параметр | Обязательный | Тип | Примечания |
|-----------|----------|------|-------|
| `prompt` | **Да** | string | Сцена, ACTION, строки **DIALOGUE:** |
| `imageUrl` | Для 1.5 | string | Предсозданный кадр — пропускает `firstFramePrompt` |
| `firstFramePrompt` | Для сценарного I2V | string | Автоматически создаёт still, если `imageUrl` отсутствует |
| `imageProvider` | Нет | `xai` \| `google` | Провайдер первого кадра (по умолчанию xai) |
| `imageModel` | Нет | string | Переопределение модели изображения |
| `imageResolution` | Нет | `1k` \| `2k` | Разрешение первого кадра (по умолчанию 2k) |
| `clipId` | Нет | string | ID клипа для аудита манифеста / БД |
| `pipelineRequestId` | Нет | string | ID родительского файла запроса |
| `thumbnail` | Нет | object | `{ enabled, template, overlays[] }` — текст на первом кадре |
| `qualityMode` | Нет | enum | `draft`, `draft_i2v`, `production`, `production_i2v` |
| `remaster` | Нет | boolean | Повторная генерация 720p **или** edit, когда задан `sourceVideoUrl` |
| `sourceVideoUrl` | Нет | string | Манифест/CDN MP4 → `POST /v1/videos/edits` |
| `remasterFromVideoUrl` | Нет | string | Псевдоним для `sourceVideoUrl` |
| `duration` | Нет | number | 1–15 секунд (по умолчанию 6) |
| `aspectRatio` | Нет | string | Например `16:9`, `9:16` |
| `resolution` | Нет | `480p` \| `720p` \| `1080p` | Переопределение пресета |
| `model` | Нет | string | Переопределение slug модели xAI |
| `remasterFromRequestId` | Нет | string | Аудит-ссылка на задание черновика |
| `persistToFilebase` | Нет | boolean | По умолчанию true |

## Примеры

**Сценарная сцена (автоматический первый кадр + миниатюра):**

```
ring-video-create prompt "DIALOGUE: Man says: \"Ringize your HOA.\"" firstFramePrompt "Cinematic still, guy and girl at SF nightclub bar, neon lights" qualityMode draft duration 12 clipId 03_opener thumbnail '{"enabled":true,"overlays":[{"text":"Your HOA on Ring","role":"title","position":"bottom"}]}'
```

**Предсозданный imageUrl (пропустить первый кадр):**

```
ring-video-create prompt "DIALOGUE: …" imageUrl https://cdn.../still.jpg qualityMode draft duration 12
```

**Ремастеринг с URL манифеста (edit):**

```
ring-video-create prompt "Sharpen scene; clearer lip movement for same dialogue" remaster true sourceVideoUrl https://vidgen.x.ai/.../draft.mp4 remasterFromRequestId 
```

**Повторная генерация 720p (без URL источника):**

```
ring-video-create prompt "…same locked prompt…" remaster true imageUrl https://cdn.../still.jpg qualityMode production_i2v duration 12
```

## Форма ответа

Успешный ответ включает `firstFrame`, `thumbnail`, `clipId`, `pipelineRequestId` и `generationKind`: `generate` | `edit`.

## Устранение неисправностей

| Симптом | Исправление |
|---------|-----|
| Нечёткий диалог | Используйте **1.5 I2V** + `imageUrl` + явный **DIALOGUE:** в prompt |
| `requires imageUrl` | 1.5 только I2V — сначала создайте still |
| `does not support text-to-video` | Используйте `grok-imagine-video` для T2V-монтажей |
| Edit remaster с тем же разрешением | Edit наследует разрешение источника (потолок 720p) — для настоящего апскейла до 720p используйте повторную генерацию |
| Timeout | Поднимите `VIDEO_GEN_POLL_TIMEOUT_MS` |

## Связанные документы

- [Генерация видео xAI](https://docs.x.ai/developers/model-capabilities/video/generation)
- [Редактирование видео xAI](https://docs.x.ai/developers/model-capabilities/video/editing)
- [AIML grok-imagine-video-1.5-preview](https://docs.aimlapi.com/api-references/video-models/xai/grok-imagine-video-1.5-preview)