Endpoint /v1/images/generations: Ξεκινώντας
Σε αυτήν τη σελίδα
Μάθημα ολοκληρώθηκε στις 3 Νοεμβρίου 2026 με βάση τη σελίδα Image Generation και την αναφορά API εικόνων xAI: προεπιλεγμένες τιμές (
aspect_ratioορισμένο σεauto,resolutionσε1k), παράμετροςqualityγια το Imagine 2.0, και JPEG ως προεπιλεγμένη μορφή. Πηγές: Image Generation · Images API.
Δημιουργήστε την πρώτη σας εικόνα με το Grok API
Το API της xAI προσφέρει ένα αφιερωμένο endpoint για τη δημιουργία εικόνων: POST /v1/images/generations. Αυτό το endpoint σας επιτρέπει να δημιουργείτε εικόνες από μια περιγραφή κειμένου χρησιμοποιώντας τα μοντέλα Grok Imagine. Είτε θέλετε να παράγετε εικονογραφήσεις, οπτικό υλικό μάρκετινγκ ή δημιουργικά πρωτότυπα, όλα ξεκινούν από αυτό το endpoint.
Σε αυτό το μάθημα, θα μάθετε πώς να δομείτε ένα αίτημα δημιουργίας εικόνας και να κατανοείτε τις θεμελιώδεις παραμέτρους.
Δομή ενός αιτήματος δημιουργίας
Δύο παράμετροι αρκούν για τη δημιουργία μιας εικόνας: το μοντέλο και το prompt. Όλες οι υπόλοιπες έχουν προεπιλεγμένες τιμές, γεγονός που σας επιτρέπει να λάβετε ένα πρώτο αποτέλεσμα σε τρεις γραμμές κώδικα—και αυτό ακριβώς πρέπει να κάνετε πριν διαβάσετε τη συνέχεια, ώστε να έχετε μπροστά σας μια εικόνα στην οποία θα συσχετίσετε κάθε παράμετρο.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.images.generate(
model="grok-imagine-image",
prompt="A Breton lighthouse under a starry sky, watercolor style"
)
image_url = response.data[0].url
print(image_url)
Το API της xAI είναι συμβατό με το OpenAI SDK για τη δημιουργία εικόνων: ορίζετε το base_url στο https://api.x.ai/v1, παρέχετε το κλειδί xAI και ο υπόλοιπος κώδικάς σας παραμένει αμετάβλητος. Να έχετε υπόψη σας το εύρος αυτής της συμβατότητας—ισχύει για τη δημιουργία, αλλά όχι για την επεξεργασία, η οποία αναμένει διαφορετική μορφή. Το Μάθημα 5 καλύπτει αυτό το θέμα.
Παράμετροι αιτήματος
Ακολουθούν οι παράμετροι που μπορείτε να συμπεριλάβετε στο αίτημά σας:
model: το μοντέλο δημιουργίας προς χρήση (grok-imagine-imageήgrok-imagine-image-2.0, δείτε το μάθημα 2)prompt: η περιγραφή κειμένου της επιθυμητής εικόναςn: ο αριθμός των εικόνων προς δημιουργία (1 έως 10, προεπιλογή: 1)aspect_ratio: η αναλογία διαστάσεων της εικόνας (autoως προεπιλογή: το μοντέλο επιλέγει βάσει του prompt)resolution: η ανάλυση (1kως προεπιλογή, ή2k)quality:low,medium, ήauto(προεπιλογή) στο Imagine 2.0, δείτε το μάθημα 12response_format:url(προεπιλογή) ήb64_jsonγια λήψη της εικόνας σε Base64
Παράδειγμα με όλες τις παραμέτρους
response = client.images.generate(
model="grok-imagine-image",
prompt="An enchanted forest with fireflies, digital art style",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Μορφή απόκρισης
Η απόκριση είναι πάντα ένας πίνακας, ακόμη και για μία μόνο εικόνα—κάντε επανάληψη σε αυτόν αντί να διαβάζετε απευθείας το data[0], διαφορετικά ο κώδικάς σας θα αποτύχει την ημέρα που θα ορίσετε n=4. Κάθε αντικείμενο περιέχει:
url: το προσωρινό URL της εικόνας (αν τοresponse_formatείναιurl)b64_json: τα δεδομένα Base64 της εικόνας (αν τοresponse_formatείναιb64_json)
Ο τύπος MIME που επιστρέφεται μπορεί να είναι image/png, image/jpeg, ή image/webp· ως προεπιλογή είναι image/jpeg, εκτός εάν μια ρύθμιση ποιότητας παράγει PNG.
Πρακτική Εξάσκηση
Δοκιμάστε να δημιουργήσετε την πρώτη σας εικόνα προσαρμόζοντας το prompt στο επαγγελματικό σας πλαίσιο. Για παράδειγμα, για ένα οπτικό στοιχείο παρουσίασης:
response = client.images.generate(
model="grok-imagine-image",
prompt="Minimalist chart showing startup growth, "
"blue and white colors, dark background, flat design style",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Βασικά σημεία
- Το endpoint δημιουργίας είναι το
POST /v1/images/generations - Δύο παράμετροι αρκούν για να ξεκινήσετε:
modelκαιprompt - Το API είναι συμβατό με το Python SDK της OpenAI αλλάζοντας το
base_url - Μπορείτε να δημιουργήσετε έως και 10 εικόνες ανά αίτημα
- Οι διαθέσιμες αναλύσεις είναι
1k(προεπιλογή) και2k