Generative Videos (`VideoConductor`)

Ring Platform ships VideoConductor — async xAI Grok video generation with draft, draft_i2v, production, and production_i2v modes, mirroring the ImageConductor pattern.

Feature guide

For operators and architects, see the full VideoConductor feature guide — architecture diagrams, remaster strategies, database migration, and MCP walkthrough.

Model truth (corrected 2026-06-18)

Model	Modalities	Resolution	~$/sec	Script scenes
`grok-imagine-video`	Text-to-video + I2V + R2V + edit	480p, 720p	$0.05	Montages, UI demos — vague dialogue
`grok-imagine-video-1.5`	Image-to-video only (+ prompt for motion/script)	480p, 720p	$0.08 / $0.14	Preferred when `imageUrl` + `DIALOGUE:` prompt

Important: grok-imagine-video-1.5 is not text-only T2V. It requires a starting frame (imageUrl). Your intuition is correct that it also accepts a rich text prompt — that prompt drives motion and implied dialogue. xAI Imagine I2V · AIML 1.5 preview.

Workflow for nightclub / dialogue clips:

Author scripted-video-generation-request-*.json or pass firstFramePrompt on ring-video-create.
Pipeline auto-generates still → draft_i2v @ 480p + compiled DIALOGUE: prompt.
remaster: true @ 720p or sourceVideoUrl edit pass.

See Scripted media pipeline.

Lip-sync is best-effort — burn exact lines in post when word-perfect delivery matters.

Quality modes (SSOT: `lib/video/video-presets.json`)

`qualityMode`	Model	Resolution	~$/sec	Needs `imageUrl`
`draft` (default)	`grok-imagine-video`	480p	$0.05	No (T2V)
`draft_i2v`	`grok-imagine-video-1.5`	480p	$0.08	Yes
`production`	`grok-imagine-video`	720p	$0.05	No
`production_i2v`	`grok-imagine-video-1.5`	720p	$0.14	Yes

Auto-select: qualityMode: draft + imageUrl → draft_i2v (no extra flag needed).

Remaster strategies

Input	Behavior
`remaster: true` only	Re-generate at 720p (`production` or `production_i2v` if `imageUrl`)
`remaster: true` + `sourceVideoUrl`	`POST /v1/videos/edits` — edit existing manifest/CDN MP4 (xAI video editing)

Architecture

Layer	Path
Presets	`lib/video/video-presets.json`
Config	`lib/video/video.config.ts`
Provider	`lib/video/providers/xai.provider.ts`
Facade	`lib/video/conductor/video-conductor.ts`
Scripted media	`lib/media/*` — schema, prompt compiler, thumbnail
Scripted CLI	`scripts/ring-viral-video/run-scripted-video.mjs`
Legacy CLI	`scripts/ring-viral-video/generate-xai-videos.mjs`
Truth lens	`AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json`

Surfaces

Surface	Entry
MCP	`ring-video-create` → `POST /api/mcp/v1/videos/generate`
Scripted CLI	`node scripts/ring-viral-video/run-scripted-video.mjs <request.json>`
Legacy CLI	`node scripts/ring-viral-video/generate-xai-videos.mjs` (direct xAI)

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Field	Required	Notes
`prompt`	Yes	Motion, ACTION, DIALOGUE blocks
`qualityMode`	No	`draft` (default), `draft_i2v`, `production`, `production_i2v`
`imageUrl`	For 1.5	Auto-upgrades draft → `draft_i2v`
`sourceVideoUrl`	For edit remaster	Manifest `url` from prior clip
`remaster`	No	`true` → 720p re-gen or edit if URL set
`remasterFromRequestId`	No	Audit link to draft job

Environment

CLI

Manifest upserts by id::qualityMode — partial runs do not wipe prior clips.

Generative Videos (`VideoConductor`)

Ring Platform ships VideoConductor — async xAI Grok video generation with draft, draft_i2v, production, and production_i2v modes, mirroring the ImageConductor pattern.

Feature guide

For operators and architects, see the full VideoConductor feature guide — architecture diagrams, remaster strategies, database migration, and MCP walkthrough.

Model truth (corrected 2026-06-18)

Model	Modalities	Resolution	~$/sec	Script scenes
`grok-imagine-video`	Text-to-video + I2V + R2V + edit	480p, 720p	$0.05	Montages, UI demos — vague dialogue
`grok-imagine-video-1.5`	Image-to-video only (+ prompt for motion/script)	480p, 720p	$0.08 / $0.14	Preferred when `imageUrl` + `DIALOGUE:` prompt

Workflow for nightclub / dialogue clips:

Author scripted-video-generation-request-*.json or pass firstFramePrompt on ring-video-create.
Pipeline auto-generates still → draft_i2v @ 480p + compiled DIALOGUE: prompt.
remaster: true @ 720p or sourceVideoUrl edit pass.

See Scripted media pipeline.

Lip-sync is best-effort — burn exact lines in post when word-perfect delivery matters.

Quality modes (SSOT: `lib/video/video-presets.json`)

`qualityMode`	Model	Resolution	~$/sec	Needs `imageUrl`
`draft` (default)	`grok-imagine-video`	480p	$0.05	No (T2V)
`draft_i2v`	`grok-imagine-video-1.5`	480p	$0.08	Yes
`production`	`grok-imagine-video`	720p	$0.05	No
`production_i2v`	`grok-imagine-video-1.5`	720p	$0.14	Yes

Auto-select: qualityMode: draft + imageUrl → draft_i2v (no extra flag needed).

Remaster strategies

Input	Behavior
`remaster: true` only	Re-generate at 720p (`production` or `production_i2v` if `imageUrl`)
`remaster: true` + `sourceVideoUrl`	`POST /v1/videos/edits` — edit existing manifest/CDN MP4 (xAI video editing)

Architecture

Layer	Path
Presets	`lib/video/video-presets.json`
Config	`lib/video/video.config.ts`
Provider	`lib/video/providers/xai.provider.ts`
Facade	`lib/video/conductor/video-conductor.ts`
Scripted media	`lib/media/*` — schema, prompt compiler, thumbnail
Scripted CLI	`scripts/ring-viral-video/run-scripted-video.mjs`
Legacy CLI	`scripts/ring-viral-video/generate-xai-videos.mjs`
Truth lens	`AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json`

Surfaces

Surface	Entry
MCP	`ring-video-create` → `POST /api/mcp/v1/videos/generate`
Scripted CLI	`node scripts/ring-viral-video/run-scripted-video.mjs <request.json>`
Legacy CLI	`node scripts/ring-viral-video/generate-xai-videos.mjs` (direct xAI)

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Field	Required	Notes
`prompt`	Yes	Motion, ACTION, DIALOGUE blocks
`qualityMode`	No	`draft` (default), `draft_i2v`, `production`, `production_i2v`
`imageUrl`	For 1.5	Auto-upgrades draft → `draft_i2v`
`sourceVideoUrl`	For edit remaster	Manifest `url` from prior clip
`remaster`	No	`true` → 720p re-gen or edit if URL set
`remasterFromRequestId`	No	Audit link to draft job

Environment

CLI

Manifest upserts by id::qualityMode — partial runs do not wipe prior clips.

Generative Videos (`VideoConductor`)

Ring Platform ships VideoConductor — async xAI Grok video generation with draft, draft_i2v, production, and production_i2v modes, mirroring the ImageConductor pattern.

Feature guide

For operators and architects, see the full VideoConductor feature guide — architecture diagrams, remaster strategies, database migration, and MCP walkthrough.

Model truth (corrected 2026-06-18)

Model	Modalities	Resolution	~$/sec	Script scenes
`grok-imagine-video`	Text-to-video + I2V + R2V + edit	480p, 720p	$0.05	Montages, UI demos — vague dialogue
`grok-imagine-video-1.5`	Image-to-video only (+ prompt for motion/script)	480p, 720p	$0.08 / $0.14	Preferred when `imageUrl` + `DIALOGUE:` prompt

Workflow for nightclub / dialogue clips:

Author scripted-video-generation-request-*.json or pass firstFramePrompt on ring-video-create.
Pipeline auto-generates still → draft_i2v @ 480p + compiled DIALOGUE: prompt.
remaster: true @ 720p or sourceVideoUrl edit pass.

See Scripted media pipeline.

Lip-sync is best-effort — burn exact lines in post when word-perfect delivery matters.

Quality modes (SSOT: `lib/video/video-presets.json`)

`qualityMode`	Model	Resolution	~$/sec	Needs `imageUrl`
`draft` (default)	`grok-imagine-video`	480p	$0.05	No (T2V)
`draft_i2v`	`grok-imagine-video-1.5`	480p	$0.08	Yes
`production`	`grok-imagine-video`	720p	$0.05	No
`production_i2v`	`grok-imagine-video-1.5`	720p	$0.14	Yes

Auto-select: qualityMode: draft + imageUrl → draft_i2v (no extra flag needed).

Remaster strategies

Input	Behavior
`remaster: true` only	Re-generate at 720p (`production` or `production_i2v` if `imageUrl`)
`remaster: true` + `sourceVideoUrl`	`POST /v1/videos/edits` — edit existing manifest/CDN MP4 (xAI video editing)

Architecture

Layer	Path
Presets	`lib/video/video-presets.json`
Config	`lib/video/video.config.ts`
Provider	`lib/video/providers/xai.provider.ts`
Facade	`lib/video/conductor/video-conductor.ts`
Scripted media	`lib/media/*` — schema, prompt compiler, thumbnail
Scripted CLI	`scripts/ring-viral-video/run-scripted-video.mjs`
Legacy CLI	`scripts/ring-viral-video/generate-xai-videos.mjs`
Truth lens	`AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json`

Surfaces

Surface	Entry
MCP	`ring-video-create` → `POST /api/mcp/v1/videos/generate`
Scripted CLI	`node scripts/ring-viral-video/run-scripted-video.mjs <request.json>`
Legacy CLI	`node scripts/ring-viral-video/generate-xai-videos.mjs` (direct xAI)

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Field	Required	Notes
`prompt`	Yes	Motion, ACTION, DIALOGUE blocks
`qualityMode`	No	`draft` (default), `draft_i2v`, `production`, `production_i2v`
`imageUrl`	For 1.5	Auto-upgrades draft → `draft_i2v`
`sourceVideoUrl`	For edit remaster	Manifest `url` from prior clip
`remaster`	No	`true` → 720p re-gen or edit if URL set
`remasterFromRequestId`	No	Audit link to draft job

Environment

CLI

Manifest upserts by id::qualityMode — partial runs do not wipe prior clips.

json


{
  "prompt": "ACTION: man leans in. DIALOGUE: Man says: \"So your HOA uses Ring?\"",
  "firstFramePrompt": "Cinematic still, guy and girl at SF nightclub bar, neon magenta lights, silver ring visible",
  "qualityMode": "draft",
  "duration": 12,
  "clipId": "03_sf_nightclub_ring_opener",
  "pipelineRequestId": "hoa-nightclub-viral-2026-06"
}

json


{
  "prompt": "Improve clarity and lighting; characters speak the same dialogue with clearer lip movement",
  "remaster": true,
  "sourceVideoUrl": "https://vidgen.x.ai/.../draft.mp4",
  "remasterFromRequestId": "prior-draft-request-id"
}

bash


XAI_API_KEY=your_key
XAI_API_BASE_URL=https://api.x.ai/v1

VIDEO_GEN_POLL_TIMEOUT_MS=900000
VIDEO_GEN_POLL_INTERVAL_MS=5000
VIDEO_GEN_STORAGE_PREFIX=generated/videos
XAI_VIDEO_DEFAULT_DURATION=6
XAI_VIDEO_ASPECT_RATIO=16:9

bash


cd ring-platform.org/scripts/ring-viral-video
# Scripted pipeline (gateway + firstFrame + thumbnail)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Legacy direct xAI
node generate-xai-videos.mjs --draft 01_hoa_video_call_pains --download

text


Surface (MCP / CLI / server code)
  → VideoConductor.generate | .remaster | .editFromSource
    → xAI POST /v1/videos/generations | /v1/videos/edits → request_id
    → poll GET /v1/videos/{request_id}
    → optional file().upload(generated/videos/…)
  → { success, video: { url, temporaryUrl, requestId, … } }

json


{
  "prompt": "ACTION: man leans in. DIALOGUE: Man says: \"So your HOA uses Ring?\"",
  "firstFramePrompt": "Cinematic still, guy and girl at SF nightclub bar, neon magenta lights, silver ring visible",
  "qualityMode": "draft",
  "duration": 12,
  "clipId": "03_sf_nightclub_ring_opener",
  "pipelineRequestId": "hoa-nightclub-viral-2026-06"
}

json


{
  "prompt": "Improve clarity and lighting; characters speak the same dialogue with clearer lip movement",
  "remaster": true,
  "sourceVideoUrl": "https://vidgen.x.ai/.../draft.mp4",
  "remasterFromRequestId": "prior-draft-request-id"
}

bash


XAI_API_KEY=your_key
XAI_API_BASE_URL=https://api.x.ai/v1

VIDEO_GEN_POLL_TIMEOUT_MS=900000
VIDEO_GEN_POLL_INTERVAL_MS=5000
VIDEO_GEN_STORAGE_PREFIX=generated/videos
XAI_VIDEO_DEFAULT_DURATION=6
XAI_VIDEO_ASPECT_RATIO=16:9

bash


cd ring-platform.org/scripts/ring-viral-video
# Scripted pipeline (gateway + firstFrame + thumbnail)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Legacy direct xAI
node generate-xai-videos.mjs --draft 01_hoa_video_call_pains --download

text


Surface (MCP / CLI / server code)
  → VideoConductor.generate | .remaster | .editFromSource
    → xAI POST /v1/videos/generations | /v1/videos/edits → request_id
    → poll GET /v1/videos/{request_id}
    → optional file().upload(generated/videos/…)
  → { success, video: { url, temporaryUrl, requestId, … } }

json


{
  "prompt": "ACTION: man leans in. DIALOGUE: Man says: \"So your HOA uses Ring?\"",
  "firstFramePrompt": "Cinematic still, guy and girl at SF nightclub bar, neon magenta lights, silver ring visible",
  "qualityMode": "draft",
  "duration": 12,
  "clipId": "03_sf_nightclub_ring_opener",
  "pipelineRequestId": "hoa-nightclub-viral-2026-06"
}

json


{
  "prompt": "Improve clarity and lighting; characters speak the same dialogue with clearer lip movement",
  "remaster": true,
  "sourceVideoUrl": "https://vidgen.x.ai/.../draft.mp4",
  "remasterFromRequestId": "prior-draft-request-id"
}

bash


XAI_API_KEY=your_key
XAI_API_BASE_URL=https://api.x.ai/v1

VIDEO_GEN_POLL_TIMEOUT_MS=900000
VIDEO_GEN_POLL_INTERVAL_MS=5000
VIDEO_GEN_STORAGE_PREFIX=generated/videos
XAI_VIDEO_DEFAULT_DURATION=6
XAI_VIDEO_ASPECT_RATIO=16:9

bash


cd ring-platform.org/scripts/ring-viral-video
# Scripted pipeline (gateway + firstFrame + thumbnail)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Legacy direct xAI
node generate-xai-videos.mjs --draft 01_hoa_video_call_pains --download

text


Surface (MCP / CLI / server code)
  → VideoConductor.generate | .remaster | .editFromSource
    → xAI POST /v1/videos/generations | /v1/videos/edits → request_id
    → poll GET /v1/videos/{request_id}
    → optional file().upload(generated/videos/…)
  → { success, video: { url, temporaryUrl, requestId, … } }

Documentation

Documentation

Documentation

Завантаження документації...

Documentation

Завантаження документації...

Documentation

Завантаження документації...

Documentation

Завантаження документації...

Завантаження документації...

Завантаження документації...

Quick entry (CTOs · auditors · agents)

Quick entry (CTOs · auditors · agents)

Quick entry (CTOs · auditors · agents)

Generative Videos (VideoConductor)

Model truth (corrected 2026-06-18)

Quality modes (SSOT: lib/video/video-presets.json)

Remaster strategies

Architecture

Surfaces

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Environment

CLI

Generative Videos (VideoConductor)

Model truth (corrected 2026-06-18)

Quality modes (SSOT: lib/video/video-presets.json)

Remaster strategies

Architecture

Surfaces

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Environment

CLI

Generative Videos (VideoConductor)

Model truth (corrected 2026-06-18)

Quality modes (SSOT: lib/video/video-presets.json)

Remaster strategies

Architecture

Surfaces

MCP request — scripted scene (auto first frame)

MCP request — remaster from manifest URL

Environment

CLI

Generative Videos (`VideoConductor`)

Quality modes (SSOT: `lib/video/video-presets.json`)

Generative Videos (`VideoConductor`)

Quality modes (SSOT: `lib/video/video-presets.json`)

Generative Videos (`VideoConductor`)

Quality modes (SSOT: `lib/video/video-presets.json`)