Монтаж на видео с /v1/videos/edits
На тази страница
Обновено на 3 ноември 2026 г. Въз основа на страницата Video Editing на xAI: изходното видео е с максимална продължителност 8,7 секунди, изходният файл запазва своята продължителност, съотношение на страните и резолюция (максимум 720p), а удължаването използва същия обект
videoкато монтажа. Предишното твърдение, че монтажът е ненадежден за конкретни елементи, противоречи на примерите на xAI, които се фокусират именно върху прецизни редакции. Източници: Video Editing · Video Overview.
Монтаж на съществуващо видео
Генерирането е само част от работата. API на xAI предоставя и крайна точка за монтаж на видео, която приема съществуваща последователност и я модифицира въз основа на текстови подкани. Това е видео еквивалентът на редактирането на изображения, но със строги ограничения за формата. Преди да напишете първата си заявка, обърнете внимание на четирите граници, които определят какво можете да подадете.
Крайна точка POST /v1/videos/edits
Заявката съчетава изходно видео с подкана, описваща желаната модификация.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Три полета са достатъчни: model, което остава grok-imagine-video; prompt, което съдържа описанието на модификацията; и video.url, което сочи към MP4 файла за обработка. Забележете, че видеото е обвито в обект video, който приема url или file_id на качен файл: крайната точка за удължаване, в следващия урок, възприема същото правило.
Техническите ограничения тук са по-строги, отколкото при генерирането. Източникът не трябва да надвишава 8,7 секунди, а полученото видео запазва своята продължителност; страницата Video Generation споменава продължителност, „ограничена до 8,7 секунди“, без да детайлизира обработката на по-дълъг източник: затова изрежете източниците си предварително. Резолюцията е ограничена до 720p. Входният файл трябва да бъде MP4 в поддържан кодек, като H.264, H.265 или AV1. Най-объркващият момент за идващите от генерирането е, че нямате контрол върху продължителността, съотношението на страните или резолюцията на изхода; всички те се определят от изходното видео. Заявката за монтаж не включва поле duration, aspect_ratio или resolution.
Какво да поискате при монтаж
Замяната на фона е класическият случай: обектът остава, обстановката се променя.
{
"model": "grok-imagine-video",
"prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Промените в стила засягат цялото изображение и трансформират стила на клипа, без да променят действието му – практично за адаптиране на една и съща последователност към различни вселени.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Добавянето на елементи обогатява сцената със слоеве, които не са съществували по време на заснемането, обикновено атмосферни.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Накрая, модификацията на осветлението представлява преоцветяване на последователността: същите кадри, радикално различна атмосфера.
{
"model": "grok-imagine-video",
"prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
"video": {"url": "https://example.com/video.mp4"}
}
Асинхронният цикъл, идентичен с генерирането
Монтажът следва точно същия четиристъпков протокол като генерирането: изпращате заявката, получавате request_id, правите периодични заявки към GET /v1/videos/{request_id} и извличате монтираното видео, когато статусът се промени на done. В Python първите две стъпки се събират в няколко реда.
import httpx
# 1. Submit the edit
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Add a rain effect over the entire scene",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Poll the status (simplified)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Посочете какво се променя и какво остава
xAI описва поведението на модела в едно изречение: grok-imagine-video прилага поисканата промяна и запазва всичко останало възможно най-близо до източника. Документацията им извежда от това насока: кажете също какво трябва да остане идентично. Собствените им примери също се фокусират върху прецизни редакции на един клип – добавяне на сребърна огърлица, промяна на облеклото в червено, поставяне на черна шапка с широки периферии на герой – изпълнявани паралелно на един и същ източник.
{
"model": "grok-imagine-video",
"prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Ръководството за подкани за изображения на xAI, написано за статични изображения, уточнява реда, който работи: първо модификацията, след това изречение, което заключва какво остава статично. Монтаж, започващ с „запази всичко“, почти нищо не променя, а монтаж, копиращ пълна подкана за генериране, преизмисля сцената.
Четири навика избягват повечето капани: поддържайте източниците си под 8,7 секунди в поддържан кодек (H.264, H.265 или AV1); назовете какво трябва да остане непокътнато; тествайте модификация на кратък клип, преди да я мащабирате; и помнете, че монтажът използва grok-imagine-video, чиято ценова листа показва единна тарифа от 0,050 щатски долара за секунда – кръг от тестове струва същото като генерирането.
Ключови изводи
- Крайната точка
POST /v1/videos/editsмодифицира съществуващо видео въз основа на подкана, само сgrok-imagine-video - Източникът трае най-много 8,7 секунди; изходът запазва своята продължителност, съотношение и резолюция (максимум 720p)
- Изходното видео трябва да бъде MP4 в поддържан кодек (H.264, H.265, AV1)
- Заявката няма поле
duration,aspect_ratioилиresolution - Кажете какво трябва да се промени, след това какво трябва да остане идентично