Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Lõpp-punkt /v1/images/edits: piltide muutmine

Õppetund 5 / 14 Värskendatud 2. november 2026 Algajatele
Sellel lehel
  1. Piltide muutmine Grok API-ga
  2. Muutmispäringu struktuur
  3. Miks kasutada requests-i OpenAI SDK asemel?
  4. Muutmise lõpp-punkti parameetrid
  5. Võimalike muudatuste tüübid
  6. Praktiline harjutus
  7. Peamised punktid

Uuendatud 2. novembril 2026 – Imagine. grok-imagine-image-quality eemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 kvaliteediga low): näited kasutavad edaspidi mudeleid grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, kvaliteediga low, medium või auto). OpenAI SDK puhul edastatakse parameetrid aspect_ratio, resolution ja quality väljas extra_body; piltide muutmine nõuab xAI SDK-d või otsest HTTP-päringut.

Piltide muutmine Grok API-ga

Lisaks piltide loomisele pakub xAI API spetsiaalset lõpp-punkti olemasolevate piltide muutmiseks: POST /v1/images/edits. See lõpp-punkt võimaldab sul pilte muuta, teisendada või täiustada, kirjeldades soovitud muudatusi lihtsas tekstisisendis (prompt).

5
Maksimaalne allikapiltide arv
2
Sisendformaadid
JSON
Nõutav Content-Type
∞
Muutmiskordade arv

Muutmispäringu struktuur

Muutmine sarnaneb loomisega, kuid on üks oluline erinevus, mis mõjutab fundamentaalselt seda, kuidas sa sisendeid kirjutad: sisend kirjeldab muudatust, mitte lõplikku pilti. „Naine päikeseprillidega“ genereerib kogu pildi uuesti; „lisa päikeseprillid“ säilitab foto ja sekkub ainult sellesse detaili. See on kõige levinum viga esimesel katsel ja see selgitab enamikku pettumust valmistavaid tulemusi.

import requests
import os

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

payload = {
    "model": "grok-imagine-image",
    "prompt": "Lisa tegelasele punane müts",
    "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"]

Miks kasutada requests-i OpenAI SDK asemel?

Siin peitub selle õppetüki tehniline lõks, millest tasub teada enne, kui kulutad sellele tund aega: ühilduvus OpenAI SDK-ga, mis toimib laitmatult piltide loomisel, lõpeb muutmisega. xAI muutmise lõpp-punkt kasutab JSON-formaati, samas kui SDK meetod images.edit() saadab andmed kujul multipart/form-data. See sisutüübi kokkusobimatus tähendab, et muutmiste jaoks pead kasutama otsest REST API-t koos Pythoni teegiga requests.

# EI TOIMI xAI API-ga
# client.images.edit(...)  # Saadab multipart, mitte JSON

# TOIMIB: otsene REST-i väljakutse
requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

Muutmise lõpp-punkti parameetrid

  • model (kohustuslik): grok-imagine-image (Imagine 1.0) või grok-imagine-image-2.0 (Imagine 2.0, mis aktsepteerib ka parameetrit quality)
  • prompt (kohustuslik): kirjeldus rakendatavast muudatusest
  • image: objekt, mis sisaldab ühe allikapildi URL-i
  • images: objektide massiiv mitme allikapildi jaoks (vastastikku välistav parameetriga image)
  • mask: objekt, mis sisaldab muudetava ala maski URL-i
  • n: genereeritavate variantide arv (1 kuni 10)
  • response_format: url või b64_json

Võimalike muudatuste tüübid

Allpool toodud viiel kategoorial ei ole sama edu määr ja seda tasub teada enne, kui lubad kindlat tulemust. Elementide lisamine ja meeleolu muutmine toimivad väga hästi, kuna need tuginevad olemasolevale sisule. Eemaldamine on keerulisem – mudel peab rekonstrueerima selle, mis oli eemaldatud elemendi taga – ja just siin muutub mask hädavajalikuks, määratledes täpselt ala, mida ümber arvutada.

  • Elementide lisamine: „Lisa tegelasele päikeseprillid“
  • Eemaldamine: „Eemalda taust ja asenda see valge taustaga“
  • Stiili teisendamine: „Teisenda see foto akvarellillustratsiooniks“
  • Meeleolu muutmine: „Muuda stseen päevast ööks“
  • Korrigeerimine: „Paranda valgustust ja suurenda kontrasti“
# Näide: pildi stiili muutmine
payload = {
    "model": "grok-imagine-image",
    "prompt": "Teisenda see foto franko-belgia koomiksistiilis illustratsiooniks",
    "image": {
        "url": "https://exemple.com/photo-ville.jpg"
    }
}

Praktiline harjutus

Proovi pilti muuta mitmes etapis. Alusta lihtsast muudatusest ja seejärel täpsusta:

# 1. samm: tausta muutmine
payload_step1 = {
    "model": "grok-imagine-image",
    "prompt": "Asenda taust päikeseloojanguga ookeani kohal",
    "image": {"url": "https://exemple.com/portrait.jpg"}
}

Peamised punktid

  • Muutmise lõpp-punkt on POST /v1/images/edits
  • Kasuta Pythonis teeki requests, mitte OpenAI SDK-d (formaadi kokkusobimatus)
  • Ühes päringus saab esitada kuni 5 allikapilti
  • Sisend kirjeldab soovitud muudatust loomulikus keeles
  • Mõlemad mudelid (Imagine 1.0 ja Imagine 2.0) on muutmiseks saadaval; OpenAI SDK puhul ei toeta xAI meetodit images.edit(): kasuta xAI SDK-d või HTTP-päringut