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

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

Створіть **`scripted-video-generation-request-*.json`** (див. [Сценарний медіапайплайн](/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-ремастеринг |
| **`production_i2v`** | `grok-imagine-video-1.5` | 720p | $0.14 | I2V-ремастеринг |

**Автоматично:** `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 **або** редагування, якщо задано `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 маніфесту (редагування):**

```
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-монтажів |
| Ремастеринг-редагування з тією самою роздільною здатністю | Редагування успадковує роздільну здатність джерела (до 720p) — для справжнього масштабування до 720p використовуйте повторну генерацію |
| Тайм-аут | Збільште `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)