Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-immuntar tal-vidjow b'/v1/videos/edits

Lezzjoni 7 / 12 Aġġornat 3 ta’ Novembru 2026 Livell Medju
F'din il-paġna
  1. Immunta vidjow eżistenti
  2. L-endpoint POST /v1/videos/edits
  3. X’titlob f’immuntar
  4. Iċ-ċiklu asinkronu, identiku għall-ġenerazzjoni
  5. Iddikjara x’jinbidel, u x’jibqa’
  6. Punti Ewlenin

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 video bħ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.

8.7 s
Durata massima tas-sors
720p
Riżoluzzjoni massima
H.265
Codec aċċettat (bħal H.264, AV1)
MP4
Format meħtieġ

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/edits jimmodifika vidjow eżistenti abbażi ta’ prompt, b’grok-imagine-video biss
  • 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, jew resolution
  • Għid x’għandu jinbidel, imbagħad x’għandu jibqa’ identiku