Izvori slika: URL i Base64
Na ovoj stranici
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_iddatoteke u Files API-ju, kao isključiva alternativa parametruurl. 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_idiz 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