Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pabaigos taškas /v1/images/edits: redaguokite savo paveikslėlius

Paskaita 5 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Pradedantisiems
Šiame puslapyje
  1. Paveikslėlių redagavimas naudojant Grok API
  2. Redagavimo užklausos struktūra
  3. Kodėl naudoti requests vietoj OpenAI SDK?
  4. Redagavimo pabaigos taško parametrai
  5. Galimų redagavimo tipai
  6. Praktinė užduotis
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. – Imagine. grok-imagine-image-quality buvo pašalintas 2026 m. lapkričio 2 d. (jo užklausas dabar apdoroja Imagine 2.0 su low kokybe): pavyzdžiuose naudojami grok-imagine-image (Imagine 1.0) ir grok-imagine-image-2.0 (Imagine 2.0, low, medium arba auto kokybės). Naudojant OpenAI SDK, parametrai aspect_ratio, resolution ir quality perduodami per extra_body, o redagavimui reikia naudoti xAI SDK arba tiesioginį HTTP užklausą.

Paveikslėlių redagavimas naudojant Grok API

Be generavimo, xAI API siūlo specialų pabaigos tašką esamiems paveikslėliams redaguoti: POST /v1/images/edits. Šis pabaigos taškas leidžia modifikuoti, transformuoti arba pagerinti paveikslėlius, paprastu teksto raginimu (prompt) aprašant norimus pakeitimus.

5
Maksimalus šaltinių paveikslėlių skaičius
2
Įvesties formatai
JSON
Privalomas Content-Type
∞
Redagavimo ciklai

Redagavimo užklausos struktūra

Redagavimas veikia panašiai kaip generavimas, tačiau yra vienas esminis skirtumas, keičiantis tai, kaip rašai raginimus: raginimas aprašo pakeitimą, o ne galutinį paveikslėlį. „Moteris su akiniais nuo saulės“ sugeneruos visą naują paveikslėlį iš naujo; „pridėk akinius nuo saulės“ paliks nuotrauką ir įsikiš tik į tą konkrečią vietą. Tai dažniausia klaida pirmojo bandymo metu, ji paaiškina daugelį nuviliantičių rezultatų.

import requests
import os

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

payload = {
    "model": "grok-imagine-image",
    "prompt": "Pridėk raudoną kepurę veikėjui",
    "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"]

Kodėl naudoti requests vietoj OpenAI SDK?

Štai techninė šios pamokos spąstai, apie kuriuos norėsi žinoti prieš švaistant valandą laiko: suderinamumas su OpenAI SDK, kuris puikiai veikia generuojant, baigiasi ties redagavimu. xAI redagavimo pabaigos taškas naudoja JSON formatą, tuo tarpu SDK metodas images.edit() siunčia multipart/form-data. Dėl šio turinio tipo nesuderinamumo redagavimui privalai tiesiogiai naudoti REST API su requests biblioteka.

# NEVEIKIA su xAI API
# client.images.edit(...)  # Siunčia multipart, o ne JSON

# VEIKIA: tiesioginis REST kvietimas
requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

Redagavimo pabaigos taško parametrai

  • model (privaloma): grok-imagine-image (Imagine 1.0) arba grok-imagine-image-2.0 (Imagine 2.0, kuris taip pat priima quality)
  • prompt (privaloma): taikytino pakeitimo aprašymas
  • image: objektas, kuriame yra vieno šaltinio paveikslėlio URL
  • images: objektų masyvas keliems šaltinio paveikslėliams (negali būti naudojama kartu su image)
  • mask: objektas, kuriame yra redaguojamos srities kaukės URL
  • n: generuotinų variantų skaičius (nuo 1 iki 10)
  • response_format: url arba b64_json

Galimų redagavimo tipai

Toliau išvardytos penkios šeimos neturi vienodos sėkmės tikimybės, ir tai naudinga žinoti prieš žadant rezultatą. Elementų pridėjimas ir atmosferos keitimas veikia labai gerai, nes remiasi esamu turiniu. Šalinimas yra sudėtingesnis – modelis turi rekonstruoti tai, kas buvo po pašalintu elementu – ir būtent čia kaukė tampa būtina, tiksliai apibrėždama perskaičiuotiną sritį.

  • Elementų pridėjimas: „Pridėk veikėjui akinius nuo saulės“
  • Šalinimas: „Pašalink foną ir pakeisk jį baltu fonu“
  • Stiliaus transformacija: „Paversk šią nuotrauką akvarelės iliustracija“
  • Atmosferos modifikavimas: „Pakeisk sceną iš dienos į naktį“
  • Korekcija: „Pagerink apšvietimą ir padidink kontrastą“
# Pavyzdys: pakeisti paveikslėlio stilių
payload = {
    "model": "grok-imagine-image",
    "prompt": "Transformuok šią nuotrauką į frankų-belgų komiksų stiliaus iliustraciją",
    "image": {
        "url": "https://exemple.com/photo-ville.jpg"
    }
}

Praktinė užduotis

Pabandyk redaguoti paveikslėlį keliais etapais. Pradėk nuo paprasto pakeitimo, tada tobulink:

# 1 žingsnis: pakeisti foną
payload_step1 = {
    "model": "grok-imagine-image",
    "prompt": "Pakeisk foną į saulėlydį virš vandenyno",
    "image": {"url": "https://exemple.com/portrait.jpg"}
}

Svarbiausi punktai

  • Redagavimo pabaigos taškas yra POST /v1/images/edits
  • Python kalboje naudok requests, o ne OpenAI SDK (formato nesuderinamumas)
  • Vienoje užklausoje gali pateikti iki 5 šaltinio paveikslėlių
  • Raginimas natūralia kalba aprašo norimą pakeitimą
  • Redagavimui available abu modeliai (Imagine 1.0 ir Imagine 2.0); naudojant OpenAI SDK, images.edit() xAI nepalaikomas: naudok xAI SDK arba HTTP užklausą