Премини към основното съдържание
Български— Изберете език
Меню

Монтаж на видео с /v1/videos/edits

Урок 7 от 12 Обновен 3 ноември 2026 г. Средно
На тази страница
  1. Монтаж на съществуващо видео
  2. Крайна точка POST /v1/videos/edits
  3. Какво да поискате при монтаж
  4. Асинхронният цикъл, идентичен с генерирането
  5. Посочете какво се променя и какво остава
  6. Ключови изводи

Обновено на 3 ноември 2026 г. Въз основа на страницата Video Editing на xAI: изходното видео е с максимална продължителност 8,7 секунди, изходният файл запазва своята продължителност, съотношение на страните и резолюция (максимум 720p), а удължаването използва същия обект video като монтажа. Предишното твърдение, че монтажът е ненадежден за конкретни елементи, противоречи на примерите на xAI, които се фокусират именно върху прецизни редакции. Източници: Video Editing · Video Overview.

Монтаж на съществуващо видео

Генерирането е само част от работата. API на xAI предоставя и крайна точка за монтаж на видео, която приема съществуваща последователност и я модифицира въз основа на текстови подкани. Това е видео еквивалентът на редактирането на изображения, но със строги ограничения за формата. Преди да напишете първата си заявка, обърнете внимание на четирите граници, които определят какво можете да подадете.

8.7 s
Максимална продължителност на източника
720p
Максимална резолюция
H.265
Приет кодек (като H.264, AV1)
MP4
Изискван формат

Крайна точка 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
  • Кажете какво трябва да се промени, след това какво трябва да остане идентично