Комбиниране на редактиране и удължаване
На тази страница
Обновено на 2 ноември 2026 г. Въз основа на справочната документация за видео API на xAI: изходното изображение се поставя в обект
image, а видеоклипът за редактиране или удължаване – в обектvideo({"url": ...}), както за удължаване, така и за редактиране. Източници: Video Extension · Videos Reference.
Усъвършенствани производствени конвейери
Използвани поотделно, всеки край има свои ограничения: генерирането е ограничено до 15 секунди, редактирането – до 8,7 секунди изходен материал, а удължаването – до добавени 10 секунди. Комбинирани обаче, те формират производствени конвейери, които значително надхвърлят тези граници и, което е още по-важно, Ви осигуряват контролна точка след всеки сегмент. Този урок разглежда три реални конвейера – от продуктови клипове до стилистични вариации – и как да ги направите надеждни.
Конвейер 1: 15-секундна продуктова промоция
Сценарият е класически: разполагате със снимка на смартфон и трябва да доставите 15-секунден промоционален видеоклип. Конвейерът се изгражда в три сегмента по 5 секунди, като всеки се валидира преди преминаване към следващия.
Първият сегмент анимира продуктовата снимка – въртене, игра на отраженията – чрез функцията изображение-към-видео, разгледана в предишния раздел.
{
"model": "grok-imagine-video",
"prompt": "Elegant rotation of the smartphone on a dark background, light reflections on the screen",
"image": {"url": "https://exemple.com/smartphone.jpg"},
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Вторият разширява този кадър с удължаване, което приближава камерата към екрана, като повторно използва URL адреса, получен в предишната стъпка.
{
"model": "grok-imagine-video",
"prompt": "Progressive zoom towards the smartphone screen turning on, displaying a colorful interface",
"video": {"url": "{url_video_etape_1}"},
"duration": 5
}
Третият завършва последователността с широк кадър, като този път започва от изхода на втория сегмент.
{
"model": "grok-imagine-video",
"prompt": "Zoom out revealing the smartphone placed on a design desk, soft light, slight background blur",
"video": {"url": "{url_video_etape_2}"},
"duration": 5
}
Петнадесет секунди ново съдържание, на цена от $0.05 за секунда с grok-imagine-video: очаквайте около $0.75, без да броите итерациите, ако всеки сегмент се таксува според продължителността си. Реалната цена на всяка стъпка се появява в полето usage.cost_in_usd_ticks на нейния резултат: проверете това в тестов конвейер, преди да планирате бюджет за серия.
Конвейер 2: Пет съдържания, един стил
Различна ситуация, различна логика: трябва да произведете пет 5-секундни видеоклипа за социална кампания с последователен визуален стил. Тук верижното свързване не структурира работата; това правят референтните изображения, еднакви за всички генерирания. Петте подкана описват различни сцени; стилът остава консистентен благодарение на едни и същи две визуализации.
references = [
{"url": "https://exemple.com/style-campagne-1.jpg"},
{"url": "https://exemple.com/style-campagne-2.jpg"}
]
prompts = [
"Coffee pouring into a white ceramic cup, rising steam",
"Hands typing on a keyboard, blurred screen in background",
"An open notebook with a pen writing, natural light",
"A green plant growing in timelapse in a clay pot",
"A book whose pages turn in the wind on a terrace"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/generations",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"reference_images": references,
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p"
}
)
Пет клипа по 5 секунди възлизат на $1.25. Обърнете внимание на формата 9:16, приложен към всички заявки: за вертикална кампания това е видът пропуск, който струва пълно регенериране.
Конвейер 3: Извеждане на варианти от видеоклип
Третата схема не верижно свързва нищо: тя прилага няколко различни редакции паралелно към един и същ изходен видеоклип. Така получавате четири версии на един и същ клип, които да предложите за A/B тестване или да разпространите в платформи с различни идентичности.
video_source = "https://exemple.com/video-base.mp4"
variations = [
"Cinematic black and white style, film grain",
"Pop art saturated colors, strong contrasts",
"Night ambiance, purple and blue neon lights",
"Watercolor style, soft outlines and washed colors"
]
for variation in variations:
resp = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": variation,
"video": {"url": video_source}
}
)
Тези три конвейера използват четири крайни точки, обобщени по-долу.
| Крайна точка | Метод | Вход | Изход | Макс. продължителност |
|---|---|---|---|---|
/v1/videos/generations | POST | Подкана + опции | Ново видео | 1-15 сек. |
/v1/videos/edits | POST | Видео + подкана | Модифицирано видео | Източник до 8,7 сек. |
/v1/videos/extensions | POST | Видео + подкана | Удължено видео | +2 до 10 сек., източник до 15 сек. |
/v1/videos/{id} | GET | request_id | Статус + URL | - |
Правене на веригата устойчива на грешки
Щом започнете да верижно свързвате операции, вероятността поне една да се провали става значителна, а провал на третата връзка губи първите две, ако нищо не е планирано. Следната функция обгръща всяка стъпка в цикъл за повторен опит и преминава към следващата стъпка едва след получаване на URL адреса.
async def pipeline_with_retry(steps, max_retries=2):
video_url = None
for i, step in enumerate(steps):
for attempt in range(max_retries + 1):
try:
if step["type"] == "generation":
result = await generate_video(step["params"])
elif step["type"] == "extension":
step["params"]["video"] = {"url": video_url}
result = await extend_video(step["params"])
elif step["type"] == "edition":
step["params"]["video"] = {"url": video_url}
result = await edit_video(step["params"])
video_url = await wait_for_result(result["request_id"])
break
except Exception as e:
if attempt == max_retries:
raise Exception(f"Step {i+1} failed: {e}")
await asyncio.sleep(10)
return video_url
Около този скелет пет навика правят разликата между прототип и услуга. Изтегляйте резултата на всяка стъпка, тъй като URL адресите са временни и възстановяването от инцидент изисква наличие на междинни версии. Визуално валидирайте всеки сегмент, преди да преминете към следващия, в противен случай плащате за три генерирания, само за да откриете, че първото не е подходящо. Обработвайте грешките с опити, разделени чрез експоненциално забавяне. Изчислете пълния бюджет преди стартиране на дълга верига, бройки вероятните итерации. И паралелизирайте каквото можете: в конвейер 2 и конвейер 3 нито едно генериране не зависи от друго, така че те могат да се изпълняват едновременно.
Ценообразуването е проверено на 3 ноември 2026 г. – цените се променят редовно: преди всяко изчисление на бюджет проверете текущите тарифи на официалната страница за модели и цени на xAI.
Ключови изводи
- Трите крайни точки (генериране, редактиране, удължаване) се комбинират в конвейери
- Референтните изображения осигуряват стилистична консистентност в множество видеоклипове
- Итеративното редактиране позволява извеждането на видеоклип в няколко версии
- Изтегляйте междинните резултати и обработвайте грешките на всяка стъпка
- Изчислете общия бюджет преди стартиране на сложни конвейери