Endpoint /v1/images/edits: Editarea imaginilor dumneavoastră
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Imagine.
grok-imagine-image-qualitya fost eliminat la 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 la calitatelow): exemplele folosesc acumgrok-imagine-image(Imagine 1.0) șigrok-imagine-image-2.0(Imagine 2.0, calitatelow,mediumsauauto). Cu SDK-ul OpenAI,aspect_ratio,resolutionșiqualityse transmit prinextra_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.
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) saugrok-imagine-image-2.0(Imagine 2.0, care acceptă șiquality)prompt(obligatoriu): descrierea modificării de aplicatimage: obiect care conține URL-ul unei singure imagini sursăimages: tablou de obiecte pentru mai multe imagini sursă (exclusiv reciproc cuimage)mask: obiect care conține URL-ul măștii zonei de editatn: numărul de variante de generat (1 până la 10)response_format:urlsaub64_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