Μετάβαση στο περιεχόμενο

Mage API · Μοντέλο εικόνας

Grok Image API

Grok Imagine, σε τρία επίπεδα ποιότητας

POST https://api.mage.space/v1/grok_image/generate

Με μια ματιά

Το Grok Image API τρέχει το Grok Image Quality και άλλες 2 παραλλαγές μέσω του Mage στο POST https://api.mage.space/v1/grok_image/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 75 Gems (περίπου $0.075), χωρίς συνδρομή. Το Grok Image δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.

  • ΕικόναΈξοδος
  • 3Παραλλαγές
  • 75Gems ανά εικόνα, προεπιλογή
  • $0.075Περίπου, σε USD

Επισκόπηση

Τι κάνει το Grok Image API

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

Τα μοντέλα εικόνας Grok Imagine της xAI σε τρία επίπεδα ποιότητας, για δημιουργία και επεξεργασία από εικόνες αναφοράς. Ισχύει το φίλτρο ασφαλείας της xAI.

Δέχεται ως εισόδους τα image, additional_images.

Γρήγορη εκκίνηση

Κάλεσε το Grok Image API

Όρισε το MAGE_API_KEY, στείλε αίτημα στο /grok_image/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί το αίτημα.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "grok-imagine-image-quality"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('grok_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'grok-imagine-image-quality',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "grok-imagine-image-quality",
})

print(request["result"]["url"])

Μοντέλα

Τιμές model_id για το Grok Image

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityΝαι
grok-imagine-image-2.0Grok Image 2.0

Επιλογές

Παράμετροι του Grok Image

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
aspect_ratio1: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
resolution1k, 2k

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Grok Image

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.

Περισσότερα μοντέλα εικόνας

Άλλα API δημιουργίας εικόνων στο Mage

  • Εικόνα · από 37 Gems

    Guava API

    Φωτορεαλισμός που περνά για φωτογραφία

  • Εικόνα · από 20 Gems

    HiDream API

    Γρήγορο και ευέλικτο, με αρνητικά prompt

  • Εικόνα · από 20 Gems

    Krea 2 API

    Εντυπωσιακή αισθητική σε δευτερόλεπτα

  • Εικόνα · από 135 Gems

    Mango API

    Η κορυφαία οικογένεια μοντέλων εικόνας μας

  • Εικόνα · από 51 Gems

    Nano Banana 2 API

    Καθαρό, ευανάγνωστο κείμενο, έως 4K

  • Εικόνα · από 15 Gems

    SDXL Plus API

    SDXL με διορθωμένα πρόσωπα και χέρια

Συχνές ερωτήσεις

Συχνές ερωτήσεις

Πόσο κοστίζει το Grok Image API;
Ένα αίτημα Grok Image με τις προεπιλεγμένες ρυθμίσεις (Grok Image Quality) κοστίζει 75 Gems, περίπου $0.075. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση αναφέρει την ακριβή χρέωση. Μια δημιουργία που αποτυγχάνει επιστρέφεται, ενώ όση μπλοκάρεται από την πολιτική περιεχομένου του Mage δεν επιστρέφεται.
Ποιο είναι το endpoint του Grok Image API;
POST https://api.mage.space/v1/grok_image/generate με header Authorization: Bearer που περιέχει το κλειδί API σου για το Mage. Η απάντηση περιλαμβάνει ένα status_url για να ελέγχεις το αποτέλεσμα.
Ποια μοντέλα Grok Image μπορώ να καλέσω;
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Το προεπιλεγμένο είναι το Grok Image Quality.
Υποστηρίζει το Grok Image εικόνες αναφοράς ή χαρακτήρες;
Το Grok Image δέχεται image, additional_images. Το Grok Image δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.
Μπορώ να χρησιμοποιήσω το Grok Image από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή MCP του Mage με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτησε το Grok Image με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και σου λέει την τιμή πριν δημιουργήσει.
Για πόσο διατηρούνται τα αποτελέσματα του Grok Image;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

Ξεκίνα να δημιουργείς με το Mage

Ένας λογαριασμός, ένα υπόλοιπο Gems, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.