Loading documentation...
Preparing Ring content
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Preparing Ring content
Preparing Ring content
Preparing Ring content
ring-video-createГенерирует короткое видео из текстового prompt. Сценарный путь: передайте firstFramePrompt, чтобы автоматически создать still (ImageConductor), затем I2V с grok-imagine-video-1.5 @ 480p. Опциональные текстовые оверлеи thumbnail на первом кадре.
Создайте scripted-video-generation-request-*.json (см. Scripted media pipeline) или передайте напрямую firstFramePrompt + скомпилированный prompt DIALOGUE:. Вручную возиться с imageUrl не нужно.
JSON Schema запроса, CLI, линза режиссёра.
Полный справочник VideoConductor, CLI, линза истины.
Автономная генерация 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 |
Авто: draft + imageUrl → draft_i2v без явной передачи draft_i2v.
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Сцена, ACTION, строки DIALOGUE: |
imageUrl | Для 1.5 | string | Предсозданный кадр — пропускает firstFramePrompt |
firstFramePrompt | Для сценарного I2V | string | Автоматически создаёт still, если imageUrl отсутствует |
imageProvider | Нет | xai | google | Провайдер первого кадра (по умолчанию xai) |
Сценарная сцена (автоматический первый кадр + миниатюра):
Предсозданный imageUrl (пропустить первый кадр):
Ремастеринг с URL манифеста (edit):
Повторная генерация 720p (без URL источника):
Успешный ответ включает 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 |
ring-video-createГенерирует короткое видео из текстового prompt. Сценарный путь: передайте firstFramePrompt, чтобы автоматически создать still (ImageConductor), затем I2V с grok-imagine-video-1.5 @ 480p. Опциональные текстовые оверлеи thumbnail на первом кадре.
Создайте scripted-video-generation-request-*.json (см. Scripted media pipeline) или передайте напрямую firstFramePrompt + скомпилированный prompt DIALOGUE:. Вручную возиться с imageUrl не нужно.
JSON Schema запроса, CLI, линза режиссёра.
Полный справочник VideoConductor, CLI, линза истины.
Автономная генерация 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 |
Авто: draft + imageUrl → draft_i2v без явной передачи draft_i2v.
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Сцена, ACTION, строки DIALOGUE: |
imageUrl | Для 1.5 | string | Предсозданный кадр — пропускает firstFramePrompt |
firstFramePrompt | Для сценарного I2V | string | Автоматически создаёт still, если imageUrl отсутствует |
imageProvider | Нет | xai | google | Провайдер первого кадра (по умолчанию xai) |
Сценарная сцена (автоматический первый кадр + миниатюра):
Предсозданный imageUrl (пропустить первый кадр):
Ремастеринг с URL манифеста (edit):
Повторная генерация 720p (без URL источника):
Успешный ответ включает 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 |
ring-video-createГенерирует короткое видео из текстового prompt. Сценарный путь: передайте firstFramePrompt, чтобы автоматически создать still (ImageConductor), затем I2V с grok-imagine-video-1.5 @ 480p. Опциональные текстовые оверлеи thumbnail на первом кадре.
Создайте scripted-video-generation-request-*.json (см. Scripted media pipeline) или передайте напрямую firstFramePrompt + скомпилированный prompt DIALOGUE:. Вручную возиться с imageUrl не нужно.
JSON Schema запроса, CLI, линза режиссёра.
Полный справочник VideoConductor, CLI, линза истины.
Автономная генерация 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 |
Авто: draft + imageUrl → draft_i2v без явной передачи draft_i2v.
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Сцена, ACTION, строки DIALOGUE: |
imageUrl | Для 1.5 | string | Предсозданный кадр — пропускает firstFramePrompt |
firstFramePrompt | Для сценарного I2V | string | Автоматически создаёт still, если imageUrl отсутствует |
imageProvider | Нет | xai | google | Провайдер первого кадра (по умолчанию xai) |
Сценарная сцена (автоматический первый кадр + миниатюра):
Предсозданный imageUrl (пропустить первый кадр):
Ремастеринг с URL манифеста (edit):
Повторная генерация 720p (без URL источника):
Успешный ответ включает 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 |
production_i2v |
grok-imagine-video-1.5 |
| 720p |
| $0.14 |
| I2V remaster |
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"}]}'
ring-video-create prompt "DIALOGUE: …" imageUrl https://cdn.../still.jpg qualityMode draft duration 12
ring-video-create prompt "Sharpen scene; clearer lip movement for same dialogue" remaster true sourceVideoUrl https://vidgen.x.ai/.../draft.mp4 remasterFromRequestId <draft-request-id>
ring-video-create prompt "…same locked prompt…" remaster true imageUrl https://cdn.../still.jpg qualityMode production_i2v duration 12production_i2v |
grok-imagine-video-1.5 |
| 720p |
| $0.14 |
| I2V remaster |
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"}]}'
ring-video-create prompt "DIALOGUE: …" imageUrl https://cdn.../still.jpg qualityMode draft duration 12
ring-video-create prompt "Sharpen scene; clearer lip movement for same dialogue" remaster true sourceVideoUrl https://vidgen.x.ai/.../draft.mp4 remasterFromRequestId <draft-request-id>
ring-video-create prompt "…same locked prompt…" remaster true imageUrl https://cdn.../still.jpg qualityMode production_i2v duration 12production_i2v |
grok-imagine-video-1.5 |
| 720p |
| $0.14 |
| I2V remaster |
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"}]}'
ring-video-create prompt "DIALOGUE: …" imageUrl https://cdn.../still.jpg qualityMode draft duration 12
ring-video-create prompt "Sharpen scene; clearer lip movement for same dialogue" remaster true sourceVideoUrl https://vidgen.x.ai/.../draft.mp4 remasterFromRequestId <draft-request-id>
ring-video-create prompt "…same locked prompt…" remaster true imageUrl https://cdn.../still.jpg qualityMode production_i2v duration 12