L-immuntar tal-vidjow b'/v1/videos/edits
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026. Ibbażat fuq il-paġna Video Editing ta’ xAI: il-vidjow sors huwa twil 8.7 sekondi l-aktar, l-output iżomm id-durata, il-proporzjon tal-aspett, u r-riżoluzzjoni tiegħu (720p massimu), u l-estensjoni tuża l-istess oġġett
videobħall-immuntar. L-affermazzjoni preċedenti li l-immuntar kien inaffidabbli għal elementi speċifiċi tikkontradixxi l-eżempji ta’ xAI, li jiffukaw preċiżament fuq modifiki preċiżi. Sorsi: Video Editing · Video Overview.
Immunta vidjow eżistenti
Il-ġenerazzjoni hija biss parti mix-xogħol. L-API ta’ xAI tesponi wkoll endpoint ta’ immuntar tal-vidjow li jieħu sekwenza eżistenti u jimmodifikaha abbażi ta’ prompts tat-test. Huwa l-ekwivalenti tal-vidjow tal-immuntar tal-immaġnijiet, b’restrizzjonijiet aktar stretti tal-format. Qabel ma tikteb l-ewwel talba tiegħek, innota l-erba’ limiti li jiddeterminaw x’tista’ tissottometti.
L-endpoint POST /v1/videos/edits
It-talba tgħaqqad vidjow sors ma’ prompt li jiddeskrivi l-modifika mixtieqa.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Tliet oqsma biżżejjed: model, li jibqa’ grok-imagine-video; prompt, li fih id-deskrizzjoni tal-modifika; u video.url, li jipponta lejn il-fajl MP4 li għandu jiġi pproċessat. Innota li l-vidjow huwa inkapsulat f’oġġett video, li jaċċetta url jew il-file_id ta’ fajl imtella’: l-endpoint tal-estensjoni, fil-lezzjoni li jmiss, jadotta l-istess konvenzjoni.
Ir-restrizzjonijiet tekniċi huma aktar stretti hawnhekk milli fil-ġenerazzjoni. Is-sors m’għandux jaqbeż it-8.7 sekondi, u l-vidjow prodott iżomm id-durata tiegħu; il-paġna Video Generation isemmi durata “limitata għal 8.7 sekondi” mingħajr ma tiddettalja t-trattament ta’ sors itwal: allura aqta’ s-sorsi tiegħek minn qabel. Ir-riżoluzzjoni hija limitata għal 720p. Il-fajl tal-input irid ikun MP4 f’codec appoġġjat, bħal H.264, H.265, jew AV1. L-aktar punt konfuż għal dawk li ġejjin mill-ġenerazzjoni: m’għandek l-ebda kontroll fuq id-durata, il-proporzjon tal-aspett, jew ir-riżoluzzjoni tal-output, kollha ddeterminati mill-vidjow sors. It-talba tal-immuntar ma tinkludix kamp duration, aspect_ratio, jew resolution.
X’titlob f’immuntar
Is-sostituzzjoni tal-isfond hija l-każ klassiku: is-suġġett jibqa’, l-ambjent jinbidel.
{
"model": "grok-imagine-video",
"prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Il-bidliet fl-istil jaffettwaw l-immaġni kollha u jibdlu l-istil tal-klipp mingħajr ma jimmodifikaw l-azzjoni tiegħu—prattiku biex tadatta l-istess sekwenza f’universi differenti.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Iż-żieda ta’ elementi tarricca x-xena b’saffi li ma kinux jeżistu waqt l-ippruvjar, ġeneralment atmosferiċi.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Fl-aħħar nett, il-modifika tad-dawl tammonta għar-reggrading tas-sekwenza: l-istess shots, ambjent radikalment differenti.
{
"model": "grok-imagine-video",
"prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
"video": {"url": "https://example.com/video.mp4"}
}
Iċ-ċiklu asinkronu, identiku għall-ġenerazzjoni
L-immuntar isegwi eżattament l-istess protokoll ta’ erba’ passi bħall-ġenerazzjoni: tibgħat it-talba, tirċievi request_id, tistaqsi GET /v1/videos/{request_id} f’intervalli regolari, u tirrikupra l-vidjow immuntat meta l-istatus jinbidel għal done. F’Python, l-ewwel żewġ passi joqogħdu f’ftit linji.
import httpx
# 1. Submit the edit
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Add a rain effect over the entire scene",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Poll the status (simplified)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Iddikjara x’jinbidel, u x’jibqa’
xAI tiddeskrivi l-imġiba tal-mudell f’sentenza waħda: grok-imagine-video japplika l-bidla mitluba u jżomm kollox ieħor kemm jista’ jkun qrib is-sors. Id-dokumentazzjoni tagħha tiddeduċi linja gwida minn dan: għid ukoll x’għandu jibqa’ identiku. L-eżempji tagħha stess jiffukaw ukoll fuq modifiki preċiżi ta’ klipp wieħed—li żżid ġiżirana tal-fidda, tbiddel ilbies għal aħmar, tpoġġi kappell iswed b’tarf wiesa’ fuq karattru—imħaddma parallel fuq l-istess sors.
{
"model": "grok-imagine-video",
"prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Il-gwida tal-prompt tal-immaġni ta’ xAI, miktuba għal immaġnijiet statiċi, tispeċifika l-ordni li taħdem: il-modifika l-ewwel, imbagħad sentenza li tissakkar dak li jibqa’ statiku. Immuntar li jibda b‘“żomm kollox” ibiddel kważi xejn, u immuntar li jikkopja prompt sħiħ tal-ġenerazzjoni jerġa’ joħloq ix-xena.
Erba’ drawwiet jevitaw il-biċċa l-kbira tal-iżbalji: żomm is-sorsi tiegħek taħt it-8.7 sekondi, f’codec appoġġjat (H.264, H.265, jew AV1); semma x’għandu jibqa’ intatt; ittestja modifika fuq klipp qasir qabel ma tikbirha; u ftakar li l-immuntar juża grok-imagine-video, li l-grilja tal-prezzijiet tiegħu turi rata waħda, $0.050 kull sekonda—dawra ta’ provi tiswi l-istess bħall-ġenerazzjoni.
Punti Ewlenin
- L-endpoint
POST /v1/videos/editsjimmodifika vidjow eżistenti abbażi ta’ prompt, b’grok-imagine-videobiss - Is-sors idum 8.7 sekondi l-aktar; l-output iżomm id-durata, il-proporzjon, u r-riżoluzzjoni tiegħu (720p massimu)
- Il-vidjow sors irid ikun MP4 f’codec appoġġjat (H.264, H.265, AV1)
- It-talba m’għandha l-ebda kamp
duration,aspect_ratio, jewresolution - Għid x’għandu jinbidel, imbagħad x’għandu jibqa’ identiku