Разширяване на видео чрез /v1/videos/extensions
На тази страница
Урокът е актуализиран на 2 ноември 2026 г. въз основа на справочната документация на xAI Video API: разширяването получава видеото в обект
video({"url": ...}), точно както при редактирането – предишният текст твърдеше обратното – резултатът се чете отvideo.url, а изходният материал е ограничен до 15 секунди. Източници: Video Extension · Video Reference.
Разширяване на съществуващо видео
Докато редактирането трансформира последователност, без да променя продължителността ѝ, разширяването прави точно обратното: то удължава видеото, като генерира продължение, съвместимо с предходното съдържание. Това решава най-честия проблем при генерирането на видео – успешен клип, който е твърде кратък, или сцена, която заслужава да се развие отвъд първоначалната си продължителност. Вместо да регенерирате всичко и да се надявате да възпроизведете същия вид, Вие започвате от съществуващото и продължавате нататък.
Точка за достъп POST /v1/videos/extensions
Заявката наподобява заявка за генериране, с добавеното начално видео.
{
"model": "grok-imagine-video",
"prompt": "Continue the scene with a zoom out revealing the full landscape",
"video": {"url": "https://exemple.com/video-courte.mp4"},
"duration": 5
}
Полето model остава grok-imagine-video, prompt описва какво трябва да се случи в продължението, обектът video определя видеото за разширяване (URL адрес или file_id на качен файл, за източник с продължителност от 2 до 15 секунди), а duration задава дължината на разширението между 2 и 10 секунди – стойността по подразбиране е 6 секунди. За разлика от редактирането, тук Вие възвръщате контрола върху продължителността. Върнатото видео съдържа оригинала, последван от разширението: източник от 10 секунди, разширен с 5 секунди, води до видео от 15 секунди.
Следващата таблица обобщава разликите между двете точки за достъп, тъй като объркването е често срещано.
| Аспект | Редактиране (/edits) | Разширяване (/extensions) |
|---|---|---|
| Цел | Промяна на съдържанието | Добавяне на продължителност |
| Параметър за видео | Обект video (url или file_id) | Обект video (url или file_id) |
| Продължителност на източника | Макс. 8,7 сек. | 2 до 15 сек. |
| Изходна продължителност | Същата като източника (Макс. 720p) | Източник + 2 до 10 сек. |
| Оригинално съдържание | Променя | Запазва |
И двете REST API точки за достъп получават видеото по един и същи начин – в обект video със свойство url. Python SDK обаче го приема като параметър video_url: не копирайте това име на параметър в JSON тялото, тъй като API няма да го разпознае. Това, което наистина отличава двете точки за достъп, е продължителността.
Три начина за продължаване на сцена
Най-простият случай се състои в оставянето на случващото се да продължи естествено. Подканата (prompt) поема текущото действие и го удължава без прекъсване.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Можете също така да въведете промяна, което означава да добавите нов елемент или да промените посоката на гледане. Това придава на последователността нейното наративно развитие.
{
"model": "grok-imagine-video",
"prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
"video": {"url": "https://exemple.com/plage.mp4"},
"duration": 8
}
Третият случай на употреба е заключението: кратко разширение, което чисто завършва последователността, често със затихване (fade).
{
"model": "grok-imagine-video",
"prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
"video": {"url": "https://exemple.com/coucher-soleil.mp4"},
"duration": 4
}
Свързване на разширения за изграждане на последователност
Нищо не пречи на разширяването на видео многократно едно след друго. Всяко разширение произвежда ново видео, чийто URL адрес може да служи като източник за следващото разширение, позволявайки Ви да изградите дълга последователност чрез последователни сегменти, всеки от които се управлява от своя собствена подкана. Скриптът по-долу свързва три разширения, като повторно инжектира получения URL адрес на всяка стъпка.
import httpx
import time
api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
def attendre_video(request_id):
"""Poll status until completion."""
while True:
resp = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers=headers
).json()
if resp["status"] == "done":
return resp["video"]["url"]
if resp["status"] == "failed":
raise RuntimeError(f"Generation failed: {resp.get('error')}")
time.sleep(5)
# Base video
video_url = "https://exemple.com/video-initiale.mp4"
# Chain 3 extensions
prompts = [
"The character crosses the bridge, profile view",
"He stops in the middle and looks at the river below",
"He resumes walking toward the other bank, the camera follows"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/extensions",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"video": {"url": video_url},
"duration": 5
}
).json()
video_url = attendre_video(resp["request_id"])
print(f"Extension complete: {video_url}")
Тази елегантност има своята цена, буквално и преносно. Всяко разширение се таксува отделно. Източникът не може да надвишава 15 секунди, което ограничава веригата: започвайки от 5 секунди, последователността достига 20 секунди след три 5-секундни разширения, а четвъртото ще бъде отхвърлено. Визуалната кохерентност се влошава през връзките, тъй като всяка стъпка разчита на вече интерпретиран изход: отвъд три или четири свързани разширения стават видими отклонения в цвета и морфологията. И както навсякъде в това API, URL адресите са временни – изтеглете всяка междинна версия, в противен случай грешка в края на веригата ще Ви принуди да започнете отначало.
Дуетът „Генериране, след това разширяване“
Най-честият шаблон в производството комбинира двете точки за достъп. Първо генерирате кратка 3-секундна база с много точна подкана, чрез POST /v1/videos/generations, което Ви позволява да迭代ирате върху началната естетика на по-ниска цена. След това добавяте 5 секунди развитие чрез POST /v1/videos/extensions, последвани от 4 секунди заключение чрез второ обаждане до същата точка за достъп. Резултатът е 12-секундно видео, изградено сегмент по сегмент, където всяка част е валидирана, преди да се ангажира следващата – контрол, който нито едно единично 12-секундно генериране не би предложило.
Ключови изводи
- Разширяването удължава видео от 2 до 15 секунди със сегмент от 2 до 10 секунди (по подразбиране 6) и връща цялото видео
- Изходното видео се поставя в обект
video(urlилиfile_id), както при редактирането; Python SDK го приема катоvideo_url - Свързването позволява създаването на дълги последователности стъпка по стъпка
- Кохерентността се влошава след 3-4 последователни разширения
- Комбинирайте първоначално генериране + разширения за прецизен контрол на съдържанието