Sorsi tal-Immaġni: URL u Base64
F'din il-paġna
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_idta’ fajl fl-API tal-Fajls, bħala alternattiva esklussiva għalurl. 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_idmill-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