Yhdistä muokkaus ja jatkaminen
Tällä sivulla
Päivitetty 2. marraskuuta 2026. xAI:n video-API:n viitetietojen mukaan: lähdekuva sijoitetaan
image-objektiin ja muokattava tai jatkettava videovideo-objektiin ({"url": ...}) sekä jatkamisessa että muokkaamisessa. Lähteet: Video Extension · Videos Reference.
Edistyneet tuotantoputket
Käytettynä erillisinä jokaisella päätepisteellä on rajoituksensa: generointi pysähtyy 15 sekuntiin, muokkaus 8,7 sekunnin lähteeseen ja jatkaminen 10 sekunnin lisäykseen. Yhdistettynä ne muodostavat tuotantoputkia, jotka ylittävät nämä rajat huomattavasti ja, mikä tärkeintä, antavat sinulle valvontapisteen jokaisen segmentin jälkeen. Tämä oppitunti käsittelee kolmea käytännön putkea tuotemainoksista tyylillisiin variaatioihin ja opettaa, miten teet niistä luotettavia.
Putki 1: 15 sekunnin tuotemainos
Skenaario on klassinen: sinulla on älypuhelinkuva ja sinun tulee toimittaa 15 sekunnin mainosvideo. Putki rakennetaan kolmesta 5 sekunnin segmentistä, joista jokainen validoidaan ennen seuraavaa.
Ensimmäinen segmentti animoi tuotekuvan – kierto, valonheijastusten leikki – edellisessä osiossa opiskellun kuva-videoksi -menetelmän avulla.
{
"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"
}
Toinen segmentti jatkaa tätä otosta laajennuksella, joka tuo kameran lähemmäs näyttöä, käyttäen edellisessä vaiheessa saatua URL-osoitetta uudelleen.
{
"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
}
Kolmas päättää sekvenssin laajaan kuvaan, lähtien tällä kertaa toisen segmentin tuloksesta.
{
"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
}
Viisitoista sekuntia uutta sisältöä hintaan 0,05 $ sekunnilta grok-imagine-video-mallilla: odota noin 0,75 $ ilman iteraatioita, jos jokainen segmentti laskutetaan sen keston mukaan. Kunkin vaiheen todellinen kustannus näkyy sen tuloksen usage.cost_in_usd_ticks-kentässä: varmista tämä testiputkella ennen sarjan budjetointia.
Putki 2: Viisi sisältöä, yksi tyyli
Eri tilanne, eri logiikka: sinun tulee tuottaa viisi 5 sekunnin videota sosiaalisen median kampanjaan johdonmukaisella visuaalisella tyylillä. Tässä ketjutus ei strukturoi työtä, vaan vertailukuvat tekevät sen; ne ovat identtiset kaikille generoinneille. Viisi kehottetta kuvaavat eri kohtauksia; tyyli pysyy yhtenäisenä samojen kahden visuaalin ansiosta.
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"
}
)
Viisi 5 sekunnin klippiä maksaa yhteensä 1,25 $. Huomaa kaikissa pyynnöissä käytetty 9:16-muoto: pystysuuntaisessa kampanjassa tämäntyyppinen huolimattomuus maksaa koko generoinnin uusimisen.
Putki 3: Variaatioiden johtaminen videosta
Kolmas malli ei ketjuta mitään: se soveltaa useita eri muokkauksia rinnakkain samaan lähdevideoon. Näin saat neljä versiota samasta klipistä, joko A/B-testausta varten tai jaettavaksi alustoille, joilla on erilaiset identiteetit.
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}
}
)
Nämä kolme putkea käyttävät neljää päätepistettä, jotka on yhteenvetona alla.
| Endpoint | Method | Input | Output | Max duration |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + options | New video | 1-15s |
/v1/videos/edits | POST | Video + prompt | Modified video | Source up to 8.7s |
/v1/videos/extensions | POST | Video + prompt | Extended video | +2 to 10s, source up to 15s |
/v1/videos/{id} | GET | request_id | Status + URL | - |
Ketjun tekeminen vikasietoiseksi
Heti kun ketjutat operaatioita, todennäköisyys sille, että ainakin yksi epäonnistuu, kasvaa merkittävästi, ja kolmannen lenkin epäonnistuminen menettää kaksi ensimmäistä, jos mitään ei ole suunniteltu etukäteen. Seuraava funktio kapseloi jokaisen vaiheen uudelleenyrityssilmukkaan ja etenee seuraavaan vaiheeseen vasta, kun URL on saatu.
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
Tämän rungon ympärillä viisi tapaa tekee eron prototyypin ja palvelun välillä. Lataa tulos jokaisessa vaiheessa, sillä URL-osoitteet ovat väliaikaisia ja häiriöstä palautuminen vaatii väliversioiden olemassaoloa. Validoi jokainen segmentti visuaalisesti ennen jatkamista, muuten maksat kolmesta generoinnista vain huomataksesi, että ensimmäinen ei kelvannut. Käsittele virrat yrittämällä uudelleen eksponentiaalisesti kasvavin viivein. Laske koko budjetti ennen pitkän ketjun käynnistämistä, laskien mukaan todennäköiset iteraatiot. Ja rinnakkaista mitä voit: putkissa 2 ja 3 mikään generointi ei riipu toisesta, joten ne voidaan suorittaa samanaikaisesti.
Hinnoittelu tarkistettu 3. marraskuuta 2026 – hinnat muuttuvat säännöllisesti: ennen kuin lasket budjettia, tarkista nykyiset hinnat xAI:n viralliselta mallien ja hinnoittelun sivulta.
Keskeiset asiat
- Kolme päätepistettä (generointi, muokkaus, jatkaminen) yhdistyvät putkiksi
- Vertailukuvat varmistavat tyylillisen yhtenäisyyden useiden videoiden välillä
- Iteratiivinen muokkaus mahdollistaa videon johtamisen useiksi versioiksi
- Lataa välitulokset ja käsittele virheet jokaisessa vaiheessa
- Laske kokonaisbudjetti ennen monimutkaisten putkien käynnistämistä