Gala punkts /v1/images/edits: rediģē savus attēlus
Šajā lapā
Atjaunināts 2026. gada 2. novembrī — Imagine.
grok-imagine-image-qualitytika noņemts 2026. gada 2. novembrī (tā pieprasījumus apkalpo Imagine 2.0 arlowkvalitāti): piemēri tagad izmantogrok-imagine-image(Imagine 1.0) ungrok-imagine-image-2.0(Imagine 2.0 arlow,mediumvaiautokvalitāti). Izmantojot OpenAI SDK, parametriaspect_ratio,resolutionunqualitytiek nodoti caurextra_body, bet rediģēšanai izmanto xAI SDK vai HTTP pieprasījumu.
Attēlu rediģēšana, izmantojot Grok API
Papildus ģenerēšanai xAI API piedāvā specializētu gala punktu esošo attēlu rediģēšanai: POST /v1/images/edits. Šis gala punkts ļauj modificēt, pārveidot vai uzlabot attēlus, tekstā aprakstot vēlamos izmaiņas vienkāršā uzvednē (prompt).
Rediģēšanas pieprasījuma struktūra
Rediģēšana darbojas līdzīgi ģenerēšanai, taču ar vienu atšķirību, kas maina visu, kā tu raksti uzvednes: uzvedne apraksta modifikāciju, nevis gala attēlu. „Sieviete ar saulesbrillēm” ģenerēs attēlu no jauna, savukārt „pievieno saulesbrilles” saglabās fotoattēlu un iejauksies tikai šajā konkrētajā aspektā. Šī ir visbiežāk sastopamā kļūda pirmajā mēģinājumā, un tā izskaidro lielāko daļu viltušo rezultātu.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Pievieno personāžam sarkanu cepuri",
"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"]
Kāpēc izmantot requests, nevis OpenAI SDK?
Šī ir nodarbības tehniskā slazda vieta, un tev par to ir jāzina, pirms tērē stundu veltīgām darbībām: saderība ar OpenAI SDK, kas ģenerēšanai strādā nevainojami, beidzas pie rediģēšanas. xAI rediģēšanas gala punkts izmanto JSON formātu, savukārt SDK metode images.edit() nosūta datus formātā multipart/form-data. Šī satura tipa nesaderība nozīmē, ka rediģēšanai tev ir jāizmanto REST API tieši, izmantojot bibliotēku requests.
# NESTRĀDĀ ar xAI API
# client.images.edit(...) # Nosūta multipart, nevis JSON
# STRĀDĀ: tiešs REST izsaukums
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Rediģēšanas gala punkta parametri
model(obligāts):grok-imagine-image(Imagine 1.0) vaigrok-imagine-image-2.0(Imagine 2.0, kas pieņem arīquality)prompt(obligāts): pielietojamās modifikācijas aprakstsimage: objekts, kas satur viena avota attēla URLimages: objektu masīvs vairākiem avota attēliem (savstarpēji izslēdzošs arimage)mask: objekts, kas satur apgabala maskas URL, kuru rediģētn: ģenerējamo variantu skaits (no 1 līdz 10)response_format:urlvaib64_json
Iespējamo rediģējumu veidi
Zemāk minētās piecas kategorijas neatbilst vienādai veiksmes pakāpei, un to ir lietderīgi zināt, pirms solīt konkrētu rezultātu. Elementu pievienošana un noskaņas maiņa darbojas ļoti labi, jo tās balstās uz esošo saturu. Dzēšana ir sarežģītāka — modelim ir jārekonstruē tas, kas atradās aiz dzēstā elementa — un tieši šeit maska kļūst būtiska, precīzi norobežojot pārrēķināmo apgabalu.
- Elementu pievienošana: „Pievieno personāžam saulesbrilles”
- Dzēšana: „Noņem fonu un nomaini to uz baltu fonu”
- Stila transformācija: „Pārvērt šo fotoattēlu akvareļa ilustrācijā”
- Noskaņas modificēšana: „Nomaini scēnu no dienas uz nakti”
- Korekcija: „Uzlabo apgaismojumu un palielini kontrastu”
# Piemērs: attēla stila maiņa
payload = {
"model": "grok-imagine-image",
"prompt": "Pārvērt šo fotoattēlu franču-beļģu komiksu stila ilustrācijā",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktiskais uzdevums
Izmēģini attēla rediģēšanu vairākos soļos. Sāc ar vienkāršu modifikāciju, pēc tam to precizē:
# 1. solis: fona modificēšana
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Nomaini fonu uz saulrietu pār okeānu",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Galvenās atziņas
- Rediģēšanas gala punkts ir
POST /v1/images/edits - Python valodā izmanto
requests, nevis OpenAI SDK (formāta nesaderības dēļ) - Vienā pieprasījumā vari norādīt līdz 5 avota attēliem
- Uzvedne dabiskā valodā apraksta vēlamo modifikāciju
- Abi modeļi (Imagine 1.0 un Imagine 2.0) ir pieejami rediģēšanai; izmantojot OpenAI SDK,
images.edit()xAI neatbalsta: izmanto xAI SDK vai HTTP pieprasījumu