Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Endpoint /v1/images/generations: Ξεκινώντας

Μάθημα 1 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Αρχάριος
Σε αυτήν τη σελίδα
  1. Δημιουργήστε την πρώτη σας εικόνα με το Grok API
  2. Δομή ενός αιτήματος δημιουργίας
  3. Παράμετροι αιτήματος
  4. Μορφή απόκρισης
  5. Πρακτική Εξάσκηση
  6. Βασικά σημεία

Μάθημα ολοκληρώθηκε στις 3 Νοεμβρίου 2026 με βάση τη σελίδα Image Generation και την αναφορά API εικόνων xAI: προεπιλεγμένες τιμές (aspect_ratio ορισμένο σε auto, resolution σε 1k), παράμετρος quality για το Imagine 2.0, και JPEG ως προεπιλεγμένη μορφή. Πηγές: Image Generation · Images API.

Δημιουργήστε την πρώτη σας εικόνα με το Grok API

Εικόνα που δημιουργήθηκε από το Grok Το API της xAI προσφέρει ένα αφιερωμένο endpoint για τη δημιουργία εικόνων: POST /v1/images/generations. Αυτό το endpoint σας επιτρέπει να δημιουργείτε εικόνες από μια περιγραφή κειμένου χρησιμοποιώντας τα μοντέλα Grok Imagine. Είτε θέλετε να παράγετε εικονογραφήσεις, οπτικό υλικό μάρκετινγκ ή δημιουργικά πρωτότυπα, όλα ξεκινούν από αυτό το endpoint.

Σε αυτό το μάθημα, θα μάθετε πώς να δομείτε ένα αίτημα δημιουργίας εικόνας και να κατανοείτε τις θεμελιώδεις παραμέτρους.

1
Endpoint Δημιουργίας
2
Διαθέσιμα Μοντέλα
10
Μέγιστος Αριθμός Εικόνων ανά Αίτημα
2k
Μέγιστη Ανάλυση

Δομή ενός αιτήματος δημιουργίας

Δύο παράμετροι αρκούν για τη δημιουργία μιας εικόνας: το μοντέλο και το 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, δείτε το μάθημα 12
  • response_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