xAI: Grok Imagine Image 2.0

Το Grok Imagine Image 2.0 δημιουργεί εικόνες από γραπτές περιγραφές και επεξεργάζεται υπάρχουσες εικόνες με οδηγίες σε φυσική γλώσσα. Η xAI τεκμηριώνει ρυθμίσεις ποιότητας, ανάλυσης και σύνθεσης, τη χρήση πολλών εικόνων αναφοράς, τη μεταφορά ύφους και τη σταδιακή βελτίωση.

Ailoot Ultra · Εικόνες POST /v1/images/generations x-ai/grok-imagine-image-2.0

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το Grok Imagine Image 2.0 είναι το μοντέλο δημιουργίας και επεξεργασίας εικόνων της xAI. Δέχεται μια γραπτή περιγραφή ή μια περιγραφή μαζί με εικόνες προέλευσης και επιστρέφει μια εικόνα ως αποτέλεσμα. Το προφίλ του δημιουργού με την ονομασία 2.0 καλύπτει τη δημιουργία σκηνών, την αλλαγή υπάρχουσας εικόνας, τον συνδυασμό θεμάτων από εικόνες αναφοράς και τη μεταμόρφωση του οπτικού ύφους. Ξεκινήστε επιλέγοντας αν χρειάζεστε μια νέα σύνθεση ή μια συγκεκριμένη αλλαγή σε υλικό που έχετε ήδη.

Δημιουργία εικόνας από μια περιγραφή

Περιγράψτε το κύριο θέμα, το περιβάλλον του, τη σύνθεση, τον φωτισμό και την οπτική απόδοση. Προσδιορίστε τι πρέπει να προσέξει πρώτα ο θεατής και πού θα χρησιμοποιηθεί η εικόνα. Για μια ιδέα προϊόντος, μια ενδεικτική περιγραφή μπορεί να περιλαμβάνει ένα κεραμικό φωτιστικό γραφείου πάνω σε τραπέζι από ανοιχτόχρωμη πέτρα, απαλό φως από παράθυρο, κοντινή λήψη του υλικού και ελεύθερο χώρο για μια ξεχωριστή επικεφαλίδα. Για μια εικονογράφηση, καθορίστε τους χαρακτήρες, τη δράση και την επιθυμητή αισθητική αντί να περιμένετε ότι μία μόνο λέξη ύφους θα ορίσει ολόκληρη τη σκηνή.

Ο δημιουργός τεκμηριώνει από μία έως δέκα εικόνες εξόδου ανά αίτημα δημιουργίας, με προεπιλογή τη μία. Πολλά αποτελέσματα από την ίδια περιγραφή προσφέρουν εναλλακτικές για αξιολόγηση· δεν εγγυώνται πανομοιότυπο θέμα σε κάθε παραλλαγή. Ελέγξτε το θέμα, τη σύνθεση και τις σημαντικές λεπτομέρειες και κρατήστε την εκδοχή που ανταποκρίνεται καλύτερα στην περιγραφή. Φυλάξτε μαζί την περιγραφή και την επιλεγμένη παραλλαγή, ώστε οι επόμενες επεξεργασίες να χρησιμοποιούν την επιθυμητή σύνθεση.

Σύνθεση, ανάλυση και ποιότητα

Ο οδηγός δημιουργίας τεκμηριώνει αυτόματη επιλογή αναλογίας διαστάσεων ή ρητό ορισμό της. Οι αναφερόμενες επιλογές περιλαμβάνουν τις 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 και 5:2. Επιλέξτε το σχήμα με βάση τη θέση χρήσης: τετράγωνο για ένα συμπαγές πλακίδιο, κατακόρυφο για μια όρθια σύνθεση ή οριζόντιο για μια πλατιά σκηνή. Προσδιορίστε το θέμα που μπορεί να επηρεαστεί από την περικοπή και τον χώρο που χρειάζεται η διάταξη, αντί να βασίζεστε μόνο στην αναλογία διαστάσεων.

Οι τεκμηριωμένες ρυθμίσεις ανάλυσης δημιουργίας είναι 1k και 2k, με προεπιλογή το 1k. Η ποιότητα αποτελεί ξεχωριστή ρύθμιση με επιλογές low, medium και auto. Στον τρέχοντα οδηγό της xAI, το auto είναι η προεπιλογή και χρησιμοποιεί low για τη δημιουργία και medium για την επεξεργασία· μια ρητή ρύθμιση low ή medium διατηρεί σταθερή την αντίστοιχη επιλογή. Επομένως, η ανάλυση και η ποιότητα περιγράφουν διαφορετικές ρυθμίσεις. Δηλώστε τις οπτικές λεπτομέρειες που έχουν σημασία και εξετάστε τις στην εικόνα που επιστρέφεται, αντί να θεωρείτε ότι οποιαδήποτε από τις δύο ρυθμίσεις εγγυάται ακριβή γράμματα, γεωμετρία ή διατήρηση του θέματος.

Επεξεργασία και μεταφορά οπτικού ύφους

Δώστε την εικόνα που θέλετε να αλλάξετε και περιγράψτε τη ζητούμενη αλλαγή σε σχέση με το ορατό περιεχόμενό της. Μια στοχευμένη επεξεργασία μπορεί να ζητά την αντικατάσταση ενός σκούρου τοίχου με ανοιχτόχρωμη επιφάνεια σοβά, διατηρώντας τη διάταξη των επίπλων, την οπτική γωνία της κάμερας και τον θερμό φωτισμό. Αν ο στόχος είναι μια μεταμόρφωση ύφους, προσδιορίστε την επιθυμητή απόδοση: ο δημιουργός παρουσιάζει παραδείγματα φωτογραφίας, anime, ελαιογραφίας, ακουαρέλας, pop art και σκίτσου με μολύβι. Προσδιορίστε ποια στοιχεία πρέπει να διατηρήσουν την εμφάνισή τους και ποια μπορούν να αλλάξουν μαζί με την απόδοση.

Η ροή επεξεργασίας του δημιουργού δέχεται αναφορά σε εικόνα προέλευσης, κωδικοποιημένα δεδομένα εικόνας ή αναγνωριστικό αρχείου. Για αποθηκευμένες αναφορές, χρησιμοποιήστε εικόνες PNG, JPEG ή WebP των οποίων η μεταφόρτωση έχει ολοκληρωθεί. Ο οδηγός του τεκμηριώνει επίσης διαδοχικές επεξεργασίες: χρησιμοποιήστε το αποτέλεσμα μιας επεξεργασίας ως είσοδο για την επόμενη. Έτσι, μια βασική σύνθεση μπορεί να μετατραπεί σε πιο συγκεκριμένο αποτέλεσμα με μια αλλαγή επίπλων και κατόπιν μια προσαρμογή φωτισμού. Κρατήστε την αρχική και την επιλεγμένη ενδιάμεση εικόνα συνδεδεμένες με κάθε περιγραφή, ώστε μια μεταγενέστερη βελτίωση να μπορεί να ελεγχθεί ως προς την επιθυμητή σύνθεση.

Συνδυασμός πολλών εικόνων αναφοράς

Ο τρέχων οδηγός για πολλές εικόνες επιτρέπει έως πέντε εικόνες προέλευσης σε μία επεξεργασία. Αναφερθείτε σε αυτές με τη σειρά που δόθηκαν και αναθέστε σε καθεμία σαφή ρόλο, όπως το θέμα από την πρώτη εικόνα και το περιβάλλον από τη δεύτερη. Η αναλογία του αποτελέσματος ακολουθεί από προεπιλογή την πρώτη εικόνα εισόδου, ενώ υπάρχει δυνατότητα ρητής επιλογής άλλης αναλογίας. Για μια απεικόνιση προϊόντος μέσα σε δωμάτιο, περιγράψτε τη θέση, το μέγεθος και την επαφή του προϊόντος με τις επιφάνειες του δωματίου και ζητήστε να διατηρηθούν οι λεπτομέρειες που το ταυτοποιούν. Εξετάστε πώς συνδυάστηκαν οι εικόνες προέλευσης αντί να υποθέτετε ότι κάθε στοιχείο αντιγράφηκε χωρίς αλλαγές.

Παραλαβή και διατήρηση της εικόνας

Ο δημιουργός επιστρέφει από προεπιλογή μια προσωρινή διεύθυνση εικόνας και τεκμηριώνει επίσης έξοδο με κωδικοποιημένη εικόνα. Αποθηκεύστε έγκαιρα την ίδια την εικόνα όταν τη χρειάζεστε ως υλικό. Η προαιρετική αναβαλλόμενη ροή διαχωρίζει την επιβεβαίωση λήψης του αιτήματος από την ολοκλήρωση: ένα αναγνωριστικό αιτήματος ακολουθείται από κατάσταση pending, done ή failed, και τα αναβαλλόμενα αποτελέσματα χρησιμοποιούν τη μορφή απάντησης με διεύθυνση, με τεκμηριωμένη περίοδο διατήρησης 24 ωρών. Ένα υποβληθέν αίτημα ή μια κατάσταση pending δεν αποτελεί ολοκληρωμένη εικόνα. Φυλάξτε την ολοκληρωμένη εικόνα μαζί με την περιγραφή και τις επιλεγμένες ρυθμίσεις για μελλοντική επαναχρησιμοποίηση.

Ένα χρήσιμο τελικό παραδοτέο είναι μια εικόνα που ταιριάζει σε μια καθορισμένη σκηνή, διάταξη ή περιγραφή επεξεργασίας. Εξετάστε ολόκληρη τη σύνθεση και τις μικρές λεπτομέρειές της, ιδίως το θέμα προέλευσης, τα όρια των αντικειμένων, τις αναλογίες και κάθε κείμενο που μεταφέρει νόημα. Για διαδοχικές βελτιώσεις, αλλάξτε την οδηγία που σχετίζεται με το ορατό πρόβλημα και χρησιμοποιήστε το επιλεγμένο αποτέλεσμα ως επόμενη αναφορά. Διατυπώστε συγκεκριμένα την επιθυμητή τροποποίηση και τις οδηγίες διατήρησης, ώστε κάθε αποτέλεσμα να μπορεί να αξιολογηθεί ως προς έναν συγκεκριμένο δημιουργικό σκοπό.

Ailoot Ultra · Εικόνες POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Εισαγωγή

Αποδεκτές είσοδοι: Κείμενο · Εικόνες
Αποτελέσματα: Εικόνες

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Εικόνες POST /v1/images/generations

Είσοδος: text, image
Έξοδος: image

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια x-ai/grok-imagine-image-2.0	Προεπιλογή—
Πεδίο`prompt`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Ελάχιστο μήκος: 1	Προεπιλογή—
Πεδίο`resolution`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια 1K, 2K	Προεπιλογή—
Πεδίο`aspect_ratio`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto	Προεπιλογή—
Πεδίο`quality`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια low, medium	Προεπιλογή—
Πεδίο`n`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 1	Προεπιλογή—
Πεδίο`input_references`	Τύπος`array`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 3	Προεπιλογή—
Πεδίο`provider`	Τύπος`object`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια	Προεπιλογή—

Παράμετροι και κύκλος ζωής μεθόδου

Παράμετρος	Σύμβαση
Παράμετρος`content_type`	Σύμβασηapplication/json
Παράμετρος`required`	Σύμβασηmodel, prompt
Παράμετρος`material_types`	Σύμβασηtext, image

Κύκλος ζωής: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Το πραγματικό task_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Τιμολόγηση

Πώς υπολογίζεται η τελική χρέωση

Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.

Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.

Γρήγορη λειτουργία: Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
Λειτουργία flex: Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
Μέγιστη προσπάθεια συλλογισμού: Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default

Εκτιμώμενες χρεώσεις για σύγκριση

Τιμές ανά διαμόρφωση

Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.

Διαμόρφωση	Πίνακας χρεώσεων	Προβλεπόμενη ποσότητα	Μονάδα τιμολόγησης	Χρέωση
ΔιαμόρφωσηΒασικές χρεώσεις token	Πίνακας χρεώσεωνΒασική χρέωση	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησης—	Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token
Διαμόρφωσηεικόνα εισόδου	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά εικόνα εισόδου	Χρέωση Είσοδος · εικόνα εισόδου · Εκτίμηση μόνο για σύγκριση $0.02 ανά εικόνα εισόδου
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.08 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Παραδείγματα αιτημάτων

Ailoot Ultra · Εικόνες

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Λήψη και αποθήκευση αποτελεσμάτων

Ailoot Ultra · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Άλλες ανακτήσεις περιεχομένου

Ανάκτηση υπαρχόντων αρχείων που σας ανήκουν

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.

Αν χρειάζεται έλεγχος της αρχικής απάντησης

Διατηρήστε το X-Client-Request-ID που επιστράφηκε για τη συμφωνία των εγγραφών. Διαβάστε μόνο πραγματικές τιμές task_id/asset_id που επιστράφηκαν ή τη βιβλιοθήκη πολυμέσων που σας ανήκει· μην κατασκευάσετε ποτέ URL εργασίας από το ID της λειτουργίας και μην υποβάλετε ποτέ ξανά αίτημα δημιουργίας.

Πεδία απάντησης

Πεδίο	Τύπος
Πεδίο`created`	Τύπος
Πεδίο`data[].url`	Τύπος
Πεδίο`data[].b64_json`	Τύπος
Πεδίο`usage`	Τύπος

Εναλλακτικά ονόματα

Εναλλακτικά ονόματα μοντέλου

Ailoot Ultra x-ai/grok-imagine-image-2.0

Εναλλακτικές διαδρομές μεθόδων

/v1/images

Σχετικά ID μοντέλων

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Ποιες είσοδοι και αποτελέσματα διατίθενται;: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Ποια πεδία χρησιμοποιεί το αίτημα;: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Ποια όρια ισχύουν;: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0