Privremeni URL-ovi i strategije preuzimanja
Na ovoj stranici
Lekcija dovršena 3. studenoga 2026. na temelju stranica Image Generation i Imagine outputs od xAI-ja: parametar
storage_optionszadržava sliku u Files API-ju i može stvoriti trajni javni URL; dokumentacija ne specificira vijek trajanja efemernih URL-ova (greške „403 ili 404“ iz prethodne verzije ovdje se ne pojavljuju); slike se prema zadanim postavkama isporučuju kao JPEG. Izvori: Image Generation · Imagine outputs.
Rukovanje efemernim generiranim slikama
URL-ovi koje vraćaju API-ji za generiranje i uređivanje slika su privremeni: dokumentacija xAI-ja opisuje ih kao kratkotrajne, no ne specificira njihovo trajanje, te traži da slike preuzmeš ili obradiš bez odgađanja. Ovo ograničenje izravno utječe na način na koji dizajniraš svoje aplikacije.
Problem s privremenim URL-ovima
Kada koristiš response_format="url" (zadana postavka), API vraća efemerni URL. Nakon neodređenog razdoblja, on prestaje služiti sliku.
# Efemerni URL: preuzmi bez odgađanja
response = client.images.generate(
model="grok-imagine-image",
prompt="A mountain landscape"
)
url = response.data[0].url
Posljedica: ne možeš pohraniti ove URL-ove u bazu podataka i kasnije ih ponovno koristiti. Slike moraš sustavno preuzimati.
Strategija 1: Trenutačno preuzimanje
Najpouzdanija strategija je preuzimanje svake slike čim se generira:
import urllib.request
import os
from datetime import datetime
def generate_and_save(prompt, output_dir="images"):
"""Generira sliku i odmah je sprema."""
os.makedirs(output_dir, exist_ok=True)
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt
)
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
filepath = os.path.join(output_dir, f"gen_{timestamp}.jpg") # JPEG prema zadanim postavkama
urllib.request.urlretrieve(response.data[0].url, filepath)
print(f"Slika spremljena: {filepath}")
return filepath
Strategija 2: Korištenje Base64
Zahtjevom odgovora u Base64 formatu, primaš binarne podatke slike izravno, bez oslanjanja na privremeni URL:
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="A mountain landscape",
response_format="b64_json"
)
# Podaci su izravno u odgovoru
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("mountain.jpg", "wb") as f: # JPEG prema zadanim postavkama
f.write(image_bytes)
Prednosti Base64
Prednost Base64 svodi se na jednu riječ: autonomija. Slika stiže izravno u JSON odgovoru, bez oslanjanja na privremeni URL koji bi mogao isteći prije nego što ga tvoj kod iskoristi, i bez dodatnog HTTP zahtjeva za preuzimanje – jedan mrežni zahtjev manje znači jednu točku kvara manje u tvom pipelineu.
Nedostaci Base64
Kompromis je mehanički: Base64 kodiranje povećava JSON odgovor za oko 33%, što te košta na tri načina – u vremenu prijenosa odgovora API-ja, u memoriji koju klijent troši za dekodiranje i u složenosti ako manipuliraš više slika visoke rezolucije u istom zahtjevu. Za pojedinačnu sliku to je zanemarivo; za šaržu od deset 2k slika, razlika postaje opipljiva.
Strategija 3: Automatska pohrana u oblaku
Za produkcijske aplikacije kombiniraj generiranje s prijenosom u tvoju pohranu:
import boto3
import urllib.request
import tempfile
def generate_and_upload_s3(prompt, bucket, key):
"""Generira sliku i izravno je prenosi na S3."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt
)
# Preuzmi u privremenu datoteku
with tempfile.NamedTemporaryFile(suffix=".jpg", delete=False) as tmp:
urllib.request.urlretrieve(response.data[0].url, tmp.name)
# Prenesi na S3
s3 = boto3.client("s3")
s3.upload_file(tmp.name, bucket, key)
permanent_url = f"https://{bucket}.s3.amazonaws.com/{key}"
return permanent_url
Strategija 4: Dopusti xAI-u pohranu slike
Svaki Imagine zahtjev prihvaća parametar storage_options koji sprema proizvedenu sliku u Files API tvog tima i može dodatno stvoriti trajni javni URL za dijeljenje ili ugradnju. Uz xAI SDK:
import os
import xai_sdk
client_xai = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))
response = client_xai.image.sample(
prompt="A mountain landscape at sunrise",
model="grok-imagine-image-2.0",
storage_options={"filename": "mountain.jpg", "public_url": True},
)
print(response.file_output.file_id) # stabilni identifikator u Files API-ju
print(response.public_url) # trajni javni URL
Odgovor zadržava uobičajeni efemerni URL i dodaje, za svaku sliku, blok file_output: file_id, filename i, ako je zatraženo, public_url. Samo je filename obavezan: bez drugih opcija, slika se pohranjuje privatno, bez isteka ili javnog URL-a. expires_after (od 3.600 sekundi do 30 dana) planira brisanje datoteke, a public_url također prihvaća vlastiti expires_after, koji ne smije premašiti onaj datoteke. Tim može imati do 1.000 aktivnih javnih URL-ova; iznad toga, ili u slučaju incidenta, slika je i dalje pohranjena, a odgovor nosi public_url_error umjesto URL-a. Putem REST-a, isti objekt storage_options ide u tijelo zahtjeva, uključujući i za uređivanje.
Robusni pipeline s ponovnim pokušajem
Privremeni URL-ovi ponekad mogu failati tijekom preuzimanja. Implementiraj mehanizam ponovnog pokušaja:
import time
import urllib.request
import urllib.error
def download_with_retry(url, filepath, max_retries=3):
"""Preuzima sliku s ponovnim pokušajem u slučaju greške."""
for attempt in range(max_retries):
try:
urllib.request.urlretrieve(url, filepath)
return True
except urllib.error.URLError as e:
if attempt < max_retries - 1:
wait_time = 2 ** attempt # Eksponencijalno povlačenje
print(f"Pokušaj {attempt + 1} nije uspio, ponovni pokušaj za {wait_time}s...")
time.sleep(wait_time)
else:
print(f"Neuspjeh nakon {max_retries} pokušaja: {e}")
return False
Najbolje prakse
Sva disciplina proizlazi iz jedne činjenice: URL-ovi su privremeni. Preuzimanje stoga mora odmah uslijediti nakon generiranja, u istom toku koda – svaka minuta razmaka je prozor u kojem slika može postati nedohvatljiva. Iz istog razloga, privremeni URL nikada se ne smije pohraniti u bazu podataka kao trajna referenca: bit će mrtav do sljedećeg upita, a ovo je vrsta greške koja se pojavljuje tek u produkciji, danima kasnije. U kritičnim aplikacijama gdje je pouzdanost na prvom mjestu, zaobiđi problem s b64_json, koji isporučuje sliku u odgovoru, ili s storage_options, koji je zadržava kod xAI-ja sa stabilnim identifikatorom.
Samo preuzimanje zaslužuje tretman kao normalna mrežna operacija: ponovni pokušaj s povlačenjem (backoff) za apsorpciju prolaznih grešaka, imenovanje datoteka po vremenskoj oznaci ili jedinstvenom identifikatoru kako bi se izbjegli sukobi kada se paralelno izvodi više generiranja. Naposljetku, bilježi metapodatke – prompt, model, parametre – uz svaku spremljenu sliku: za šest mjeseci, kada budeš trebao regenerirati vizual „poput onoga, ali u 2k“, ovaj zapis bit će neprocjenjiv.
Ključne točke
- Izlazni URL-ovi su privremeni: preuzmi odmah
- Format
b64_jsonizbjegava problem efemernog URL-a - Base64 povećava veličinu odgovora za ~33%
- Implementiraj ponovni pokušaj s eksponencijalnim povlačenjem za robusnost
- U produkciji, prenesi u trajnu pohranu (S3, GCS) ili dopusti xAI-u pohranu slike putem
storage_options