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

Endpoint /v1/images/edits: Editarea imaginilor dumneavoastră

Lecția 5 din 14 Actualizată 2 noiembrie 2026 Începător
Pe această pagină
  1. Editarea imaginilor cu API-ul Grok
  2. Structura cererii de editare
  3. De ce să utilizați requests în loc de SDK-ul OpenAI?
  4. Parametrii endpoint-ului de editare
  5. Tipuri de editări posibile
  6. Exercițiu practic
  7. Puncte cheie

Actualizat pe 2 noiembrie 2026 — Imagine. grok-imagine-image-quality a fost eliminat la 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 la calitate low): exemplele folosesc acum grok-imagine-image (Imagine 1.0) și grok-imagine-image-2.0 (Imagine 2.0, calitate low, medium sau auto). Cu SDK-ul OpenAI, aspect_ratio, resolution și quality se transmit prin extra_body, iar editarea necesită utilizarea SDK-ului xAI sau a unei cereri HTTP.

Editarea imaginilor cu API-ul Grok

Dincolo de generare, API-ul xAI oferă un endpoint dedicat pentru editarea imaginilor existente: POST /v1/images/edits. Acest endpoint vă permite să modificați, transformați sau să îmbunătățiți imagini descriind schimbările dorite într-un prompt text simplu.

5
Imagini sursă maxime
2
Formate de intrare
JSON
Content-Type obligatoriu
∞
Runde de editare

Structura cererii de editare

Editarea funcționează similar cu generarea, cu o singură diferență care schimbă totul în modul de scriere a prompturilor: promptul descrie modificarea, nu imaginea finală. „O femeie cu ochelari de soare“ regenerează o imagine întreagă; „adaugă ochelari de soare“ păstrează fotografia și intervine doar asupra acelui punct. Aceasta este cea mai frecventă confuzie la prima încercare și explică majoritatea rezultatelor dezamăgitoare.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

payload = {
    "model": "grok-imagine-image",
    "prompt": "Adaugă o pălărie roșie personajului",
    "image": {
        "url": "https://exemple.com/photo-personnage.jpg"
    }
}

response = requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

result = response.json()
edited_url = result["data"][0]["url"]

De ce să utilizați requests în loc de SDK-ul OpenAI?

Iată capcana tehnică a acestei lecții, pe care veți dori să o cunoașteți înainte de a pierde o oră cu ea: compatibilitatea cu SDK-ul OpenAI, care funcționează perfect pentru generare, se oprește la editare. Endpoint-ul de editare xAI utilizează un format JSON, în timp ce metoda images.edit() din SDK trimite multipart/form-data. Această incompatibilitate de tip de conținut înseamnă că trebuie să utilizați API-ul REST direct cu biblioteca requests pentru editări.

# NU FUNCȚIONEAZĂ cu API-ul xAI
# client.images.edit(...)  # Trimite multipart, nu JSON

# FUNCȚIONEAZĂ: apel REST direct
requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

Parametrii endpoint-ului de editare

  • model (obligatoriu): grok-imagine-image (Imagine 1.0) sau grok-imagine-image-2.0 (Imagine 2.0, care acceptă și quality)
  • prompt (obligatoriu): descrierea modificării de aplicat
  • image: obiect care conține URL-ul unei singure imagini sursă
  • images: tablou de obiecte pentru mai multe imagini sursă (exclusiv reciproc cu image)
  • mask: obiect care conține URL-ul măștii zonei de editat
  • n: numărul de variante de generat (1 până la 10)
  • response_format: url sau b64_json

Tipuri de editări posibile

Cele cinci familii de mai jos nu au aceeași rată de succes, iar este util să știți acest lucru înainte de a promite un rezultat. Adăugarea de elemente și schimbarea atmosferei funcționează foarte bine deoarece se bazează pe conținut existent. Eliminarea este mai delicată – modelul trebuie să reconstruiască ceea ce se afla în spatele elementului eliminat – și aici masca devine esențială, delimitând precis zona de recalculat.

  • Adăugarea de elemente: „Adaugă ochelari de soare personajului“
  • Eliminare: „Elimină fundalul și înlocuiește-l cu un fundal alb“
  • Transformare de stil: „Transformă această fotografie într-o ilustrație în acuarelă“
  • Modificare de ambianță: „Schimbă scena din zi în noapte“
  • Corecție: „Îmbunătățește iluminarea și mărește contrastul“
# Exemplu: schimbarea stilului unei imagini
payload = {
    "model": "grok-imagine-image",
    "prompt": "Transformă această fotografie într-o ilustrație în stil de bandă desenată franco-belgiană",
    "image": {
        "url": "https://exemple.com/photo-ville.jpg"
    }
}

Exercițiu practic

Încercați să editați o imagine în mai mulți pași. Începeți cu o modificare simplă, apoi rafinați:

# Pasul 1: modificarea fundalului
payload_step1 = {
    "model": "grok-imagine-image",
    "prompt": "Înlocuiește fundalul cu un apus de soare peste ocean",
    "image": {"url": "https://exemple.com/portrait.jpg"}
}

Puncte cheie

  • Endpoint-ul de editare este POST /v1/images/edits
  • Utilizați requests în Python, nu SDK-ul OpenAI (incompatibilitate de format)
  • Puteți furniza până la 5 imagini sursă per cerere
  • Promptul descrie modificarea dorită în limbaj natural
  • Ambele modele (Imagine 1.0 și Imagine 2.0) sunt disponibile pentru editare; cu SDK-ul OpenAI, images.edit() nu este suportat de xAI: utilizați SDK-ul xAI sau o cerere HTTP