Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Endpoint /v1/images/edits: Redigér dine billeder

Lektion 5 af 14 Opdateret 2. november 2026 Begynder
På denne side
  1. Billedredigering med Grok API
  2. Struktur på en redigeringsanmodning
  3. Hvorfor bruge requests i stedet for OpenAI SDK?
  4. Parametre til redigeringsendpointen
  5. Typer af mulige redigeringer
  6. Praktisk øvelse
  7. Vigtige pointer

Opdateret 2. november 2026 — Imagine. grok-imagine-image-quality blev fjernet den 2. november 2026 (dens anmodninger betjenes nu af Imagine 2.0 med low kvalitet): eksemplerne bruger nu grok-imagine-image (Imagine 1.0) og grok-imagine-image-2.0 (Imagine 2.0, med low, medium eller auto kvalitet). Med OpenAI SDK sendes aspect_ratio, resolution og quality via extra_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.

5
Maks. kildebilleder
2
Inputformater
JSON
Påkrævet Content-Type
∞
Redigeringsrunder

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) eller grok-imagine-image-2.0 (Imagine 2.0, som også accepterer quality)
  • prompt (påkrævet): beskrivelse af den modifikation, der skal anvendes
  • image: objekt indeholdende URL’en til et enkelt kildebillede
  • images: array af objekter til flere kildebilleder (gensidigt udelukkende med image)
  • mask: objekt indeholdende URL’en til masken for det område, der skal redigeres
  • n: antal varianter, der skal genereres (1 til 10)
  • response_format: url eller b64_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 requests i 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