Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Izvori slika: URL i Base64

Lekcija 6 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Dostavljanje slika krajnjoj točki za uređivanje
  2. Format URL-a
  3. Format Base64 Data URI-ja
  4. Treća opcija: Datoteka iz Files API-ja
  5. Pomoćna funkcija
  6. Praktična vježba
  7. Ključne točke

Ažurirano 3. studenog 2026. Na temelju stranice Image Editing i referencije xAI Images API-ja: izvorna slika može se odrediti i pomoću file_id datoteke u Files API-ju, kao isključiva alternativa parametru url. Izvori: Image Editing · Images API.

Dostavljanje slika krajnjoj točki za uređivanje

Krajnja točka za uređivanje (edit endpoint) prihvaća izvorne slike u tri oblika: javni URL, Base64 Data URI ili file_id datoteke koja je već učitana u xAI Files API. Svaki od njih ima svoju primjenu; njihovo savladavanje omogućuje ti izgradnju fleksibilnih pipelineova za uređivanje.

Format URL-a

Format URL-a najpogodnija je opcija sve dok je slika već na internetu: nema kodiranja, mali teret (payload), a zahtjev ostaje čitljiv u zapisnicima (logovima). Ključno ograničenje ovdje je javno—sliku moraju moći dohvatiti poslužitelji tvrtke xAI bez sesije ili tokena.

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

Ograničenja URL-a

  • URL mora biti javno dostupan (bez poveznica zaštićenih autentifikacijom)
  • Podržani formati su JPEG, PNG i WebP
  • Slika mora biti brzo dostupna (izbjegavaj spore poslužitelje)

Korištenje izlaznih URL-ova iz API-ja

Upravo to čini višestruko uređivanje (multi-pass editing) praktičnim: izlaz jednog uređivanja postaje ulaz za sljedeće, bez ikakvog preuzimanja slike na tvoje lokalno računalo. Postoji jedna zamka—ovi URL-ovi istječu, pa se lanac mora izvršiti u jednom potezu. Za radni tijek raspoređen kroz vrijeme, preuzmi sliku između svakog koraka.

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"]

# Uređivanje 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()

Format Base64 Data URI-ja

Za slike pohranjene lokalno ili generirane dinamički koristi format Base64 Data URI:

import base64

# Čitanje 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
    }
}

Kada koristiti Base64?

Kriterij je jednostavan: Base64 je nužan kad bi korištenje javnog URL-a bilo nepotreban zaobilazni put. To se odnosi na lokalne slike koje nisu nigdje hostirane—njihovo učitavanje na poslužitelj samo kako bi bile dostupne API-ju dodaje korak i kašnjenje bez vrijednosti. Također se odnosi na slike generirane u memoriji tvoje aplikacije: grafikon proizveden u letu, snimka zaslona renderiranja ili dinamički sastavljena sličica nikada ne moraju dotaknuti disk. Base64 također rješava problem privatnosti—slika kodirana u tijelu zahtjeva nikada nije izložena na javnom poslužitelju, čak ni privremeno—i pojednostavljuje arhitekturu: automatizirani pipeline koji povezuje generiranje, uređivanje i spremanje radi od kraja do kraja bez potrebe za privremenim hostanjem koje treba postaviti, osigurati i očistiti.

Pazi na veličinu

Base64 povećava veličinu tereta (payloada) za oko trećinu, što je zanemarivo za sličicu, ali postaje značajno za fotografiju od nekoliko megabajta—duža vremena učitavanja i rizik od prekoračenja ograničenja veličine zahtjeva. Pravilo palca: ako je slika već dostupna na internetu, koristi URL; ako je lokalna, Base64 je jednostavniji od njezinog hostiranja samo za tu priliku.

Treća opcija: Datoteka iz Files API-ja

Slika koja je već učitana u xAI Files API određuje se svojim identifikatorom, umjesto URL-om. Ta su dva polja međusobno isključiva: objekt image sadrži ili url ili file_id.

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

Ovo je prirodan izbor za sliku koja se ponovno koristi u više uređivanja: šalje se samo jednom i ne mora biti javna.

Pomoćna funkcija

Evo funkcije koja automatski rukuje oba formata:

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

Ova funkcija automatski detektira je li izvor URL ili putanja do lokalne datoteke te sukladno tome formatira objekt.

Praktična vježba

Testiraj oba formata s istom slikom i upitom kako bi provjerio/la rade li oba puta; rezultirajuće slike varirat će od pokretanja do pokretanja, kao i svako generiranje:

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

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

Ključne točke

  • Tri ulazna oblika: javni URL, Base64 Data URI ili file_id iz Files API-ja
  • Privremeni URL-ovi koje vraća API mogu poslužiti kao izvori za uređivanje
  • Base64 povećava veličinu tereta za ~33%
  • Stvori pomoćnu funkciju za automatsko rukovanje oba formata
  • URL mora biti javno dostupan da bi funkcionirao