Leathnú físeáin le /v1/videos/extensions
Ar an leathanach seo
An ceacht nuashonraithe an 2 Samhain, 2026 bunaithe ar thagairt API Físe xAI: faigheann an leathnú an físeán in oibiacht
video({"url": ...}), díreach mar a dhéanann eagarthóireacht—mhaígh an téacs roimhe seo a mhalairt—léitear an toradh óvideo.url, agus tá an fhoinse teoranta do 15 soicind. Foinsí: Leathnú Físeáin · Tagairt Físeáin.
Físeán atá ann cheana a leathnú
Cé go ndéanann eagarthóireacht claochlú ar sheicheamh gan a fhad a athrú, déanann leathnú an rud contrártha go díreach: méadaíonn sé físeán trí leanúnachas a ghiniúint atá comhsheasmhach leis an méid a tháinig roimhe. Réitíonn sé seo an fhadhb is coitianta i nginiúint físeáin—clip rathúil atá ró-ghearr, nó radharc a thuilleann forbairt thar a fhad tosaigh. In ionad gach rud a athghiniúint agus súil a bheith agat an cuma chéanna a chruthú arís, tosaíonn tú leis an méid atá ann agus leanann tú ar aghaidh.
An pointe deiridh POST /v1/videos/extensions
Tá an t-iarratas cosúil le hiarratas giniúna, ach leis an bhfíseán tosaigh curtha leis.
{
"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
}
Fanann an réimse model mar grok-imagine-video, déanann prompt cur síos ar an méid ba chóir tarlú sa leanúnachas, sonraíonn an oibiacht video an físeán le leathnú (url nó file_id comhaid uaslódáilte, d’fhoinse idir 2 agus 15 soicind), agus socraíonn duration fad an leathnaithe idir 2 agus 10 soicind—is é 6 soicind an réamhshocrú. Murab ionann agus eagarthóireacht, faigheann tú smacht ar an bhfad anseo arís. Áirítear an bunfhíseán san fhíseán a fhilltear, agus ansin an leathnú: cruthaíonn foinse 10 soicind arna leathnú faoi 5 soicind físeán 15 soicind.
Déanann an tábla seo a leanas achoimre ar an méid a scarann an dá phointe deiridh, ós rud é go bhfuil mearbhall coitianta.
| Gné | Eagarthóireacht (/edits) | Leathnú (/extensions) |
|---|---|---|
| Cuspóir | Ábhar a mhodhnú | Fad a chur leis |
| Paraiméadar físeáin | Oibiacht video (url nó file_id) | Oibiacht video (url nó file_id) |
| Fad foinse | Max 8.7 s | 2 go 15 s |
| Fad aschuir | Mar an gcéanna leis an bhfoinse (Max 720p) | Foinse + 2 go 10 s |
| Ábhar bunaidh | Modhnaíonn | Caomhnaíonn |
Faigheann an dá phointe deiridh REST API an físeán ar an mbealach céanna, in oibiacht video le hairí url. Glacann an Python SDK leis mar an bparaiméadar video_url, áfach: ná cóipeáil an t-ainm paraiméadair seo isteach i gcorp JSON, ní aithneoidh an API é. Is é an fad an rud a idirdhealaíonn an dá phointe deiridh i ndáiríre.
Trí bhealach chun radharc a leanúint
Is é an cás is simplí ná ligean don méid atá ar siúl cheana leanúint ar aghaidh. Tógann an prompt an gníomh reatha agus leathnaíonn sé é gan briseadh.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Is féidir leat athrú a thabhairt isteach freisin, rud a chiallaíonn eilimint nua a thabhairt isteach nó treo an amhairc a mhodhnú. Tugann sé seo dul chun cinn scéalaíochta do sheicheamh.
{
"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
}
An tríú cás úsáide, an conclúid: leathnú gairid a dhúnann an seicheamh go glan, go minic le céimniú amach (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
}
Leathnuithe a shlabhrú chun seicheamh a thógáil
Níl aon rud a choscann ort físeán a leathnú uaireanta i ndiaidh a chéile. Cruthaíonn gach leathnú físeán nua ar féidir a URL a úsáid mar fhoinse don chéad leathnú eile, rud a ligeann duit seicheamh fada a thógáil trí dheighleoga successive, gach ceann tiomáinte ag a phrompt féin. Slabhraíonn an script seo a leanas trí leathnú trí ath-instealladh an URL a fuarthas ag gach céim.
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}")
Tá praghas ar an ngalántacht seo, go litriúil agus go figiúrtha. Gearrtar táille ar gach leathnú ar leithligh. Ní féidir leis an bhfoinse bheith níos faide ná 15 soicind, rud a theorannaíonn an slabhra: ag tosú ó 5 soicind, sroicheann an seicheamh 20 soicind tar éis trí leathnú 5-soicind, agus diúltófar an ceathrú ceann. Laghdaíonn comhleanúnachas amhairc thar na naisc, ós rud é go mbraitheann gach céim ar aschur a léirmhíníodh cheana: thar trí nó ceathair leathnú slabhraithe, bíonn claonadh datha agus mhoirfeolaíochta le feiceáil. Agus mar atá i ngach áit san API seo, tá URLanna sealadach—íoslódáil gach leagan idirmheánach, murach sin, cuideoidh teip ag deireadh an tslabhra ort tosú arís ón tús.
An dís giniúint agus ansin leathnú
Is é an patrún is coitianta i dtáirgeadh ná an dá phointe deiridh a chomhcheangal. Ar dtús, gineann tú bonn gairid 3 shoicind le prompt an-chruinn, trí POST /v1/videos/generations, rud a ligeann duit iteráil ar an aeistéitic tosaigh ar chostas níos ísle. Ansin, cuireann tú 5 soicind forbartha leis trí POST /v1/videos/extensions, agus ansin 4 soicind conclúide trí ghlaonna eile ar an bpointe deiridh céanna. Is é an toradh ná físeán 12 soicind arna thógáil deighleog ar dheighleog, áit ar bailíodh gach cuid sular gníomhachtaíodh an chéad cheann eile—smacht nach dtairgfí le giniúint aonair 12 soicind.
Príomhphointí
- Leathnaíonn an leathnú físeán 2 go 15 soicind le deighleog 2 go 10 soicind (réamhshocrú 6), agus filleann sé an físeán iomlán
- Cuirtear an físeán foinse in oibiacht
video(urlnófile_id), cosúil le heagarthóireacht; glacann an Python SDK leis marvideo_url - Ligeann slabhrú seichimh fhada a chruthú céim ar chéim
- Laghdaíonn an chomhleanúnachas tar éis 3-4 leathnú successive
- Comhcheangail giniúint tosaigh + leathnuithe le haghaidh smacht cruinn ar an ábhar