Salt la conținutul principal
Română— Alege o limbă
Meniu

Montaj video cu /v1/videos/edits

Lecția 7 din 12 Actualizată 3 noiembrie 2026 Intermediar
Pe această pagină
  1. Editarea unui videoclip existent
  2. Punctul de finalitate POST /v1/videos/edits
  3. Ce să solicitați într-o editare
  4. Ciclul asincron, identic cu generarea
  5. Specificați ce se schimbă și ce rămâne neschimbat
  6. Puncte cheie

Actualizat la 3 noiembrie 2026. Pe baza paginii Video Editing de la xAI: videoclipul sursă are o durată maximă de 8,7 secunde, iar ieșirea își păstrează durata, raportul de aspect și rezoluția (maxim 720p); extinderea folosește același obiect video ca și editarea. Afirmația anterioară conform căreia editarea era nesigură pentru elemente specifice contrazice exemplele xAI, care se concentrează tocmai pe editări precise. Surse: Video Editing · Video Overview.

Editarea unui videoclip existent

Generarea reprezintă doar o parte a procesului. API-ul xAI expune, de asemenea, un punct de finalitate pentru editarea video care preia o secvență existentă și o modifică pe baza unor prompturi textuale. Este echivalentul video al editării imaginilor, dar cu constrângeri de format mai stricte. Înainte de a scrie prima cerere, rețineți cele patru limite care determină ce puteți trimite.

8.7 s
Durata maximă a sursei
720p
Rezoluție maximă
H.265
Codec acceptat (cum ar fi H.264, AV1)
MP4
Format obligatoriu

Punctul de finalitate POST /v1/videos/edits

Cererea asociază un videoclip sursă cu un prompt care descrie modificarea dorită.

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

Trei câmpuri sunt suficiente: model, care rămâne grok-imagine-video; prompt, care conține descrierea modificării; și video.url, care indică fișierul MP4 de procesat. Observați că videoclipul este încapsulat într-un obiect video, care acceptă un url sau file_id al unui fișier încărcat: punctul de finalitate pentru extindere, din lecția următoare, adoptă aceeași convenție.

Constrângerile tehnice sunt aici mai stricte decât în cazul generării. Sursa nu trebuie să depășească 8,7 secunde, iar videoclipul produs își păstrează durata; pagina Video Generation menționează o durată „limitată la 8,7 secunde“ fără a detalia gestionarea unei surse mai lungi: prin urmare, decupați sursele în prealabil. Rezoluția este limitată la 720p. Fișierul de intrare trebuie să fie un MP4 într-un codec suportat, cum ar fi H.264, H.265 sau AV1. Cel mai confuz aspect pentru cei care vin din zona generării: nu aveți niciun control asupra duratei, raportului de aspect sau rezoluției ieșirii, toate fiind determinate de videoclipul sursă. Cererea de editare nu include niciun câmp duration, aspect_ratio sau resolution.

Ce să solicitați într-o editare

Înlocuirea fundalului este cazul de școală: subiectul rămâne, cadrul se schimbă.

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

Schimbările de stil afectează întreaga imagine și transformă stilul clipului fără a-i modifica acțiunea – util pentru adaptarea aceleiași secvențe în universuri diferite.

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

Adăugarea de elemente îmbogățește scena cu straturi care nu existau în timpul filmării, de obicei atmosferice.

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

În final, modificarea iluminării echivalează cu regradarea secvenței: aceleași cadre, o ambianță radical diferită.

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

Ciclul asincron, identic cu generarea

Editarea urmează exact același protocol în patru pași ca și generarea: trimiteți cererea, primiți un request_id, interogați periodic GET /v1/videos/{request_id} și recuperați videoclipul editat când statusul devine done. În Python, primii doi pași se încadrează în câteva linii.

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()

Specificați ce se schimbă și ce rămâne neschimbat

xAI descrie comportamentul modelului într-o singură propoziție: grok-imagine-video aplică modificarea solicitată și păstrează totul celălalt cât mai aproape posibil de sursă. Documentația sa derivează o regulă din acest fapt: spuneți și ce trebuie să rămână identic. Propriile exemple se concentrează, de asemenea, pe editări precise ale unui singur clip – adăugarea unui colier de argint, schimbarea unei ținute în roșu, punerea unei pălării negre cu boruri largi pe un personaj – rulate în paralel pe aceeași sursă.

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

Ghidul de prompturi pentru imagini al xAI, scris pentru imagini statice, specifică ordinea care funcționează: modificarea mai întâi, apoi o propoziție care blochează ceea ce rămâne static. O editare care începe cu „păstrează totul“ nu schimbă aproape nimic, iar o editare care copiază un prompt complet de generare reinventează scena.

Patru obiceiuri evită majoritatea capcanelor: mențineți sursele sub 8,7 secunde, într-un codec suportat (H.264, H.265 sau AV1); numiți ceea ce trebuie să rămână intact; testați o modificare pe un clip scurt înainte de a o scala; și amintiți-vă că editarea folosește grok-imagine-video, a cărui grilă de prețuri afișează o singură rată, 0,050 USD pe secundă – o serie de teste costă la fel ca generarea.

Puncte cheie

  • Punctul de finalitate POST /v1/videos/edits modifică un videoclip existent pe baza unui prompt, folosind exclusiv grok-imagine-video
  • Sursa durează cel mult 8,7 secunde; ieșirea își păstrează durata, raportul și rezoluția (maxim 720p)
  • Videoclipul sursă trebuie să fie un MP4 într-un codec suportat (H.264, H.265, AV1)
  • Cererea nu are niciun câmp duration, aspect_ratio sau resolution
  • Spuneți ce trebuie să se schimbe, apoi ce trebuie să rămână identic