Foinsí Íomhá: URL agus Base64
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026. Bunaithe ar an leathanach Eagarthóireacht Íomhá agus ar an tagairt API Íomhánna xAI: is féidir íomhá foinseach a shonrú freisin ag baint úsáide as
file_idcomhaid san API Comhad, mar rogha eisiach in ionadurl. Foinseí: Eagarthóireacht Íomhá · API Íomhánna.
Íomhánna a Sholáthar don Phointe Deiridh Eagarthóireachta
Glacann an pointe deiridh eagarthóireachta le híomhánna foinseacha i dtrí fhoirm: URL poiblí, URI Sonraí Base64, nó file_id comhaid atá uaslódáilte cheana féin chuig API Comhad xAI. Tá cásanna úsáide ag gach ceann acu; má dhéanann tú máistir orthu, beidh tú in ann píblínte eagarthóireachta solúbtha a thógáil.
Formáid URL
Is é an formáid URL an rogha is áisiúla fad is atá an íomhá ar líne cheana féin: gan aon rud le hionchódú, lóin bheag, agus iarratas a fhanann inléite i logaí. Is é an srian lárnach anseo ná poiblí—caithfidh freastalaithe xAI a bheith in ann an íomhá a fháil gan seisiún ná token.
payload = {
"model": "grok-imagine-image",
"prompt": "Add a gold frame around this image",
"image": {
"url": "https://exemple.com/ma-photo.jpg"
}
}
Srian URL
- Caithfidh an URL a bheith inrochtana go poiblí (gan naisc faoi chosaint fíordheimhniúcháin)
- Is iad JPEG, PNG, agus WebP na formáidí a dtacaítear leo
- Caithfidh an íomhá a bheith inrochtana go tapa (seachain freastalaithe mall)
URLanna Aschuir ón API a Úsáid
Seo an rud a dhéanann eagarthóireacht ilphas praiticiúil: bíonn aschur eagarthóireachta amháin ina ionchur don chéad cheann eile, gan an íomhá a íoslódáil riamh chuig do mheaisín áitiúil. Tá rabhadh amháin ann, áfach—téann na URLanna seo in éag, mar sin caithfidh an slabhra rith in aon turas amháin. Maidir le sruth oibre atá scaipthe thar am, íoslódáil é idir gach céim.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
# Íomhá a ghiniúint
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"]
# An íomhá ghinte a eagarthóireacht
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()
Formáid URI Sonraí Base64
Maidir le híomhánna atá stóráilte go háitiúil nó a ghintear go dinimiciúil, úsáid formáid URI Sonraí Base64:
import base64
# Íomhá áitiúil a léamh
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
}
}
Cathain Base64 a Úsáid?
Tá an critéar simplí: tá Base64 riachtanach nuair a bheadh sé ina chuar gan ghá URL poiblí a úsáid. Baineann sé seo le híomhánna áitiúla nach bhfuil óstáilte in áit ar bith—dá n-uaslódálfá iad chuig freastalaí chun iad a dhéanamh inrochtana don API, chuirfeá céim agus moill leis gan aon luach. Baineann sé freisin le híomhánna a ghintear sa chuimhne ag d’iarratas: cairt a tháirgtear ar an toirt, scáileanghabháil de léiriú, nó mionsamhail a chumtar go dinimiciúil nach gá dóibh teagmháil a dhéanamh leis an diosca riamh. Freagraíonn Base64 ar ábhar imní príobháideachta freisin—ní nochtar íomhá atá ionchódaithe i gcorp an iarrtais ar fhreastalaí poiblí riamh, fiú go sealadach—agus déanann sé an ailtireacht a shimpliú: oibríonn píblíne uathoibrithe a nascann giniúint, eagarthóireacht, agus sábháil ó thús go deireadh gan óstáil idirmheánach a sholáthar, a dhaingniú, agus a ghlanadh.
Bí Airdeallach ar an Méid
Méadaíonn Base64 an lóin thart ar thríú cuid, rud atá neamhbhríoch do mhionsamhail ach a éiríonn suntasach do ghrianghraf il-mheigibheart—amanna uaslódála níos faide agus riosca teorainneacha méid iarratais a shárú. Is é an riail ghinearálta: má tá an íomhá inrochtana ar líne cheana féin, úsáid an URL; má tá sí áitiúil, tá Base64 níos simplí ná í a óstáil don ócáid sin amháin.
An Tríú Rogha: Comhad ón API Comhad
Sonraítear íomhá atá uaslódáilte cheana féin chuig API Comhad xAI trína aitheantóir, in ionad URL. Tá an dá réimse comheisiach: iompraíonn oibiacht image ceachtar url nó file_id.
payload = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"file_id": "file_abc123"}
}
Is é seo an rogha nádúrtha d’íomhá a athúsáidtear thar eagarthóireachtaí iolracha: ní sheoltar ach uair amháin í, agus ní gá di a bheith poiblí.
Feidhm Úsáide
Seo feidhm a láimhseálann an dá fhoirmáid go huathoibríoch:
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}")
Braithfidh an fheidhm seo go huathoibríoch an bhfuil an fhoinse ina URL nó ina conair comhaid áitiúil agus déanfaidh sí formáidiú ar an oibiacht dá réir.
Cleachtas Praicticiúil
Déan tástáil ar an dá fhoirmáid leis an íomhá agus an leid chéanna chun a fhíorú go n-oibríonn an dá bhealach; beidh na híomhánna a thiocfaidh as éagsúil ó rith go rith, cosúil le haon ghiniúint eile:
# Tríd an URL
payload_url = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"url": "https://exemple.com/paysage.jpg"}
}
# Tríd an Base64
payload_b64 = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": prepare_image_source("paysage.jpg")
}
Príomhphointí
- Trí fhoirm ionchuir: URL poiblí, URI Sonraí Base64, nó
file_idón API Comhad - Is féidir le URLanna sealadacha a thugtar ar ais ón API freastal mar fhoinsí eagarthóireachta
- Méadaíonn Base64 méid an lóin thart ar 33%
- Cruthaigh feidhm úsáide chun an dá fhoirmáid a láimhseáil go huathoibríoch
- Caithfidh an URL a bheith inrochtana go poiblí chun oibriú