Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Eagarthóireacht físeáin le /v1/videos/edits

Ceacht 7 as 12 Nuashonraithe 3 Samhain 2026 Meánleibhéal
Ar an leathanach seo
  1. Físeán atá ann cheana a chur in eagar
  2. An pointe deiridh POST /v1/videos/edits
  3. Cad a iarrfar in eagarthóireacht
  4. An timthriall neamhshioncronach, mar an gcéanna leis an nginiúint
  5. Sonraigh cad a athraíonn, agus cad a fhanann
  6. Príomhphointí

Nuashonraithe an 3 Samhain, 2026. Bunaithe ar leathanach Video Editing de chuid xAI: níl an fhíseán foinseach níos faide ná 8.7 soicind, coinníonn an t-aschur a fhad, a chóimheas gnéithe, agus a taifeach (720p ar a mhéad), agus úsáideann an síneadh an réad video céanna leis an eagarthóireacht. Contrárdaíonn an maíomh roimhe seo go raibh eagarthóireacht neamhiontaofa d’eilimintí sonracha samplaí xAI, a dhíríonn go beacht ar eagarthóireacht chruinn. Foinse: Video Editing · Video Overview.

Físeán atá ann cheana a chur in eagar

Ní hé an ghiniúint ach cuid den obair. Nochtann API xAI pointe deiridh eagarthóireachta físeáin freisin a ghlacann seicheamh atá ann cheana agus a mhodhnaíonn é bunaithe ar leideanna téacs. Is é an leagan físeáin d’eagarthóireacht íomhá é, le srianta formáide níos doichte. Sula scríobhann tú do chéad iarratas, tabhair faoi deara na ceithre teorainn a chinneann cad is féidir leat a chur isteach.

8.7 s
Uasmhéid faid foinse
720p
Uastaifeach
H.265
Cóideac glactha (mar shampla H.264, AV1)
MP4
Formáid riachtanach

An pointe deiridh POST /v1/videos/edits

Cúplaíonn an t-iarratas físeán foinseach le leid a chuireann síos ar an modhnú atá ag teastáil.

{
  "model": "grok-imagine-video",
  "prompt": "Change the background to a sunset over the ocean",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Is leor trí réimse: model, a fhanann grok-imagine-video; prompt, ina bhfuil cur síos ar an modhnú; agus video.url, a dhíríonn ar an gcomhad MP4 le próiseáil. Tabhair faoi deara go bhfuil an fhíseán cuimsithe i réad video, a ghlacann url nó file_id comhaid uaslódáilte: glacann an pointe deiridh sínithe, sa chéad cheacht eile, leis an gcoinbhinsiún céanna.

Tá srianta teicniúla níos doichte anseo ná sa ghiniúint. Ní mór nach sáróidh an fhoinse 8.7 soicind, agus coinníonn an fhíseán a tháirgtear a fhad; luaíonn an leathanach Video Generation fad ” teoranta ag 8.7 soicind” gan mionsonrú a dhéanamh ar láimhseáil foinse níos faide: mar sin, gearr do fhoinsí roimh ré. Tá an taifeach teoranta ag 720p. Ní mór gur comhad MP4 é an comhad ionchuir i gcóideac tacaithe, mar shampla H.264, H.265, nó AV1. Is é an pointe is mearbhaillaí dóibh siúd a thagann ón nginiúint: níl aon smacht agat ar fhad, ar chóimheas gnéithe, ná ar thaifeach an aschuir, rud a chinntear go hiomlán ag an bhfíseán foinseach. Níl aon réimse duration, aspect_ratio, ná resolution san iarratas eagarthóireachta.

Cad a iarrfar in eagarthóireacht

Is é athsholáthar an chúlra an cás leabhair: fanann an t-ábhar, athraíonn an suíomh.

{
  "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"}
}

Baineann athruithe stíle leis an íomhá iomlán agus claochlaíonn siad stíl an chlip gan a ghníomhaíocht a mhodhnú—praiticiúil chun an seicheamh céanna a oiriúnú do chruinne éagsúla.

{
  "model": "grok-imagine-video",
  "prompt": "Transform this video into a Japanese cartoon style with vivid colors",
  "video": {"url": "https://example.com/video.mp4"}
}

Cuireann cur le heilimintí sraitheanna leis an radharc nach raibh ann le linn na scannánaíochta, de ghnáth atmaisféarach.

{
  "model": "grok-imagine-video",
  "prompt": "Add falling snow and a frost effect on the edges",
  "video": {"url": "https://example.com/video.mp4"}
}

Ar deireadh, is ionann modhnú soilsiú agus athghrádú an tseichimh: na radhairc chéanna, atmaisféar go hiomlán difriúil.

{
  "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"}
}

An timthriall neamhshioncronach, mar an gcéanna leis an nginiúint

Leanann an eagarthóireacht an prótacal ceithre chéim céanna go díreach leis an nginiúint: seolann tú an t-iarratas, faigheann tú request_id, déanann tú polú ar GET /v1/videos/{request_id} ag eatraimh rialta, agus faigheann tú an fhíseán eagarthóireachta nuair a athraíonn an stádas go done. I bPython, oireann an dá chéad chéad i roinnt línte.

import httpx

# 1. Cuir an t-eagarthóireacht isteach
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. Polú ar an stádas (simplithe)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Sonraigh cad a athraíonn, agus cad a fhanann

Cuireann xAI síos ar iompar an mhúnla i ngnáthamh amháin: cuireann grok-imagine-video an t-athrú a iarradh i bhfeidhm agus coinníonn sé gach rud eile chomh gar don fhoinse agus is féidir. Díorthaíonn a chuid doiciméadaithe treoir ón méid seo: abair freisin cad a chaithfidh fanacht mar an gcéanna. Díríonn a chuid samplaí féin freisin ar eagarthóireacht chruinn ar chlip amháin—muince airgid a chur leis, éadaí a athrú go dearg, hata dubh leathanbhríoch a chur ar charachtar—ag rith go comhthreomhar ar an bhfoinse chéanna.

{
  "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"}
}

Sonraíonn treoir leid íomhá xAI, atá scríofa d’íomhánna statacha, an t-ord a oibríonn: an modhnú ar dtús, ansin abairt a ghlasálann cad a fhanann statach. Ní athraíonn eagarthóireacht a thosaíonn le “coinnigh gach rud” mórán, agus athchruthaíonn eagarthóireacht a chóipeálann leid giniúna iomlán an radharc.

Seachnaíonn ceithre nós na paiteanna is mó: coinnigh do fhoinsí faoi 8.7 soicind, i gcóideac tacaithe (H.264, H.265, nó AV1); ainmnigh cad a chaithfidh fanacht slán; déan tástáil ar mhodhnú ar chlip gairid sula scálann tú é; agus cuimhnigh go n-úsáideann eagarthóireacht grok-imagine-video, a léiríonn a ghreille praghsála ráta amháin, $0.050 in aghaidh an tsoicind—costaíonn babhta trialacha an méid céanna leis an nginiúint.

Príomhphointí

  • Modhnaíonn an pointe deiridh POST /v1/videos/edits físeán atá ann cheana bunaithe ar leid, le grok-imagine-video amháin
  • Níl an fhoinse níos faide ná 8.7 soicind; coinníonn an t-aschur a fhad, a chóimheas, agus a thaifeach (720p ar a mhéad)
  • Ní mór gur MP4 é an fhíseán foinseach i gcóideac tacaithe (H.264, H.265, AV1)
  • Níl aon réimse duration, aspect_ratio, ná resolution san iarratas
  • Abair cad a chaithfidh athrú, ansin cad a chaithfidh fanacht mar an gcéanna