Derink redagavimą ir pratęsimą
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. Remiantis xAI vaizdo įrašų API dokumentacija: šaltinio paveikslėlis dedamas į
imageobjektą, o redaguojamas arba pratęsiamas vaizdo įrašas – įvideoobjektą ({"url": ...}), tiek pratęsimo, tiek redagavimo atveju. Šaltiniai: Vaizdo įrašo pratęsimas · Vaizdo įrašų nuorodos.
Pažangios gamybos grandinės
Naudojami atskirai, kiekvienas galinis taškas turi ribų: generavimas apsiriboja 15 sekundžių, redagavimas – 8,7 sekundės šaltinio medžiagos, o pratęsimas – iki 10 papildomų sekundžių. Sujungus juos, gaunamos gamybos grandinės, kurios gerokai viršija šias ribas ir, svarbiausia, suteikia kontrolės tašką po kiekvieno segmento. Šioje pamokoje nagrinėjamos trys realios grandinės – nuo produkto klipų iki stilistinių variacijų – ir kaip užtikrinti jų patikimumą.
1 grandinė: 15 sekundžių produkto reklama
Scenarijus klasikinis: turi išmaniojo telefono nuotrauką ir turi pristatyti 15 sekundžių reklaminį vaizdo įrašą. Grandinė sudaroma iš trijų 5 sekundžių segmentų, kurių kiekvienas patikrinamas prieš pereinant prie kito.
Pirmasis segmentas animuoja produkto nuotrauką – sukimas, šviesos atspindžių žaismas – naudojant ankstesniame skyriuje nagrinėtą paveikslėlio į vaizdo įrašą konversiją.
{
"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"
}
Antrasis segmentas pratęsia šią sceną priartinant kamerą prie ekrano, pakartotinai naudojant ankstesniame žingsnyje gautą 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
}
Trečiasis segmentas užbaigia sekenciją bendru planu, šį kartą pradedant nuo antrojo segmento išvesties.
{
"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
}
Penkiolika sekundžių naujo turinio, kainuojančio 0,05 USD už sekundę naudojant grok-imagine-video: tikėkis apie 0,75 USD, neskaičiuojant kartojimų, jei kiekvienas segmentas apmokestinamas pagal jo trukmę. Tikroji kiekvieno žingsnio kaina rodoma jo rezultato lauke usage.cost_in_usd_ticks: prieš planuodamas seriją, patikrink tai bandomojoje grandinėje.
2 grandinė: Penki turiniai, vienas stilius
Kita situacija, kita logika: reikia sukurti penkis 5 sekundžių vaizdo įrašus socialinei kampanijai, išlaikant nuoseklų vizualinį stilių. Čia darbą struktūrizuoja ne grandininis jungimas, o etaloniniai paveikslėliai, identiški visiems generavimams. Penki užklausos tekstai aprašo skirtingas scenas; stilius išlieka nuoseklus dėka tų pačių dviejų vizualų.
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"
}
)
Penki 5 sekundžių klipai kainuoja 1,25 USD. Atkreipk dėmesį į visiems užklausoms taikomą 9:16 formatą: vertikalios kampanijos atveju tokia klaida gali kainuoti visą regeneravimą.
3 grandinė: Variacijų kūrimas iš vieno vaizdo įrašo
Trečioji schema nieko nejungia grandine: ji lygiagrečiai taiko kelis skirtingus redagavimus tam pačiam šaltinio vaizdo įrašui. Taip gauni keturias to paties klipo versijas, kurias gali naudoti A/B testavimui arba platinti platformose su skirtinga tapatybe.
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}
}
)
Šiose trijose grandinėse naudojami keturi galiniai taškai, apibendrinti žemiau.
| Galinis taškas | Metodas | Įvestis | Išvestis | Maks. trukmė |
|---|---|---|---|---|
/v1/videos/generations | POST | Užklausa + parametrai | Naujas vaizdo įrašas | 1–15 s |
/v1/videos/edits | POST | Vaizdo įrašas + užklausa | Modifikuotas vaizdo įrašas | Šaltinis iki 8,7 s |
/v1/videos/extensions | POST | Vaizdo įrašas + užklausa | Pratęstas vaizdo įrašas | +2 iki 10 s, šaltinis iki 15 s |
/v1/videos/{id} | GET | request_id | Būsena + URL | - |
Kaip padaryti grandinę atsparią gedimams
Kai tik pradedi jungti operacijas grandine, tikimybė, kad bent viena žlugs, tampa reikšminga, o gedimas trečiame grandies grandyje gali sunaikinti pirmųjų dviejų rezultatus, jei nieko nenumatyta. Toliau pateikta funkcija kiekvieną žingsnį apgaubia kartojimo ciklu ir pereina prie kito žingsnio tik gavus 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
Aplink šį karkasą penki įpročiai lemia skirtumą tarp prototipo ir veikiančios paslaugos. Atsisiųsk rezultatą kiekviename žingsnyje, nes URL yra laikini, o norint atsigauti po incidento, reikia turėti tarpines versijas. Vizualiai patikrink kiekvieną segmentą prieš pereidamas prie kito, kitaip sumokėsi už tris generavimus tik norėdamas sužinoti, kad pirmasis netiko. Klaidas tvarkyk naudodamas bandymus su eksponentiniu delsos didinimu. Prieš paleisdamas ilgą grandinę, apskaičiuok visą biudžetą, įskaitant tikėtinus kartojimus. Ir lygiagretink tai, ką gali: 2 ir 3 grandinėse joks generavimas nepriklauso nuo kito, todėl jie gali vykti vienu metu.
Kainodara patikrinta 2026 m. lapkričio 3 d. – kainos keičiasi reguliariai: prieš atlikdamas bet kokius biudžeto skaičiavimus, patikrink dabartinius tarifus oficialiame xAI modelių ir kainodaros puslapyje.
Svarbiausi punktai
- Trys galiniai taškai (generavimas, redagavimas, pratęsimas) sujungiami į grandines
- Etaloniniai paveikslėliai užtikrina stilistinį nuoseklumą keliuose vaizdo įrašuose
- Iteracinis redagavimas leidžia iš vieno vaizdo įrašo sukurti kelias versijas
- Atsisiųsk tarpinius rezultatus ir tvarkyk klaidas kiekviename žingsnyje
- Prieš paleisdamas sudėtingas grandines, apskaičiuok bendrą biudžetą