Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Sorsi tal-Immaġni: URL u Base64

Lezzjoni 6 / 14 Aġġornat 3 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Kif Tipprovdi Immaġni lill-Endpoint tal-Editjar
  2. Il-Format URL
  3. Il-Format Data URI Base64
  4. It-Tielet Għażla: Fajl mill-API tal-Fajls
  5. Funzjoni ta’ Utilità
  6. Prattika Manwali
  7. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026. Ibbażat fuq il-paġna Image Editing u r-referenza tal-API tal-Immaġni ta’ xAI: immaġni sors tista’ tiġi speċifikata wkoll bl-użu tal-file_id ta’ fajl fl-API tal-Fajls, bħala alternattiva esklussiva għal url. Sorsi: Image Editing · Images API.

Kif Tipprovdi Immaġni lill-Endpoint tal-Editjar

L-endpoint tal-editjar jaċċetta immaġni sors f’tliet forom: URL pubbliku, Data URI Base64, jew il-file_id ta’ fajl diġà ttellgħa fl-API tal-Fajls ta’ xAI. Kull waħda għandha l-użi tagħha; li tgħallimhom tippermettilek tibni pipelines ta’ editjar flessibbli.

Il-Format URL

Il-format URL huwa l-għażla l-aktar konvenjenti sakemm l-immaġni diġà tkun online: xejn biex tikkodifika, payload żgħir ħafna, u talba li tibqa’ leġibbli fil-logs. Il-vinċolu ewlieni hawnhekk huwa pubbliku—l-immaġni trid tkun tista’ tiġi rkuprata mis-servers ta’ xAI mingħajr sessjoni jew token.

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

Vinċoli tal-URL

  • L-URL irid ikun aċċessibbli pubblikament (ebda link protett b’awtentikazzjoni)
  • Il-formati appoġġjati huma JPEG, PNG, u WebP
  • L-immaġni trid tkun aċċessibbli malajr (evita servers bil-mod)

L-Użu ta’ URLs tal-Output mill-API

Dan huwa dak li jagħmel l-editjar multi-pass prattiku: l-output ta’ editjar isir l-input għall-ieħor, mingħajr qatt ma tniżżel l-immaġni fuq il-magna lokali tiegħek. Madankollu, hemm avviż—dawn l-URLs jiskadu, allura l-katina trid tiġi eżegwita f’daqqa waħda. Għal workflow mifrux fuq iż-żmien, niżżilha bejn kull pass.

import requests
import os

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

# Iġġenera immaġni
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"]

# Editja l-immaġni ġġenerata
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()

Il-Format Data URI Base64

Għal immaġni maħżuna lokalment jew ġġenerata dinamikament, uża l-format Data URI Base64:

import base64

# Aqra immaġni lokali
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
    }
}

Meta Tuża Base64?

Il-kriterju huwa sempliċi: Base64 huwa meħtieġ kull meta l-użu ta’ URL pubbliku jkun devjazzjoni mhux meħtieġa. Dan japplika għal immaġni lokali li mhumiex ospitati mkien—li ttellgħhom fuq server biss biex isiru aċċessibbli għall-API jżid pass u dewmien mingħajr valur. Japplika wkoll għal immaġni ġġenerati fil-memorja mill-applikazzjoni tiegħek: grafiku prodott malajr, screenshot ta’ render, jew thumbnail komposta dinamikament qatt m’għandhom bżonn jmissu d-diska. Base64 jindirizza wkoll tħassib dwar il-privatezza—immaġni kkodifikata fil-korp tat-talba qatt ma tkun esposta fuq server pubbliku, anke temporanjament—u jissimplifika l-arkitettura: pipeline awtomatizzata li tgħaqqad il-ġenerazzjoni, l-editjar u s-salvataġġ taħdem minn tarf għal tarf mingħajr hosting intermedjarju biex tipprovdi, tissekkurizza u tnaddaf.

Ara d-Daqs

Base64 jkabbar il-payload b’madwar terz, li huwa negliġibbli għal thumbnail iżda jsir sinifikanti għal ritratt ta’ diversi megabytes—ħinijiet itwal ta’ upload u riskju li taqbeż il-limiti tad-daqs tat-talba. Ir-regola bażika: jekk l-immaġni diġà hija aċċessibbli online, uża l-URL; jekk hija lokali, Base64 huwa aktar sempliċi milli tospitaha biss għall-okkażjoni.

It-Tielet Għażla: Fajl mill-API tal-Fajls

Immaġni diġà ttellgħet fl-API tal-Fajls ta’ xAI tiġi speċifikata bl-identifikatur tagħha, minflok URL. Iż-żewġ oqsma huma esklużivi reċiprokament: oġġett image iġorr jew url jew file_id.

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

Din hija l-għażla naturali għal immaġni użata mill-ġdid f’diversi editjar: tintbagħat darba biss, u m’għandhiex għalfejn tkun pubblika.

Funzjoni ta’ Utilità

Hawnhekk hemm funzjoni li tittratta ż-żewġ formati awtomatikament:

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

Din il-funzjoni tiskopri awtomatikament jekk is-sorsx huwiex URL jew mogħdija ta’ fajl lokali u tiffurmata l-oġġett skont dan.

Prattika Manwali

Ittestja ż-żewġ formati bl-istess immaġni u prompt biex tivverifika li t-toroq kollha jaħdmu; l-immaġni riżultanti se jvarjaw minn ġirja għall-oħra, bħal kull ġenerazzjoni:

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

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

Punti Ewlenin

  • Tliet forom ta’ input: URL pubbliku, Data URI Base64, jew file_id mill-API tal-Fajls
  • URLs temporanji rritornati mill-API jistgħu jservu bħala sorsi għall-editjar
  • Base64 iżid id-daqs tal-payload b’~33%
  • Oħloq funzjoni ta’ utilità biex tittratta ż-żewġ formati awtomatikament
  • L-URL irid ikun aċċessibbli pubblikament biex jaħdem