Endpoint /v1/images/edits: Redigér dine billeder
På denne side
Opdateret 2. november 2026 — Imagine.
grok-imagine-image-qualityblev fjernet den 2. november 2026 (dens anmodninger betjenes nu af Imagine 2.0 medlowkvalitet): eksemplerne bruger nugrok-imagine-image(Imagine 1.0) oggrok-imagine-image-2.0(Imagine 2.0, medlow,mediumellerautokvalitet). Med OpenAI SDK sendesaspect_ratio,resolutionogqualityviaextra_body, mens redigering kræver xAI SDK eller en direkte HTTP-anmodning.
Billedredigering med Grok API
Udover generering tilbyder xAI API’en en dedikeret endpoint til redigering af eksisterende billeder: POST /v1/images/edits. Denne endpoint giver dig mulighed for at modificere, transformere eller forbedre billeder ved at beskrive de ønskede ændringer i en simpel tekstprompt.
Struktur på en redigeringsanmodning
Redigering fungerer ligesom generering, men med én afgørende forskel, der ændrer alt ved, hvordan du skriver dine prompts: prompten beskriver modifikationen, ikke det færdige billede. „En kvinde med solbriller” vil regenerere hele billedet, mens „tilføj solbriller” bevarer fotoet og kun griber ind på netop det punkt. Dette er den hyppigste fejl ved første forsøg, og det forklarer de fleste skuffende resultater.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Tilføj en rød hat til karakteren",
"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"]
Hvorfor bruge requests i stedet for OpenAI SDK?
Her kommer lektionens tekniske fælde, som du bør kende, før du spilder en time på det: kompatibiliteten med OpenAI SDK, der fungerer perfekt til generering, stopper ved redigering. xAI’s redigeringsendpoint bruger et JSON-format, mens SDK’ens metode images.edit() sender multipart/form-data. Denne uforenelighed i indholdstypen betyder, at du skal bruge REST API’en direkte med biblioteket requests til redigering.
# VIRKER IKKE med xAI API'en
# client.images.edit(...) # Sender multipart, ikke JSON
# VIRKER: direkte REST-kald
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Parametre til redigeringsendpointen
model(påkrævet):grok-imagine-image(Imagine 1.0) ellergrok-imagine-image-2.0(Imagine 2.0, som også acceptererquality)prompt(påkrævet): beskrivelse af den modifikation, der skal anvendesimage: objekt indeholdende URL’en til et enkelt kildebilledeimages: array af objekter til flere kildebilleder (gensidigt udelukkende medimage)mask: objekt indeholdende URL’en til masken for det område, der skal redigeresn: antal varianter, der skal genereres (1 til 10)response_format:urlellerb64_json
Typer af mulige redigeringer
De fem kategorier nedenfor har ikke samme succesrate, og det er nyttigt at vide, før du lover et bestemt resultat. Tilføjelse af elementer og ændring af stemning fungerer meget godt, fordi de bygger på eksisterende indhold. Fjernelse er mere tricky – modellen skal rekonstruere det, der befandt sig bag det fjernede element – og her bliver masken essentiel ved præcist at afgrænse det område, der skal genberegnes.
- Tilføjelse af elementer: „Tilføj solbriller til karakteren”
- Fjernelse: „Fjern baggrunden og erstt den med en hvid baggrund”
- Stiltransformation: „Konvertér dette foto til en akvarelig illustration”
- Ændring af stemning: „Ændr scenen fra dag til nat”
- Korrektion: „Forbedr belysningen og øg kontrasten”
# Eksempel: ændr en billedstil
payload = {
"model": "grok-imagine-image",
"prompt": "Transformér dette foto til en illustration i fransk-belgisk tegneseriestil",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktisk øvelse
Prøv at redigere et billede i flere trin. Start med en simpel modifikation, og forfin derefter:
# Trin 1: modificér baggrunden
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Erstat baggrunden med en solnedgang over havet",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Vigtige pointer
- Redigeringsendpointen er
POST /v1/images/edits - Brug
requestsi Python, ikke OpenAI SDK (formatuforenelighed) - Du kan angive op til 5 kildebilleder pr. anmodning
- Prompten beskriver den ønskede modifikation på naturligt sprog
- Begge modeller (Imagine 1.0 og Imagine 2.0) er tilgængelige til redigering; med OpenAI SDK understøttes
images.edit()ikke af xAI: brug xAI SDK eller en HTTP-anmodning