Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Viri slik: URL in Base64

Lekcija 6 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Posredovanje slik končni točki za urejanje
  2. Oblika URL
  3. Oblika podatkovnega URI Base64
  4. Tretja možnost: Datoteka iz Files API
  5. Pomožna funkcija
  6. Praktična vaja
  7. Ključne ugotovitve

Posodobljeno 3. novembra 2026. Na podlagi strani Image Editing in referenčne dokumentacije xAI Images API: izvorno sliko lahko določite tudi z uporabo file_id datoteke v Files API, kot izključno alternativo parametru url. Viri: Image Editing · Images API.

Posredovanje slik končni točki za urejanje

Končna točka za urejanje (edit endpoint) sprejema izvorne slike v treh oblikah: javni URL, podatkovni URI Base64 ali file_id datoteke, ki je že naložena v xAI Files API. Vsaka ima svojo uporabo; obvladovanje teh možnosti ti omogoča gradnjo prilagodljivih cevovodov za urejanje.

Oblika URL

Oblika URL je najpriročnejša možnost, dokler je slika že na spletu: ničesar ni treba kodirati, paket podatkov je majhen in zahtevek ostane berljiv v dnevnikih. Ključna omejitev tukaj je javni dostop – sliko morajo strežniki xAI pridobiti brez seje ali žetona.

payload = {
    "model": "grok-imagine-image",
    "prompt": "Add a gold frame around this image",
    "image": {
        "url": "https://exemple.com/ma-photo.jpg"
    }
}

Omejitve URL-ja

  • URL mora biti javno dostopen (brez povezav, zaščitenih z avtentikacijo)
  • Podprte oblike so JPEG, PNG in WebP
  • Do slike mora biti mogoče hitro dostopati (izogibaj se počasnim strežnikom)

Uporaba izhodnih URL-jev iz API-ja

To je tisto, kar omogoča praktično večstopenjsko urejanje: izhod ene operacije urejanja postane vhod za naslednjo, ne da bi kdaj koli prenesel sliko na svoj lokalni stroj. Vendar obstaja ena past – ti URL-ji potečejo, zato mora veriga opravil teči v enem kosu. Za delovni tok, razporejen skozi čas, sliko med vsakim korakom prenesi.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

# Generiranje slike
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"]

# Urejanje generirane slike
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()

Oblika podatkovnega URI Base64

Za slike, shranjene lokalno ali generirane dinamično, uporabi obliko podatkovnega URI Base64:

import base64

# Branje lokalne slike
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
    }
}

Kdaj uporabiti Base64?

Merilo je preprosto: Base64 je nujen, kadar bi bila uporaba javnega URL-ja nepotreben ovinek. To velja za lokalne slike, ki niso gostowane nikjer – njihovo nalaganje na strežnik zgolj zato, da postanejo dostopne API-ju, doda korak in zamudo brez vrednosti. Velja tudi za slike, ki jih tvoja aplikacija generira v pomnilniku: grafikon, ustvarjen sproti, posnetek zaslona upodabljanja ali dinamično sestavljena sličica se nikoli ne dotaknejo diska. Base64 rešuje tudi težavo zasebnosti – slika, kodirana v telesu zahtevka, nikoli ni izpostavljena na javnem strežniku, niti začasno – in poenostavlja arhitekturo: avtomatiziran cevovod, ki veriži generiranje, urejanje in shranjevanje, deluje od začetka do konca brez vmesnega gostovanja, ki bi ga bilo treba zagotoviti, zavarovati in počistiti.

Pozori na velikost

Base64 poveča velikost paketa podatkov za približno tretjino, kar je za sličico zanemarljivo, pri večmegabajtni fotografiji pa postane pomembno – daljši časi nalaganja in tveganje prekoračitve omejitev velikosti zahtevka. Zlato pravilo: če je slika že dostopna na spletu, uporabi URL; če je lokalna, je Base64 preprostejši od gostovanja zgolj za to priložnost.

Tretja možnost: Datoteka iz Files API

Slika, ki je že naložena v xAI Files API, je določena z njenim identifikatorjem namesto z URL-jem. Obe polji se medsebojno izključujeta: objekt image vsebuje bodisi url bodisi file_id.

payload = {
    "model": "grok-imagine-image",
    "prompt": "Add snow to the landscape",
    "image": {"file_id": "file_abc123"}
}

To je naravna izbira za sliko, ki se ponovno uporabi pri več urejanjih: poslana je le enkrat in ne mora biti javna.

Pomožna funkcija

Tukaj je funkcija, ki samodejno obravnava obe obliki:

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}")

Ta funkcija samodejno zazna, ali je vir URL ali pot do lokalne datoteke, in ustrezno oblikuje objekt.

Praktična vaja

Preizkusi obe obliki z isto sliko in pozivom, da preveriš, ali obe poti delujeta; dobljene slike se bodo med posameznimi zagoni razlikovale, kot pri vsakem generiranju:

# Prek URL-ja
payload_url = {
    "model": "grok-imagine-image",
    "prompt": "Add snow to the landscape",
    "image": {"url": "https://exemple.com/paysage.jpg"}
}

# Prek Base64
payload_b64 = {
    "model": "grok-imagine-image",
    "prompt": "Add snow to the landscape",
    "image": prepare_image_source("paysage.jpg")
}

Ključne ugotovitve

  • Tri vhodne oblike: javni URL, podatkovni URI Base64 ali file_id iz Files API
  • Začasni URL-ji, ki jih vrne API, lahko služijo kot viri za urejanje
  • Base64 poveča velikost paketa podatkov za ~33 %
  • Ustvari pomožno funkcijo za samodejno obravnavo obeh oblik
  • URL mora biti javno dostopen, da deluje