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

Privremeni URL-ovi i strategije preuzimanja

Lekcija 13 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Rukovanje efemernim generiranim slikama
  2. Problem s privremenim URL-ovima
  3. Strategija 1: Trenutačno preuzimanje
  4. Strategija 2: Korištenje Base64
  5. Strategija 3: Automatska pohrana u oblaku
  6. Strategija 4: Dopusti xAI-u pohranu slike
  7. Robusni pipeline s ponovnim pokušajem
  8. Najbolje prakse
  9. Ključne točke

Lekcija dovršena 3. studenoga 2026. na temelju stranica Image Generation i Imagine outputs od xAI-ja: parametar storage_options zadrž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.

Temp.
Izlazni URL-ovi
b64
Trajna alternativa
+33%
Preopterećenje veličine Base64
30 dana
xAI pohrana ili neograničeno

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_json izbjegava 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