Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
Незалежний від провайдера, схемокерований пайплайн для маркетингових і пояснювальних роликів. Креативний агент створює один scripted-video-generation-request-<id>.json; ring-video-create послідовно виконує:
firstFramePrompt → ImageConductor)next/og)Довідник інструмента MCP (перевантажений шлях сцени).
Пресети VideoConductor і режими ремастерингу.
Creative agent → scripted-video-generation-request.json
→ run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
→ VideoConductor.generate
→ ImageConductor (firstFramePrompt)
→ xAI I2V (compiled ACTION/DIALOGUE prompt)
→ thumbnail compositor (optional)
→ manifest v3 + ring-filebase URLs| Артефакт | Шлях |
|---|---|
| JSON Schema | lib/media/scripted-video-generation.schema.json |
| Валідація Zod | lib/media/schemas.ts |
| Компілятор prompt | lib/media/prompt-compiler.ts |
| Мініатюра | lib/media/thumbnail.tsx |
| Приклад запиту | scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json |
| Запускач CLI | scripts/ring-viral-video/run-scripted-video.mjs |
| Лінза режисера | AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json |
Заповнювачі персонажів: {{guy}}, {{girl}} під час компіляції розгортаються у cast[].description.
| Тип | firstFrame | scene.dialogue | Режим відео |
|---|---|---|---|
| Монтаж / UI | не вказувати | необов’язковий | T2V grok-imagine-video @ 480p |
| Діалог | imagePrompt обов’язковий | обов’язковий | I2V grok-imagine-video-1.5 @ 480p |
Маніфест v3 зберігає firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId для кожного ключа оновлення id::qualityMode.
Із thumbnail.enabled у body — дивіться ring-video-create.
Під час створення запитів звертайтеся до лінзи істини scripted-video-director. Перевіряйте за допомогою:
xai-video-jobs.json + generate-xai-videos.mjs залишаються для пакетних запусків безпосередньо через xAI без gateway. Для нових кампаній віддавайте перевагу файлу сценарного запиту.
Незалежний від провайдера, схемокерований пайплайн для маркетингових і пояснювальних роликів. Креативний агент створює один scripted-video-generation-request-<id>.json; ring-video-create послідовно виконує:
firstFramePrompt → ImageConductor)next/og)Довідник інструмента MCP (перевантажений шлях сцени).
Пресети VideoConductor і режими ремастерингу.
Creative agent → scripted-video-generation-request.json
→ run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
→ VideoConductor.generate
→ ImageConductor (firstFramePrompt)
→ xAI I2V (compiled ACTION/DIALOGUE prompt)
→ thumbnail compositor (optional)
→ manifest v3 + ring-filebase URLs| Артефакт | Шлях |
|---|---|
| JSON Schema | lib/media/scripted-video-generation.schema.json |
| Валідація Zod | lib/media/schemas.ts |
| Компілятор prompt | lib/media/prompt-compiler.ts |
| Мініатюра | lib/media/thumbnail.tsx |
| Приклад запиту | scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json |
| Запускач CLI | scripts/ring-viral-video/run-scripted-video.mjs |
| Лінза режисера | AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json |
Заповнювачі персонажів: {{guy}}, {{girl}} під час компіляції розгортаються у cast[].description.
| Тип | firstFrame | scene.dialogue | Режим відео |
|---|---|---|---|
| Монтаж / UI | не вказувати | необов’язковий | T2V grok-imagine-video @ 480p |
| Діалог | imagePrompt обов’язковий | обов’язковий | I2V grok-imagine-video-1.5 @ 480p |
Маніфест v3 зберігає firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId для кожного ключа оновлення id::qualityMode.
Із thumbnail.enabled у body — дивіться ring-video-create.
Під час створення запитів звертайтеся до лінзи істини scripted-video-director. Перевіряйте за допомогою:
xai-video-jobs.json + generate-xai-videos.mjs залишаються для пакетних запусків безпосередньо через xAI без gateway. Для нових кампаній віддавайте перевагу файлу сценарного запиту.
Незалежний від провайдера, схемокерований пайплайн для маркетингових і пояснювальних роликів. Креативний агент створює один scripted-video-generation-request-<id>.json; ring-video-create послідовно виконує:
firstFramePrompt → ImageConductor)next/og)Довідник інструмента MCP (перевантажений шлях сцени).
Пресети VideoConductor і режими ремастерингу.
Creative agent → scripted-video-generation-request.json
→ run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
→ VideoConductor.generate
→ ImageConductor (firstFramePrompt)
→ xAI I2V (compiled ACTION/DIALOGUE prompt)
→ thumbnail compositor (optional)
→ manifest v3 + ring-filebase URLs| Артефакт | Шлях |
|---|---|
| JSON Schema | lib/media/scripted-video-generation.schema.json |
| Валідація Zod | lib/media/schemas.ts |
| Компілятор prompt | lib/media/prompt-compiler.ts |
| Мініатюра | lib/media/thumbnail.tsx |
| Приклад запиту | scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json |
| Запускач CLI | scripts/ring-viral-video/run-scripted-video.mjs |
| Лінза режисера | AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json |
Заповнювачі персонажів: {{guy}}, {{girl}} під час компіляції розгортаються у cast[].description.
| Тип | firstFrame | scene.dialogue | Режим відео |
|---|---|---|---|
| Монтаж / UI | не вказувати | необов’язковий | T2V grok-imagine-video @ 480p |
| Діалог | imagePrompt обов’язковий | обов’язковий | I2V grok-imagine-video-1.5 @ 480p |
Маніфест v3 зберігає firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId для кожного ключа оновлення id::qualityMode.
Із thumbnail.enabled у body — дивіться ring-video-create.
Під час створення запитів звертайтеся до лінзи істини scripted-video-director. Перевіряйте за допомогою:
xai-video-jobs.json + generate-xai-videos.mjs залишаються для пакетних запусків безпосередньо через xAI без gateway. Для нових кампаній віддавайте перевагу файлу сценарного запиту.
{
"schemaVersion": "1.0",
"requestId": "hoa-nightclub-viral-2026-06",
"purpose": "viral-ad",
"defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
"cast": [{ "id": "guy", "description": "…" }],
"setting": "San Francisco nightclub at night…",
"clips": [{
"id": "03_sf_nightclub_ring_opener",
"duration": 12,
"firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
"scene": {
"action": "{{guy}} gestures warmly…",
"dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
},
"thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
}]
}
cd ring-platform.org/scripts/ring-viral-video
# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener
# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...
import { scriptedVideoGenerationRequestSchema } from '@/lib/media/schemas'
scriptedVideoGenerationRequestSchema.parse(request)
XAI_API_KEY=…
RING_MCP_ACCESS_KEY=long-random-token
RING_API_BASE_URL=http://localhost:3000
FILE_BACKEND=ringbase
ring-video-create \
prompt "ACTION: … DIALOGUE: …" \
firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener
{
"schemaVersion": "1.0",
"requestId": "hoa-nightclub-viral-2026-06",
"purpose": "viral-ad",
"defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
"cast": [{ "id": "guy", "description": "…" }],
"setting": "San Francisco nightclub at night…",
"clips": [{
"id": "03_sf_nightclub_ring_opener",
"duration": 12,
"firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
"scene": {
"action": "{{guy}} gestures warmly…",
"dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
},
"thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
}]
}
cd ring-platform.org/scripts/ring-viral-video
# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener
# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...
import { scriptedVideoGenerationRequestSchema } from '@/lib/media/schemas'
scriptedVideoGenerationRequestSchema.parse(request)
XAI_API_KEY=…
RING_MCP_ACCESS_KEY=long-random-token
RING_API_BASE_URL=http://localhost:3000
FILE_BACKEND=ringbase
ring-video-create \
prompt "ACTION: … DIALOGUE: …" \
firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener
{
"schemaVersion": "1.0",
"requestId": "hoa-nightclub-viral-2026-06",
"purpose": "viral-ad",
"defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
"cast": [{ "id": "guy", "description": "…" }],
"setting": "San Francisco nightclub at night…",
"clips": [{
"id": "03_sf_nightclub_ring_opener",
"duration": 12,
"firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
"scene": {
"action": "{{guy}} gestures warmly…",
"dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
},
"thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
}]
}
cd ring-platform.org/scripts/ring-viral-video
# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download
# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener
# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...
import { scriptedVideoGenerationRequestSchema } from '@/lib/media/schemas'
scriptedVideoGenerationRequestSchema.parse(request)
XAI_API_KEY=…
RING_MCP_ACCESS_KEY=long-random-token
RING_API_BASE_URL=http://localhost:3000
FILE_BACKEND=ringbase
ring-video-create \
prompt "ACTION: … DIALOGUE: …" \
firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener