Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
VideoConductor — це асинхронний шар генеративного відео Ring Platform — відеоаналог ImageConductor. Він опитує xAI Grok Imagine Video, за потреби завантажує MP4 у ring-filebase та записує рядок аудиту в PostgreSQL generated_videos.
Використовуйте вкладки Founder / Developer на бічній панелі документації, щоб відфільтрувати цю сторінку. Засновники бачать операційні процеси й контроль витрат; розробники — API фасаду, payload MCP та сховище.
Оператори й агенти викликають ring-video-create (MCP) або VideoConductor із серверного коду. Типовий режим draft використовує grok-imagine-video @ 480p (~$0.05/second) для дешевої ітерації text-to-video. Встановіть remaster: true для фіналів 720p або передайте sourceVideoUrl для монтажу/remaster зі збереженням сцени через API редагування відео xAI. Статичні зображення першого кадру створюються через ImageConductor.
| Можливість | Деталі |
|---|---|
| Text-to-video (T2V) | grok-imagine-video — монтажі, демо UI, нечіткі діалоги |
| Image-to-video (I2V) | grok-imagine-video-1.5 — потребує imageUrl; prompt керує рухом |
| Ітерація чернетки | Пресети 480p — мінімізують витрати під час сценарної роботи |
| Продакшен-remaster | Повторна генерація 720p або редагування наявного MP4 URL |
| Автоматизація першого кадру | firstFramePrompt → ImageConductor, коли imageUrl відсутній |
| Накладки мініатюри | Необов’язкова специфікація thumbnail через lib/media/thumbnail |
| Збереження | CDN URL ring-filebase + JSONB-реєстр generated_videos |
| Аудит pipeline | clipId, pipelineRequestId, refCode, actorId |
SSOT: lib/video/video-presets.json. Передавання imageUrl у запиті draft автоматично підвищує режим до draft_i2v.
qualityMode | Модель | Роздільність | ~$/sec | Потрібен imageUrl |
|---|---|---|---|---|
draft (типовий) | grok-imagine-video | 480p | $0.05 | Ні (T2V) |
draft_i2v | grok-imagine-video-1.5 | 480p | $0.08 | Так |
production | grok-imagine-video | 720p | $0.05 | Ні |
production_i2v |
grok-imagine-video-1.5 — не T2V лише з тексту: йому потрібен початковий кадр (imageUrl або firstFramePrompt). Для дослівних реплік записуйте VO на постпродакшені або сприймайте блоки DIALOGUE: як рекомендації без гарантії.
Інструмент із Bearer-захистом для агентів і ops — створюйте чернеткові кліпи без дотику до серверного коду.
Кампанії з кількома кліпами на основі маніфесту з upsert-ами draft → remaster.
Статичні зображення першого кадру та спільні облікові дані xAI для I2V-сцен.
Поле продукту/NFT gallery; полірування відеостудії перебуває в беклозі (GENERATIVE_CREDIT_VIDEO).
Приклади CLI, таблиця цін моделей, застарілий generate script.
Спільний блок xAI і генерація першого кадру.
Модель conductor для грошових шляхів гаманця.
| Дата | Етап |
|---|---|
| 2026-06-09 | ImageConductor — реєстр generated_images, MCP ring-image-create |
| 2026-06-18 | VideoConductor v1 — T2V draft/production, MCP ring-video-create, manifest v2 |
| 2026-06-18 | Режими I2V — draft_i2v / production_i2v, firstFramePrompt, edit remaster через sourceVideoUrl |
| 2026-06-19 | Міграція 018 — generated_videos на dev + prod |
| 2026-07-12 | Документація для двох аудиторій — шлях операцій Founder проти API/сховища Developer |
VideoConductor — це асинхронний шар генеративного відео Ring Platform — відеоаналог ImageConductor. Він опитує xAI Grok Imagine Video, за потреби завантажує MP4 у ring-filebase та записує рядок аудиту в PostgreSQL generated_videos.
Використовуйте вкладки Founder / Developer на бічній панелі документації, щоб відфільтрувати цю сторінку. Засновники бачать операційні процеси й контроль витрат; розробники — API фасаду, payload MCP та сховище.
Оператори й агенти викликають ring-video-create (MCP) або VideoConductor із серверного коду. Типовий режим draft використовує grok-imagine-video @ 480p (~$0.05/second) для дешевої ітерації text-to-video. Встановіть remaster: true для фіналів 720p або передайте sourceVideoUrl для монтажу/remaster зі збереженням сцени через API редагування відео xAI. Статичні зображення першого кадру створюються через ImageConductor.
| Можливість | Деталі |
|---|---|
| Text-to-video (T2V) | grok-imagine-video — монтажі, демо UI, нечіткі діалоги |
| Image-to-video (I2V) | grok-imagine-video-1.5 — потребує imageUrl; prompt керує рухом |
| Ітерація чернетки | Пресети 480p — мінімізують витрати під час сценарної роботи |
| Продакшен-remaster | Повторна генерація 720p або редагування наявного MP4 URL |
| Автоматизація першого кадру | firstFramePrompt → ImageConductor, коли imageUrl відсутній |
| Накладки мініатюри | Необов’язкова специфікація thumbnail через lib/media/thumbnail |
| Збереження | CDN URL ring-filebase + JSONB-реєстр generated_videos |
| Аудит pipeline | clipId, pipelineRequestId, refCode, actorId |
SSOT: lib/video/video-presets.json. Передавання imageUrl у запиті draft автоматично підвищує режим до draft_i2v.
qualityMode | Модель | Роздільність | ~$/sec | Потрібен imageUrl |
|---|---|---|---|---|
draft (типовий) | grok-imagine-video | 480p | $0.05 | Ні (T2V) |
draft_i2v | grok-imagine-video-1.5 | 480p | $0.08 | Так |
production | grok-imagine-video | 720p | $0.05 | Ні |
production_i2v |
grok-imagine-video-1.5 — не T2V лише з тексту: йому потрібен початковий кадр (imageUrl або firstFramePrompt). Для дослівних реплік записуйте VO на постпродакшені або сприймайте блоки DIALOGUE: як рекомендації без гарантії.
Інструмент із Bearer-захистом для агентів і ops — створюйте чернеткові кліпи без дотику до серверного коду.
Кампанії з кількома кліпами на основі маніфесту з upsert-ами draft → remaster.
Статичні зображення першого кадру та спільні облікові дані xAI для I2V-сцен.
Поле продукту/NFT gallery; полірування відеостудії перебуває в беклозі (GENERATIVE_CREDIT_VIDEO).
Приклади CLI, таблиця цін моделей, застарілий generate script.
Спільний блок xAI і генерація першого кадру.
Модель conductor для грошових шляхів гаманця.
| Дата | Етап |
|---|---|
| 2026-06-09 | ImageConductor — реєстр generated_images, MCP ring-image-create |
| 2026-06-18 | VideoConductor v1 — T2V draft/production, MCP ring-video-create, manifest v2 |
| 2026-06-18 | Режими I2V — draft_i2v / production_i2v, firstFramePrompt, edit remaster через sourceVideoUrl |
| 2026-06-19 | Міграція 018 — generated_videos на dev + prod |
| 2026-07-12 | Документація для двох аудиторій — шлях операцій Founder проти API/сховища Developer |
VideoConductor — це асинхронний шар генеративного відео Ring Platform — відеоаналог ImageConductor. Він опитує xAI Grok Imagine Video, за потреби завантажує MP4 у ring-filebase та записує рядок аудиту в PostgreSQL generated_videos.
Використовуйте вкладки Founder / Developer на бічній панелі документації, щоб відфільтрувати цю сторінку. Засновники бачать операційні процеси й контроль витрат; розробники — API фасаду, payload MCP та сховище.
Оператори й агенти викликають ring-video-create (MCP) або VideoConductor із серверного коду. Типовий режим draft використовує grok-imagine-video @ 480p (~$0.05/second) для дешевої ітерації text-to-video. Встановіть remaster: true для фіналів 720p або передайте sourceVideoUrl для монтажу/remaster зі збереженням сцени через API редагування відео xAI. Статичні зображення першого кадру створюються через ImageConductor.
| Можливість | Деталі |
|---|---|
| Text-to-video (T2V) | grok-imagine-video — монтажі, демо UI, нечіткі діалоги |
| Image-to-video (I2V) | grok-imagine-video-1.5 — потребує imageUrl; prompt керує рухом |
| Ітерація чернетки | Пресети 480p — мінімізують витрати під час сценарної роботи |
| Продакшен-remaster | Повторна генерація 720p або редагування наявного MP4 URL |
| Автоматизація першого кадру | firstFramePrompt → ImageConductor, коли imageUrl відсутній |
| Накладки мініатюри | Необов’язкова специфікація thumbnail через lib/media/thumbnail |
| Збереження | CDN URL ring-filebase + JSONB-реєстр generated_videos |
| Аудит pipeline | clipId, pipelineRequestId, refCode, actorId |
SSOT: lib/video/video-presets.json. Передавання imageUrl у запиті draft автоматично підвищує режим до draft_i2v.
qualityMode | Модель | Роздільність | ~$/sec | Потрібен imageUrl |
|---|---|---|---|---|
draft (типовий) | grok-imagine-video | 480p | $0.05 | Ні (T2V) |
draft_i2v | grok-imagine-video-1.5 | 480p | $0.08 | Так |
production | grok-imagine-video | 720p | $0.05 | Ні |
production_i2v |
grok-imagine-video-1.5 — не T2V лише з тексту: йому потрібен початковий кадр (imageUrl або firstFramePrompt). Для дослівних реплік записуйте VO на постпродакшені або сприймайте блоки DIALOGUE: як рекомендації без гарантії.
Інструмент із Bearer-захистом для агентів і ops — створюйте чернеткові кліпи без дотику до серверного коду.
Кампанії з кількома кліпами на основі маніфесту з upsert-ами draft → remaster.
Статичні зображення першого кадру та спільні облікові дані xAI для I2V-сцен.
Поле продукту/NFT gallery; полірування відеостудії перебуває в беклозі (GENERATIVE_CREDIT_VIDEO).
Приклади CLI, таблиця цін моделей, застарілий generate script.
Спільний блок xAI і генерація першого кадру.
Модель conductor для грошових шляхів гаманця.
| Дата | Етап |
|---|---|
| 2026-06-09 | ImageConductor — реєстр generated_images, MCP ring-image-create |
| 2026-06-18 | VideoConductor v1 — T2V draft/production, MCP ring-video-create, manifest v2 |
| 2026-06-18 | Режими I2V — draft_i2v / production_i2v, firstFramePrompt, edit remaster через sourceVideoUrl |
| 2026-06-19 | Міграція 018 — generated_videos на dev + prod |
| 2026-07-12 | Документація для двох аудиторій — шлях операцій Founder проти API/сховища Developer |
grok-imagine-video-1.5| 720p |
| $0.14 |
| Так |
Та сама модель conductor для грошових шляхів (поповнення, desk, кастодіальне відправлення).
| Поверхня | Вхід | Auth |
|---|---|---|
| MCP | ring-video-create → POST /api/mcp/v1/videos/generate | Bearer RING_MCP_ACCESS_KEY |
| Сценарний CLI | node scripts/ring-viral-video/run-scripted-video.mjs <request.json> | Локальний XAI_API_KEY + gateway token |
| Серверний код | VideoConductor.generate / .remaster / .editFromSource | Runtime застосунку |
| Вхід | Поведінка |
|---|---|
remaster: true лише | Повторна генерація в 720p |
remaster: true + sourceVideoUrl | POST /v1/videos/edits — редагування зі збереженням сцени |
Створюйте кожну сцену в 480p
Використовуйте qualityMode: draft (або draft_i2v зі статичним кадром), доки композиція й рух не стануть прийнятними. CLI маніфестів робить upsert за id::qualityMode — часткові запуски ніколи не стирають попередні кліпи.
Робіть remaster переможців у 720p
Викликайте з remaster: true для схвалених кліпів або передавайте sourceVideoUrl із чернеткового маніфесту для редагування зі збереженням композиції.
Зберігайте в ring-filebase
Залишайте persistToFilebase зі значенням за замовчуванням true, щоб оператори отримували постійні CDN URL замість тимчасових посилань xAI, що спливають.
Вважайте витрати на чернетки навчальним бюджетом. Робіть remaster лише кліпів, які пройшли перевірку — це головний важіль контролю вартості відео xAI.
lib/video/providers/xai.provider.ts| Схема запиту | lib/media/schemas.ts → generateVideoBodySchema |
| MCP route | app/api/mcp/v1/videos/generate/route.ts |
| Сценарні медіа | lib/media/* — компілятор prompt, рендерер thumbnail |
| Truth lens | AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json |
| Поле | Обов’язкове | Примітки |
|---|---|---|
prompt | Так | Рух, блоки ACTION, DIALOGUE |
qualityMode | Ні | draft (типовий), draft_i2v, production, production_i2v |
imageUrl | Для 1.5 I2V | Автоматично підвищує draft → draft_i2v |
firstFramePrompt | Ні | Викликає ImageConductor, коли imageUrl відсутній |
thumbnail | Ні | ThumbnailSpec — накладки на перший кадр |
sourceVideoUrl | Для edit remaster | url попереднього кліпу з маніфесту або CDN |
remaster | Ні | true → VideoConductor.remaster() |
remasterFromRequestId | Ні | Аудитне посилання на xAI job чернетки |
persistToFilebase | Ні | Типово true |
clipId / pipelineRequestId | Ні | Відстеження кампаній із кількома кліпами |
purpose / refCode | Ні | Шлях сховища + атрибуція referral |
actorId встановлюється на сервері через MCP guard — ніколи не довіряйте actor id, переданому клієнтом на gateway.
Застосуйте міграцію data/migrations/018_generative_media_conductor_schema.sql (ідемпотентна).
| Таблиця | Роль |
|---|---|
generated_videos | Один рядок на збережений кліп — JSONB data містить GeneratedVideoRecord |
generated_images | Статичні зображення першого кадру від ImageConductor (окремий реєстр) |
Проіндексовані шляхи JSONB: actorId, provider, purpose, refCode, clipId, pipelineRequestId, qualityMode, requestId, generationKind, remasterFromRequestId.
BackendSelector спрямовує generated_videos і generated_images до PostgreSQL. Якщо таблиці немає, upload static image все одно завершується успішно; persist записує warning, доки не буде застосовано міграцію 018.
Із env.local.template — повторно використовуйте XAI_API_KEY з ImageConductor:
Ніколи не комітьте XAI_API_KEY або RING_MCP_ACCESS_KEY. MCP routes захищені Bearer через withMcpGuard.
| Поле | Опис |
|---|---|
video.url | Постійний CDN URL (коли збережено) або тимчасовий URL xAI |
video.temporaryUrl | Оригінальне посилання xAI для завантаження (спливає) |
video.requestId | ID xAI job — аудит і ланцюжки remaster |
video.recordId | ID рядка generated_videos |
firstFrame | Ресурс ImageConductor, коли використано firstFramePrompt |
thumbnail | Рендерена мініатюра, коли thumbnail.enabled |
estimatedCostUsd | Оцінка duration × preset rate |
qualityMode / resolution | Фактичний preset після автоматичного підвищення |
Помилки модерації повертають success: false, коли xAI встановлює respect_moderation: false.
Довідник MDX-віджетів для авторингу.
grok-imagine-video-1.5| 720p |
| $0.14 |
| Так |
Та сама модель conductor для грошових шляхів (поповнення, desk, кастодіальне відправлення).
| Поверхня | Вхід | Auth |
|---|---|---|
| MCP | ring-video-create → POST /api/mcp/v1/videos/generate | Bearer RING_MCP_ACCESS_KEY |
| Сценарний CLI | node scripts/ring-viral-video/run-scripted-video.mjs <request.json> | Локальний XAI_API_KEY + gateway token |
| Серверний код | VideoConductor.generate / .remaster / .editFromSource | Runtime застосунку |
| Вхід | Поведінка |
|---|---|
remaster: true лише | Повторна генерація в 720p |
remaster: true + sourceVideoUrl | POST /v1/videos/edits — редагування зі збереженням сцени |
Створюйте кожну сцену в 480p
Використовуйте qualityMode: draft (або draft_i2v зі статичним кадром), доки композиція й рух не стануть прийнятними. CLI маніфестів робить upsert за id::qualityMode — часткові запуски ніколи не стирають попередні кліпи.
Робіть remaster переможців у 720p
Викликайте з remaster: true для схвалених кліпів або передавайте sourceVideoUrl із чернеткового маніфесту для редагування зі збереженням композиції.
Зберігайте в ring-filebase
Залишайте persistToFilebase зі значенням за замовчуванням true, щоб оператори отримували постійні CDN URL замість тимчасових посилань xAI, що спливають.
Вважайте витрати на чернетки навчальним бюджетом. Робіть remaster лише кліпів, які пройшли перевірку — це головний важіль контролю вартості відео xAI.
lib/video/providers/xai.provider.ts| Схема запиту | lib/media/schemas.ts → generateVideoBodySchema |
| MCP route | app/api/mcp/v1/videos/generate/route.ts |
| Сценарні медіа | lib/media/* — компілятор prompt, рендерер thumbnail |
| Truth lens | AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json |
| Поле | Обов’язкове | Примітки |
|---|---|---|
prompt | Так | Рух, блоки ACTION, DIALOGUE |
qualityMode | Ні | draft (типовий), draft_i2v, production, production_i2v |
imageUrl | Для 1.5 I2V | Автоматично підвищує draft → draft_i2v |
firstFramePrompt | Ні | Викликає ImageConductor, коли imageUrl відсутній |
thumbnail | Ні | ThumbnailSpec — накладки на перший кадр |
sourceVideoUrl | Для edit remaster | url попереднього кліпу з маніфесту або CDN |
remaster | Ні | true → VideoConductor.remaster() |
remasterFromRequestId | Ні | Аудитне посилання на xAI job чернетки |
persistToFilebase | Ні | Типово true |
clipId / pipelineRequestId | Ні | Відстеження кампаній із кількома кліпами |
purpose / refCode | Ні | Шлях сховища + атрибуція referral |
actorId встановлюється на сервері через MCP guard — ніколи не довіряйте actor id, переданому клієнтом на gateway.
Застосуйте міграцію data/migrations/018_generative_media_conductor_schema.sql (ідемпотентна).
| Таблиця | Роль |
|---|---|
generated_videos | Один рядок на збережений кліп — JSONB data містить GeneratedVideoRecord |
generated_images | Статичні зображення першого кадру від ImageConductor (окремий реєстр) |
Проіндексовані шляхи JSONB: actorId, provider, purpose, refCode, clipId, pipelineRequestId, qualityMode, requestId, generationKind, remasterFromRequestId.
BackendSelector спрямовує generated_videos і generated_images до PostgreSQL. Якщо таблиці немає, upload static image все одно завершується успішно; persist записує warning, доки не буде застосовано міграцію 018.
Із env.local.template — повторно використовуйте XAI_API_KEY з ImageConductor:
Ніколи не комітьте XAI_API_KEY або RING_MCP_ACCESS_KEY. MCP routes захищені Bearer через withMcpGuard.
| Поле | Опис |
|---|---|
video.url | Постійний CDN URL (коли збережено) або тимчасовий URL xAI |
video.temporaryUrl | Оригінальне посилання xAI для завантаження (спливає) |
video.requestId | ID xAI job — аудит і ланцюжки remaster |
video.recordId | ID рядка generated_videos |
firstFrame | Ресурс ImageConductor, коли використано firstFramePrompt |
thumbnail | Рендерена мініатюра, коли thumbnail.enabled |
estimatedCostUsd | Оцінка duration × preset rate |
qualityMode / resolution | Фактичний preset після автоматичного підвищення |
Помилки модерації повертають success: false, коли xAI встановлює respect_moderation: false.
Довідник MDX-віджетів для авторингу.
grok-imagine-video-1.5| 720p |
| $0.14 |
| Так |
Та сама модель conductor для грошових шляхів (поповнення, desk, кастодіальне відправлення).
| Поверхня | Вхід | Auth |
|---|---|---|
| MCP | ring-video-create → POST /api/mcp/v1/videos/generate | Bearer RING_MCP_ACCESS_KEY |
| Сценарний CLI | node scripts/ring-viral-video/run-scripted-video.mjs <request.json> | Локальний XAI_API_KEY + gateway token |
| Серверний код | VideoConductor.generate / .remaster / .editFromSource | Runtime застосунку |
| Вхід | Поведінка |
|---|---|
remaster: true лише | Повторна генерація в 720p |
remaster: true + sourceVideoUrl | POST /v1/videos/edits — редагування зі збереженням сцени |
Створюйте кожну сцену в 480p
Використовуйте qualityMode: draft (або draft_i2v зі статичним кадром), доки композиція й рух не стануть прийнятними. CLI маніфестів робить upsert за id::qualityMode — часткові запуски ніколи не стирають попередні кліпи.
Робіть remaster переможців у 720p
Викликайте з remaster: true для схвалених кліпів або передавайте sourceVideoUrl із чернеткового маніфесту для редагування зі збереженням композиції.
Зберігайте в ring-filebase
Залишайте persistToFilebase зі значенням за замовчуванням true, щоб оператори отримували постійні CDN URL замість тимчасових посилань xAI, що спливають.
Вважайте витрати на чернетки навчальним бюджетом. Робіть remaster лише кліпів, які пройшли перевірку — це головний важіль контролю вартості відео xAI.
lib/video/providers/xai.provider.ts| Схема запиту | lib/media/schemas.ts → generateVideoBodySchema |
| MCP route | app/api/mcp/v1/videos/generate/route.ts |
| Сценарні медіа | lib/media/* — компілятор prompt, рендерер thumbnail |
| Truth lens | AI-LEGIOX/legiox-truth-lens/xai-grok-imagine-video-specialist.nodus.json |
| Поле | Обов’язкове | Примітки |
|---|---|---|
prompt | Так | Рух, блоки ACTION, DIALOGUE |
qualityMode | Ні | draft (типовий), draft_i2v, production, production_i2v |
imageUrl | Для 1.5 I2V | Автоматично підвищує draft → draft_i2v |
firstFramePrompt | Ні | Викликає ImageConductor, коли imageUrl відсутній |
thumbnail | Ні | ThumbnailSpec — накладки на перший кадр |
sourceVideoUrl | Для edit remaster | url попереднього кліпу з маніфесту або CDN |
remaster | Ні | true → VideoConductor.remaster() |
remasterFromRequestId | Ні | Аудитне посилання на xAI job чернетки |
persistToFilebase | Ні | Типово true |
clipId / pipelineRequestId | Ні | Відстеження кампаній із кількома кліпами |
purpose / refCode | Ні | Шлях сховища + атрибуція referral |
actorId встановлюється на сервері через MCP guard — ніколи не довіряйте actor id, переданому клієнтом на gateway.
Застосуйте міграцію data/migrations/018_generative_media_conductor_schema.sql (ідемпотентна).
| Таблиця | Роль |
|---|---|
generated_videos | Один рядок на збережений кліп — JSONB data містить GeneratedVideoRecord |
generated_images | Статичні зображення першого кадру від ImageConductor (окремий реєстр) |
Проіндексовані шляхи JSONB: actorId, provider, purpose, refCode, clipId, pipelineRequestId, qualityMode, requestId, generationKind, remasterFromRequestId.
BackendSelector спрямовує generated_videos і generated_images до PostgreSQL. Якщо таблиці немає, upload static image все одно завершується успішно; persist записує warning, доки не буде застосовано міграцію 018.
Із env.local.template — повторно використовуйте XAI_API_KEY з ImageConductor:
Ніколи не комітьте XAI_API_KEY або RING_MCP_ACCESS_KEY. MCP routes захищені Bearer через withMcpGuard.
| Поле | Опис |
|---|---|
video.url | Постійний CDN URL (коли збережено) або тимчасовий URL xAI |
video.temporaryUrl | Оригінальне посилання xAI для завантаження (спливає) |
video.requestId | ID xAI job — аудит і ланцюжки remaster |
video.recordId | ID рядка generated_videos |
firstFrame | Ресурс ImageConductor, коли використано firstFramePrompt |
thumbnail | Рендерена мініатюра, коли thumbnail.enabled |
estimatedCostUsd | Оцінка duration × preset rate |
qualityMode / resolution | Фактичний preset після автоматичного підвищення |
Помилки модерації повертають success: false, коли xAI встановлює respect_moderation: false.
Довідник MDX-віджетів для авторингу.