URLanna Sealadacha agus Straitéisí Íoslódála
Ar an leathanach seo
Cúrsa críochnaithe ar an 3 Samhain, 2026 bunaithe ar na leathanaigh Image Generation agus Imagine outputs ó xAI: coinníonn an paraiméadar
storage_optionsan íomhá san API Comhad agus is féidir leis URL poiblí buan a chruthú; ní shonraíonn an doiciméadú fad saoil na nURLanna eiféimearacha (ní fheictear na “hearráidí 403 nó 404” ón leagan roimhe seo anseo); aschuirtear íomhánna mar JPEG de réir réamhshocraithe. Foinse: Image Generation · Imagine outputs.
Láimhseáil Íomhánna Ginte Eiféimearacha
Is sealadach iad na URLanna a thugtar ar ais ag an API giniúna agus eagarthóireachta íomhánna: déanann doiciméadú xAI cur síos orthu mar URLanna gearrshaolacha gan a saolré a shonrú, agus iarrann sé ort na híomhánna a íoslódáil nó a phróiseáil gan mhoill. Baineann an srian seo go díreach le do chur chuige maidir le do chuid feidhmchlár a dhearadh.
An Fhadhb le URLanna Sealadacha
Nuair a úsáideann tú response_format="url" (an réamhshocrú), filleann an API URL eiféimearach. Tar éis tréimhse nach bhfuil sonraithe, stopann sé an íomhá a sheirbheáil.
# URL Eiféimearach: íoslódáil gan mhoill
response = client.images.generate(
model="grok-imagine-image",
prompt="Tírdhreach sléibhe"
)
url = response.data[0].url
Toradh: ní féidir leat na URLanna seo a stóráil i mbunachar sonraí agus iad a athúsáid níos déanaí. Caithfidh tú na híomhánna a íoslódáil go córasach.
Straitéis 1: Íoslódáil Láithreach
Is é an straitéis is iontaofa ná gach íomhá a íoslódáil chomh luath agus a ghintear í:
import urllib.request
import os
from datetime import datetime
def generate_and_save(prompt, output_dir="images"):
"""Gineann sé íomhá agus sábhálann sé láithreach í."""
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 de réir réamhshocraithe
urllib.request.urlretrieve(response.data[0].url, filepath)
print(f"Íomhá sábháilte: {filepath}")
return filepath
Straitéis 2: Base64 a Úsáid
Trí fhreagra i bhformáid Base64 a iarraidh, faigheann tú sonraí dénártha na híomhá go díreach, gan brath ar URL sealadach:
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Tírdhreach sléibhe",
response_format="b64_json"
)
# Tá na sonraí sa fhreagra go díreach
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("mountain.jpg", "wb") as f: # JPEG de réir réamhshocraithe
f.write(image_bytes)
Buntáistí Base64
Tagann buntáiste Base64 anuas ar fhocal amháin: neamhspleáchas. Tagann an íomhá go díreach sa fhreagra JSON, gan brath ar URL sealadach a d’fhéadfadh dul in éag sula n-itheann do chód é, agus gan aon iarratas HTTP breise chun é a íoslódáil—ciallaíonn turas líonra amháin níos lú pointe teipthe amháin níos lú i do phíblíne.
Míbhuntáistí Base64
Is meicniúil an malartú: méadaíonn ionchódú Base64 méid na freagra JSON thart ar 33%, rud a chosnaíonn trí huaire ort—i am aistrithe freagra an API, sa chuimhne a úsáidtear ar an gcliant chun é a dhíchódú, agus i gcastacht má láimhseálann tú íomhánna ardtaifigh iolracha san iarratas céanna. Maidir le híomhá aonair, is beag an difríocht; maidir le baisc de dheich n-íomhá 2k, éiríonn an difríocht inbhraite.
Straitéis 3: Stóráil Scamaill Uathoibríoch
Maidir le feidhmchláir táirgeachta, comhcheangail giniúint le huaslódáil chuig do stóráil féin:
import boto3
import urllib.request
import tempfile
def generate_and_upload_s3(prompt, bucket, key):
"""Gineann sé íomhá agus uaslódálann sé go díreach chuig S3 í."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt
)
# Íoslódáil chuig comhad sealadach
with tempfile.NamedTemporaryFile(suffix=".jpg", delete=False) as tmp:
urllib.request.urlretrieve(response.data[0].url, tmp.name)
# Uaslódáil chuig S3
s3 = boto3.client("s3")
s3.upload_file(tmp.name, bucket, key)
permanent_url = f"https://{bucket}.s3.amazonaws.com/{key}"
return permanent_url
Straitéis 4: Ligean do xAI an Íomhá a Stóráil
Glacann gach iarratas Imagine le paraiméadar storage_options a shábhálann an íomhá a tháirgtear in API Comhad do fhoirne, agus is féidir leis URL poiblí buan a chruthú chomh maith, le roinnt nó leabú. Le SDK xAI:
import os
import xai_sdk
client_xai = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))
response = client_xai.image.sample(
prompt="Tírdhreach sléibhe ag éirí na gréine",
model="grok-imagine-image-2.0",
storage_options={"filename": "mountain.jpg", "public_url": True},
)
print(response.file_output.file_id) # aitheantóir cobhsaí san API Comhad
print(response.public_url) # URL poiblí buan
Coinníonn an freagra an URL eiféimearach gnáth agus cuireann sé bloc file_output leis do gach íomhá: file_id, filename, agus, má iarrtar é, public_url. Níl ach filename riachtanach: gan roghanna eile, stóráiltear an íomhá go príobháideach, gan dul in éag ná URL poiblí. Sceidealann expires_after (ó 3,600 soicind go 30 lá) scriosadh an chomhaid, agus glacann public_url lena chuid expires_after féin freisin, nach féidir a bheith níos faide ná saol an chomhaid. Is féidir le foireann suas le 1,000 URL poiblí gníomhach a bheith aici; thairis sin, nó i gcás teagmhais, stóráiltear an íomhá fós agus iompraíonn an freagra public_url_error in ionad an URL. Trí REST, téann an oibiacht storage_options céanna isteach i gcorp an iarratais, lena n-áirítear le haghaidh eagarthóireachta.
Píblíne Láidir le hAthiarracht
Is féidir le URLanna sealadacha teip uaireanta le linn íoslódála. Cuir meicníocht athiarrachta i bhfeidhm:
import time
import urllib.request
import urllib.error
def download_with_retry(url, filepath, max_retries=3):
"""Íoslódálann sé íomhá le hathiarracht i gcás earráide."""
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 # Cúlú easpónantúil
print(f"Theip ar iarracht {attempt + 1}, ag iarraidh arís i {wait_time}s...")
time.sleep(wait_time)
else:
print(f"Theip tar éis {max_retries} iarracht: {e}")
return False
Dea-Chleachtais
Eascraíonn gach disciplín ó fhíric amháin: tá URLanna sealadach. Mar sin, caithfidh íoslódáil teacht díreach i ndiaidh na giniúna, sa sruth cód céanna—is fuinneog é gach nóiméad bearna ina bhféadfadh an íomhá a bheith doshroichte. Ar an gcúis chéanna, níor chóir URL sealadach a stóráil i mbunachar sonraí mar thagairt bhuan: beidh sé marbh faoin gcuardach seo chugainn, agus is cineál fabht é seo nach dtagann chun solais ach i dtáirgeadh, laethanta ina dhiaidh sin. I bhfeidhmchláir chriticiúla ina dtagann iontaofacht ar dtús, seachain an fhadhb le b64_json, a sheachadann an íomhá sa fhreagra, nó le storage_options, a choinníonn í ag xAI le haithneoir cobhsaí.
Is oibríocht líonra gnáth é an t-íoslódáil féin: athiarracht le cúlú chun teipeanna sealadacha a mhaolú, ainmniú comhad de réir stampa ama nó aitheantóra uathúil chun imbhualaidh a sheachaint nuair a ritheann giniúintí iolracha go comhthreomhar. Ar deireadh, déan logáil ar mheiteashonraí—leid, samhaltóir, paraiméadair—le gach íomhá shábháilte: sé mhí ina dhiaidh sin, nuair a bheidh ort radharc amháin “cosúil leis sin ach i 2k” a athghiniúint, beidh an loga seo luachmhar.
Príomhphointí
- Tá URLanna aschuir sealadach: íoslódáil láithreach
- Seachnaíonn an fhormáid
b64_jsonfadhb an URL eiféimeraigh - Méadaíonn Base64 méid na freagra thart ar 33%
- Cuir athiarracht le cúlú easpónantúil i bhfeidhm le haghaidh iontaofachta
- I dtáirgeadh, uaslódáil chuig stóráil bhuan (S3, GCS), nó lig do xAI an íomhá a stóráil le
storage_options