Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Endpoint /v1/images/edits: Szerkeszd a képeidet

5. lecke 14 közül Frissítve 2026. november 2. Kezdő
Ezen az oldalon
  1. Képszerkesztés a Grok API-val
  2. A szerkesztési kérés felépítése
  3. Miért használd a requests könyvtárat az OpenAI SDK helyett?
  4. A szerkesztési endpoint paraméterei
  5. Lehetséges szerkesztési típusok
  6. Gyakorlati feladat
  7. Főbb megállapítások

Frissítve: 2026. november 2. — Imagine. A grok-imagine-image-quality modellt 2026. november 2-án megszüntették (a kéréseit az Imagine 2.0 szolgálja ki low minőségben): a példák most a grok-imagine-image (Imagine 1.0) és a grok-imagine-image-2.0 (Imagine 2.0, low, medium vagy auto minőség) modelleket használják. Az OpenAI SDK-val az aspect_ratio, resolution és quality paramétereket az extra_body objektumon keresztül kell megadni, míg a szerkesztéshez az xAI SDK-t vagy egy közvetlen HTTP-kérést kell használnod.

Képszerkesztés a Grok API-val

A képgenerálás mellett az xAI API egy dedikált endpointot kínál meglévő képek szerkesztésére: POST /v1/images/edits. Ezzel az endpointtal módosíthatsz, átalakíthatsz vagy javíthatsz képeket úgy, hogy egy egyszerű szöveges promptban írod le a kívánt változtatásokat.

5
Maximális forráskép
2
Bemeneti formátumok
JSON
Kötelező Content-Type
∞
Szerkesztési körök

A szerkesztési kérés felépítése

A szerkesztés működése hasonló a generáláshoz, de van egy különbség, ami mindent megváltoztat a promptok megírásában: a prompt a módosítást írja le, nem a végső képet. A „Napszemüveges nő“ prompt egy teljes képet generál újra; az „Adj napszemüveget“ prompt megtartja a fotót, és csak ezen a ponton avatkozik be. Ez a leggyakoribb hiba az első próbálkozásoknál, és ez magyarázza a legtöbb csalódást okozó eredményt.

import requests
import os

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

payload = {
    "model": "grok-imagine-image",
    "prompt": "Adj egy piros kalapot a karakterhez",
    "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"]

Miért használd a requests könyvtárat az OpenAI SDK helyett?

Itt jön a lecke technikai buktatója, és érdemes ezt tudnod, mielőtt egy órát pazarolnál rá: az OpenAI SDK-val való kompatibilitás, amely tökéletesen működik a generálásnál, a szerkesztésnél véget ér. Az xAI szerkesztő endpointja JSON formátumot használ, míg az SDK images.edit() metódusa multipart/form-data adatot küld. Ez a tartalomtípus-összeférhetetlenség azt jelenti, hogy a szerkesztésekhez közvetlenül a REST API-t kell használnod a requests könyvtárral.

# NEM MŰKÖDIK az xAI API-val
# client.images.edit(...)  # Multipart adatot küld, nem JSON-t

# MŰKÖDIK: közvetlen REST hívás
requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

A szerkesztési endpoint paraméterei

  • model (kötelező): grok-imagine-image (Imagine 1.0) vagy grok-imagine-image-2.0 (Imagine 2.0, amely elfogadja a quality paramétert is)
  • prompt (kötelező): az alkalmazandó módosítás leírása
  • image: objektum, amely egyetlen forráskép URL-jét tartalmazza
  • images: objektumok tömbje több forráskép esetén (kölcsönösen kizárja az image paramétert)
  • mask: objektum, amely a szerkesztendő terület maszkjának URL-jét tartalmazza
  • n: a generálandó variánsok száma (1 és 10 között)
  • response_format: url vagy b64_json

Lehetséges szerkesztési típusok

Az alábbi öt kategória nem rendelkezik azonos sikeraránnyal, és segít, ha ezt tudod, mielőtt eredményt ígérsz. Az elemek hozzáadása és a hangulat megváltoztatása nagyon jól működik, mivel ezek a meglévő tartalomra építenek. Az eltávolítás trükkösebb – a modellnek rekonstruálnia kell, mi volt az eltávolított elem mögött –, és itt válik elengedhetetlenné a maszk használata, mivel ez határolja be pontosan az újraszámolandó területet.

  • Elemek hozzáadása: „Adj napszemüveget a karakterhez“
  • Eltávolítás: „Távolítsd el a hátteret, és cseréld le fehér háttérre“
  • Stílustranszformáció: „Alakítsd át ezt a fotót vízfesték illusztrációvá“
  • Hangulatmódosítás: „Változtasd meg a jelenetet nappaliból éjszakaiba“
  • Korrektúra: „Javítsd a világítást és növeld a kontrasztot“
# Példa: kép stílusának megváltoztatása
payload = {
    "model": "grok-imagine-image",
    "prompt": "Alakítsd át ezt a fotót franko-belga képregény stílusú illusztrációvá",
    "image": {
        "url": "https://exemple.com/photo-ville.jpg"
    }
}

Gyakorlati feladat

Próbáld meg egy kép szerkesztését több lépésben. Kezdj egy egyszerű módosítással, majd finomítsd azt:

# 1. lépés: a háttér módosítása
payload_step1 = {
    "model": "grok-imagine-image",
    "prompt": "Cseréld le a hátteret egy naplementés óceáni tájra",
    "image": {"url": "https://exemple.com/portrait.jpg"}
}

Főbb megállapítások

  • A szerkesztési endpoint: POST /v1/images/edits
  • Pythonban használd a requests könyvtárat, ne az OpenAI SDK-t (formátum-összeférhetetlenség miatt)
  • Kérésenként legfeljebb 5 forrásképet adhatsz meg
  • A prompt természetes nyelven írja le a kívánt módosítást
  • Mindkét modell (Imagine 1.0 és Imagine 2.0) elérhető szerkesztéshez; az OpenAI SDK images.edit() metódusát az xAI nem támogatja: használd az xAI SDK-t vagy egy HTTP-kérést