Billedkilder: URL og Base64
På denne side
Opdateret 3. november 2026. Baseret på siden Image Editing og xAI Images API-referencen: Et kildebillede kan også specificeres ved hjælp af
file_idfor en fil i Files API’en som et eksklusivt alternativ tilurl. Kilder: Image Editing · Images API.
Sådan leverer du billeder til edit-endpointet
Edit-endpointet accepterer kildebilleder i tre former: en offentlig URL, en Base64 Data URI eller file_id for en fil, der allerede er uploadet til xAI Files API. Hver har sine anvendelsestilfælde; når du mestrer dem, kan du bygge fleksible redigeringspipelines.
URL-format
URL-formatet er den mest bekvemme løsning, så længe billedet allerede er online: ingen kodning nødvendig, en lille payload, og en anmodning, der forbliver læsbar i logfiler. Den afgørende begrænsning her er offentlig – billedet skal kunne hentes af xAI-servere uden en session eller token.
payload = {
"model": "grok-imagine-image",
"prompt": "Add a gold frame around this image",
"image": {
"url": "https://exemple.com/ma-photo.jpg"
}
}
Begrænsninger for URL
- URL’en skal være offentligt tilgængelig (ingen links beskyttet af godkendelse)
- Understøttede formater er JPEG, PNG og WebP
- Billedet skal være hurtigt tilgængeligt (undgå langsomme servere)
Brug af output-URL’er fra API’en
Dette er det, der gør multi-pass-redigering praktisk: outputtet fra én redigering bliver inputtet til den næste, uden at du nogensinde downloader billedet til din lokale maskine. Der er dog et forbehold: disse URL’er udløber, så kæden skal køres i ét hug. Til en arbejdsgang, der strækker sig over tid, skal du downloade det mellem hvert trin.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
# Generer et billede
gen_response = requests.post(
"https://api.x.ai/v1/images/generations",
headers=headers,
json={
"model": "grok-imagine-image",
"prompt": "A medieval castle on a hill"
}
).json()
generated_url = gen_response["data"][0]["url"]
# Rediger det genererede billede
edit_response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json={
"model": "grok-imagine-image",
"prompt": "Add a dragon flying over the castle",
"image": {"url": generated_url}
}
).json()
Base64 Data URI-format
Til billeder, der er gemt lokalt eller genereres dynamisk, skal du bruge Base64 Data URI-formatet:
import base64
# Læs et lokalt billede
with open("photo_locale.jpg", "rb") as f:
image_bytes = f.read()
b64_string = base64.b64encode(image_bytes).decode("utf-8")
data_uri = f"data:image/jpeg;base64,{b64_string}"
payload = {
"model": "grok-imagine-image",
"prompt": "Transform this photo into a vector illustration",
"image": {
"url": data_uri
}
}
Hvornår skal du bruge Base64?
Kriteriet er simpelt: Base64 er nødvendigt, når det ville være en unødvendig omvej at bruge en offentlig URL. Dette gælder for lokale billeder, der ikke er hostet nogen steder – at uploade dem til en server blot for at gøre dem tilgængelige for API’en tilføjer et trin og en forsinkelse uden værdi. Det gælder også billeder, der genereres i hukommelsen af din applikation: et diagram produceret på farten, et screenshot af en rendering eller et dynamisk sammensat thumbnail behøver aldrig at røre disken. Base64 løser også et privatlivsproblem – et billede kodet i anmodningsbody’en eksponeres aldrig på en offentlig server, selv ikke midlertidigt – og forenkler arkitekturen: en automatiseret pipeline, der kæder generering, redigering og lagring sammen, fungerer ende-til-ende uden mellemhosting, der skal klargøres, sikres og ryddes op.
Pas på størrelsen
Base64 oppuster payloaden med cirka en tredjedel, hvilket er ubetydeligt for et thumbnail, men bliver betydeligt for et foto på flere megabyte – længere uploadtider og en risiko for at overskride grænser for anmodningsstørrelse. Tommelfingerreglen er: Hvis billedet allerede er tilgængeligt online, så brug URL’en; hvis det er lokalt, er Base64 enklere end at hoste det blot for lejligheden.
Tredje mulighed: En fil fra Files API’en
Et billede, der allerede er uploadet til xAI Files API, specificeres ved hjælp af dets identifikator i stedet for en URL. De to felter er gensidigt udelukkende: et image-objekt indeholder enten url eller file_id.
payload = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"file_id": "file_abc123"}
}
Dette er det naturlige valg for et billede, der genbruges på tværs af flere redigeringer: det sendes kun én gang, og det behøver ikke være offentligt.
Hjælpefunktion
Her er en funktion, der håndterer begge formater automatisk:
import base64
import os
def prepare_image_source(source):
"""Prepares an image source for the API (URL or local file)."""
if source.startswith("http://") or source.startswith("https://"):
return {"url": source}
if os.path.isfile(source):
ext = source.rsplit(".", 1)[-1].lower()
mime_map = {"jpg": "jpeg", "jpeg": "jpeg", "png": "png", "webp": "webp"}
mime_type = mime_map.get(ext, "jpeg")
with open(source, "rb") as f:
b64 = base64.b64encode(f.read()).decode("utf-8")
return {"url": f"data:image/{mime_type};base64,{b64}"}
raise ValueError(f"Invalid source: {source}")
Denne funktion registrerer automatisk, om kilden er en URL eller en lokal filsti, og formaterer objektet derefter.
Praktisk øvelse
Test begge formater med samme billede og prompt for at verificere, at begge veje fungerer; de resulterende billeder vil variere fra kørsel til kørsel, ligesom enhver anden generering:
# Via URL
payload_url = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"url": "https://exemple.com/paysage.jpg"}
}
# Via Base64
payload_b64 = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": prepare_image_source("paysage.jpg")
}
Vigtige pointer
- Tre inputformer: offentlig URL, Base64 Data URI eller
file_idfra Files API’en - Midlertidige URL’er returneret af API’en kan fungere som kilder til redigering
- Base64 øger payload-størrelsen med ca. 33 %
- Opret en hjælpefunktion til automatisk at håndtere begge formater
- URL’en skal være offentligt tilgængelig for at fungere