Avoti attēliem: URL un Base64
Šajā lapā
Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz Attēlu rediģēšana lapu un xAI attēlu API atsauces dokumentāciju: avota attēlu var norādīt arī, izmantojot faila
file_idno Files API, kā ekskluzīvu alternatīvuurl. Avoti: Attēlu rediģēšana · Attēlu API.
Attēlu nodrošināšana rediģēšanas galapunktam
Rediģēšanas galapunkts pieņem avota attēlus trīs formātos: publisku URL, Base64 datu URI vai jau xAI Files API augšupielādēta faila file_id. Katram ir savs pielietojums; apgūstot tos, tu vari izveidot elastīgas rediģēšanas darbplūsmas.
URL formāts
URL formāts ir ērtākais variants, ja attēls jau ir tiešsaistē: nekas nav jākodē, datu pakeste ir maza, un pieprasījums palasa lasāms žurnālos. Galvenais ierobežojums šeit ir publiskums — attēlam jābūt pieejamam xAI serveriem bez sesijas vai pilnvarojuma žetona.
payload = {
"model": "grok-imagine-image",
"prompt": "Add a gold frame around this image",
"image": {
"url": "https://exemple.com/ma-photo.jpg"
}
}
URL ierobežojumi
- URL ir jābūt publiski pieejamam (nav saites, kas aizsargātas ar autentifikāciju)
- Atbalstītie formāti ir JPEG, PNG un WebP
- Attēlam ir jābūt ātri pieejamam (izvairies no lēniem serveriem)
API atgrieztu izejas URL izmantošana
Tieši tas padara daudzkārtēju rediģēšanu praktisku: vienas rediģēšanas rezultāts kļūst par nākamās ievadi, nekad nenolaižot attēlu lokālajā datorā. Tomēr ir viens nosacījums — šie URL ir derīgi tikai īsu brīdi, tāpēc ķēdei ir jāizpildās vienā piegājienā. Ja darbplūsma ir izstiepta laikā, nolaid attēlu starp katru soli.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
# Ģenerē attēlu
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"]
# Rediģē ģenerēto attēlu
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()
Base64 datu URI formāts
Attēliem, kas glabājas lokāli vai tiek ģenerēti dinamiski, izmanto Base64 datu URI formātu:
import base64
# Nolasa lokālu attēlu
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
}
}
Kad lietot Base64?
Kritērijs ir vienkāršs: Base64 ir nepieciešams, kad publiska URL izmantošana būtu lieks aplis. Tas attiecas uz lokāliem attēliem, kas nekur nav mitināti — to augšupielāde serverī, lai padarītu tos pieejamus API, pievieno soli un aizkavi bez vērtības. Tas attiecas arī uz attēliem, ko tava lietotne ģenerē atmiņā: dinamiski izveidots grafiks, rendera ekrānuzņēmums vai dinamiski komponēta sīktēla attēls nekad nepieskaras diskam. Base64 risina arī privātuma jautājumu — pieprasījuma ķermenī kodēts attēls nekad netiek eksponēts publiskā serverī, pat uz īsu brīdi — un vienkāršo arhitektūru: automatizēta darbplūsma, kas ķēdē ģenerēšanu, rediģēšanu un saglabāšanu, strādā no gala līdz galam bez starpmītņa, kas jānodrošina, jāaizsargā un jātīra.
Uzmanies ar izmēru
Base64 palielina datu paketes apjomu par aptuveni trešdaļu, kas sīktēlam ir niecīgi, bet daudzu megabaitu fotoattēlam kļūst nozīmīgi — ilgāks augšupielādes laiks un risks pārsniegt pieprasījuma izmēra limitus. Likumsakarība: ja attēls jau ir pieejams tiešsaistē, izmanto URL; ja tas ir lokāls, Base64 ir vienkāršāks nekā tā mitināšana tikai šim gadījumam.
Trešais variants: fails no Files API
Attēls, kas jau ir augšupielādēts xAI Files API, tiek norādīts ar tā identifikatoru, nevis URL. Abi lauki ir savstarpēji izslēdzoši: image objekts satur vai nu url, vai file_id.
payload = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"file_id": "file_abc123"}
}
Tas ir dabiskais izvēles variants attēlam, ko atkārtoti izmanto vairākās rediģēšanas reizēs: tas tiek nosūtīts tikai vienreiz, un tam nav jābūt publiskam.
Utilītfunkcija
Lūk funkcija, kas automātiski apstrādā abus formātus:
import base64
import os
def prepare_image_source(source):
"""Sagatavo attēla avotu API (URL vai lokāls fails)."""
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}")
Šī funkcija automātiski noteic, vai avots ir URL vai lokāla faila ceļš, un atbilstoši noformē objektu.
Praktisks uzdevums
Pārbaudi abus formātus ar vienu un to pašu attēlu un uzdevumu, lai pārliecinātos, ka abi ceļi strādā; iegūtie attēli katrā reizē atšķirsies, tāpat kā jebkura ģenerēšana:
# Caur URL
payload_url = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"url": "https://exemple.com/paysage.jpg"}
}
# Caur Base64
payload_b64 = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": prepare_image_source("paysage.jpg")
}
Galvenās atziņas
- Trīs ievades formāti: publisks URL, Base64 datu URI vai
file_idno Files API - API atgrieztos pagaidu URL var izmantot kā rediģēšanas avotus
- Base64 palielina datu paketes apjomu par ~33%
- Izveido utilītfunkciju, lai automātiski apstrādātu abus formātus
- URL ir jābūt publiski pieejamam, lai tas strādātu