Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Yhdistä muokkaus ja jatkaminen

Oppitunti 9 / 12 Päivitetty 3. marraskuuta 2026 Keskitasoinen
Tällä sivulla
  1. Edistyneet tuotantoputket
  2. Putki 1: 15 sekunnin tuotemainos
  3. Putki 2: Viisi sisältöä, yksi tyyli
  4. Putki 3: Variaatioiden johtaminen videosta
  5. Ketjun tekeminen vikasietoiseksi
  6. Keskeiset asiat

Päivitetty 2. marraskuuta 2026. xAI:n video-API:n viitetietojen mukaan: lähdekuva sijoitetaan image-objektiin ja muokattava tai jatkettava video video-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.

EndpointMethodInputOutputMax duration
/v1/videos/generationsPOSTPrompt + optionsNew video1-15s
/v1/videos/editsPOSTVideo + promptModified videoSource up to 8.7s
/v1/videos/extensionsPOSTVideo + promptExtended video+2 to 10s, source up to 15s
/v1/videos/{id}GETrequest_idStatus + 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ä