Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Gala punkts /v1/images/edits: rediģē savus attēlus

Nodarbība 5 no 14 Atjaunota 2026. gada 2. novembris Iesācējs
Šajā lapā
  1. Attēlu rediģēšana, izmantojot Grok API
  2. Rediģēšanas pieprasījuma struktūra
  3. Kāpēc izmantot requests, nevis OpenAI SDK?
  4. Rediģēšanas gala punkta parametri
  5. Iespējamo rediģējumu veidi
  6. Praktiskais uzdevums
  7. Galvenās atziņas

Atjaunināts 2026. gada 2. novembrī — Imagine. grok-imagine-image-quality tika noņemts 2026. gada 2. novembrī (tā pieprasījumus apkalpo Imagine 2.0 ar low kvalitāti): piemēri tagad izmanto grok-imagine-image (Imagine 1.0) un grok-imagine-image-2.0 (Imagine 2.0 ar low, medium vai auto kvalitāti). Izmantojot OpenAI SDK, parametri aspect_ratio, resolution un quality tiek nodoti caur extra_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).

5
Maksimālais avota attēlu skaits
2
Ievades formāti
JSON
Nepieciešamais Content-Type
∞
Rediģēšanas cikli

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) vai grok-imagine-image-2.0 (Imagine 2.0, kas pieņem arī quality)
  • prompt (obligāts): pielietojamās modifikācijas apraksts
  • image: objekts, kas satur viena avota attēla URL
  • images: objektu masīvs vairākiem avota attēliem (savstarpēji izslēdzošs ar image)
  • mask: objekts, kas satur apgabala maskas URL, kuru rediģēt
  • n: ģenerējamo variantu skaits (no 1 līdz 10)
  • response_format: url vai b64_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