Πηγές Εικόνων: URL και Base64
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση τη σελίδα Image Editing και την αναφορά API Εικόνων της xAI: μια εικόνα προέλευσης μπορεί επίσης να καθοριστεί χρησιμοποιώντας το
file_idενός αρχείου στο Files API, ως αποκλειστική εναλλακτική λύση στοurl. Πηγές: Image Editing · Images API.
Παροχή Εικόνων στο Endpoint Επεξεργασίας
Το endpoint επεξεργασίας δέχεται εικόνες προέλευσης σε τρεις μορφές: ένα δημόσιο URL, ένα Data URI Base64 ή το file_id ενός αρχείου που έχει ήδη μεταφορτωθεί στο Files API της xAI. Κάθε μία έχει τις δικές της περιπτώσεις χρήσης· η εξοικείωσή σας με αυτές σας επιτρέπει να δημιουργήσετε ευέλικτες ροές εργασίας επεξεργασίας.
Μορφή URL
Η μορφή URL είναι η πιο βολική επιλογή, εφόσον η εικόνα βρίσκεται ήδη online: δεν απαιτείται κωδικοποίηση, το ωφέλιμο φορτίο είναι ελάχιστο και το αίτημα παραμένει ευανάγνωστο στα αρχεία καταγραφής (logs). Ο βασικός περιορισμός εδώ είναι η δημοσιότητα· η εικόνα πρέπει να είναι ανακτήσιμη από τους διακομιστές της xAI χωρίς session ή token.
payload = {
"model": "grok-imagine-image",
"prompt": "Add a gold frame around this image",
"image": {
"url": "https://exemple.com/ma-photo.jpg"
}
}
Περιορισμοί URL
- Το URL πρέπει να είναι δημόσια προσβάσιμο (όχι συνδέσμοι που προστατεύονται από πιστοποίηση)
- Οι υποστηριζόμενες μορφές είναι JPEG, PNG και WebP
- Η εικόνα πρέπει να είναι άμεσα προσβάσιμη (αποφύγετε τους αργούς διακομιστές)
Χρήση URLs Εξόδου από το API
Αυτό είναι που καθιστά πρακτική την επεξεργασία πολλαπλών περασμάτων: η έξοδος μιας επεξεργασίας γίνεται η είσοδος για την επόμενη, χωρίς ποτέ να χρειάζεται να κατεβάσετε την εικόνα στον τοπικό σας υπολογιστή. Μια προσοχή ωστόσο· αυτά τα URLs λήγουν, οπότε η αλυσίδα πρέπει να εκτελεστεί μονομιάς. Για μια ροή εργασίας απλωμένη στον χρόνο, κατεβάστε την μεταξύ κάθε βήματος.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
# Δημιουργία μιας εικόνας
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"]
# Επεξεργασία της δημιουργηθείσας εικόνας
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()
Μορφή Data URI Base64
Για εικόνες αποθηκευμένες τοπικά ή δημιουργημένες δυναμικά, χρησιμοποιήστε τη μορφή Data URI Base64:
import base64
# Ανάγνωση μιας τοπικής εικόνας
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
}
}
Πότε να χρησιμοποιήσετε Base64;
Το κριτήριο είναι απλό: το Base64 είναι απαραίτητο όποτε η χρήση ενός δημόσιου URL θα αποτελούσε περιττή παράκαμψη. Αυτό ισχύει για τοπικές εικόνες που δεν φιλοξενούνται πουθενά· η μεταφόρτωσή τους σε έναν διακομιστή απλώς για να γίνουν προσβάσιμες στο API προσθέτει ένα βήμα και καθυστέρηση χωρίς αξία. Ισχύει επίσης για εικόνες που δημιουργούνται στη μνήμη από την εφαρμογή σας: ένα διάγραμμα που παράγεται εν κινήσει, ένα στιγμιότυπο οθόνης μιας απόδοσης ή μια δυναμικά συντιθέμενη μικρογραφία δεν χρειάζεται ποτέ να αγγίξουν τον δίσκο. Το Base64 αντιμετωπίζει επίσης ένα ζήτημα απορρήτου· μια εικόνα κωδικοποιημένη στο σώμα του αιτήματος δεν εκτίθεται ποτέ σε δημόσιο διακομιστή, έστω και προσωρινά· και απλοποιεί την αρχιτεκτονική: μια αυτοματοποιημένη ροή εργασίας που συνδέει τη δημιουργία, την επεξεργασία και την αποθήκευση λειτουργεί από άκρη σε άκρη χωρίς ενδιάμεση φιλοξενία για προμήθεια, ασφάλιση και καθαρισμό.
Προσοχή στο Μέγεθος
Το Base64 αυξάνει το ωφέλιμο φορτίο κατά περίπου το ένα τρίτο, κάτι που είναι αμελητέο για μια μικρογραφία αλλά γίνεται σημαντικό για μια φωτογραφία πολλών megabyte· μεγαλύτεροι χρόνοι μεταφόρτωσης και κίνδυνος υπέρβασης των ορίων μεγέθους αιτήματος. Ο κανόνας: αν η εικόνα είναι ήδη προσβάσιμη online, χρησιμοποιήστε το URL· αν είναι τοπική, το Base64 είναι απλούστερο από το να τη φιλοξενήσετε μόνο για την περίσταση.
Τρίτη Επιλογή: Ένα Αρχείο από το Files API
Μια εικόνα που έχει ήδη μεταφορτωθεί στο Files API της xAI καθορίζεται από το αναγνωριστικό της, αντί για ένα URL. Τα δύο πεδία είναι αμοιβαία αποκλειόμενα: ένα αντικείμενο image φέρει είτε url είτε file_id.
payload = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"file_id": "file_abc123"}
}
Αυτή είναι η φυσική επιλογή για μια εικόνα που επαναχρησιμοποιείται σε πολλαπλές επεξεργασίες: στέλνεται μόνο μία φορά και δεν χρειάζεται να είναι δημόσια.
Συνάρτηση Βοηθείας
Ορίστε μια συνάρτηση που χειρίζεται και τις δύο μορφές αυτόματα:
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}")
Αυτή η συνάρτηση εντοπίζει αυτόματα αν η πηγή είναι URL ή τοπική διαδρομή αρχείου και διαμορφώνει το αντικείμενο ανάλογα.
Πρακτική Εξάσκηση
Δοκιμάστε και τις δύο μορφές με την ίδια εικόνα και prompt για να επαληθεύσετε ότι και οι δύο διαδρομές λειτουργούν· οι προκύπτουσες εικόνες θα διαφέρουν από εκτέλεση σε εκτέλεση, όπως σε κάθε δημιουργία:
# Μέσω URL
payload_url = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": {"url": "https://exemple.com/paysage.jpg"}
}
# Μέσω Base64
payload_b64 = {
"model": "grok-imagine-image",
"prompt": "Add snow to the landscape",
"image": prepare_image_source("paysage.jpg")
}
Βασικά σημεία
- Τρεις μορφές εισόδου: δημόσιο URL, Data URI Base64 ή
file_idαπό το Files API - Τα προσωρινά URLs που επιστρέφονται από το API μπορούν να λειτουργήσουν ως πηγές επεξεργασίας
- Το Base64 αυξάνει το μέγεθος του ωφέλιμου φορτίου κατά ~33%
- Δημιουργήστε μια συνάρτηση βοηθείας για τον αυτόματο χειρισμό και των δύο μορφών
- Το URL πρέπει να είναι δημόσια προσβάσιμο για να λειτουργήσει