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 (див. Сценарний медіапайплайн) або безпосередньо передайте 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-ремастеринг |
Автоматично: 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 маніфесту (редагування):
Повторна генерація у 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-монтажів |
| Ремастеринг-редагування з тією самою роздільною здатністю | Редагування успадковує роздільну здатність джерела (до 720p) — для справжнього масштабування до 720p використовуйте повторну генерацію |
| Тайм-аут | Збільште 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 (див. Сценарний медіапайплайн) або безпосередньо передайте 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-ремастеринг |
Автоматично: 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 маніфесту (редагування):
Повторна генерація у 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-монтажів |
| Ремастеринг-редагування з тією самою роздільною здатністю | Редагування успадковує роздільну здатність джерела (до 720p) — для справжнього масштабування до 720p використовуйте повторну генерацію |
| Тайм-аут | Збільште 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 (див. Сценарний медіапайплайн) або безпосередньо передайте 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-ремастеринг |
Автоматично: 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 маніфесту (редагування):
Повторна генерація у 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-монтажів |
| Ремастеринг-редагування з тією самою роздільною здатністю | Редагування успадковує роздільну здатність джерела (до 720p) — для справжнього масштабування до 720p використовуйте повторну генерацію |
| Тайм-аут | Збільште VIDEO_GEN_POLL_TIMEOUT_MS |
production_i2v |
grok-imagine-video-1.5 |
| 720p |
| $0.14 |
| I2V-ремастеринг |
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"}]}'
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-ремастеринг |
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"}]}'
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-ремастеринг |
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"}]}'
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