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

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

Z-Image API

Το ταχύτερο μοντέλο εικόνας στο Mage

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

Με μια ματιά

Το Z-Image API εκτελεί το Z-Image μέσω του Mage στο POST https://api.mage.space/v1/z_image/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 10 Gems (περίπου $0,01), χωρίς συνδρομή. Το Z-Image δεν δέχεται αναφορές @handle.

  • ΕικόναΈξοδος
  • 1Παραλλαγή
  • 10Gems ανά εικόνα, προεπιλογή
  • $0.01Περίπου, σε USD

Επισκόπηση

Τι κάνει το Z-Image API

Αστραπιαίο και οικονομικό σε Gems. Φωτορεαλιστικό text-to-image με σωστή ανατομία και καθαρά γράμματα, έως 2K· χωρίς εικόνες αναφοράς.

Το ταχύτερο μοντέλο εικόνας στο Mage: φωτορεαλιστικό text-to-image με σωστή ανατομία και γράμματα, σε 1K ή 2K.

Δημιουργεί μόνο από το prompt.

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

Κάλεσε το Z-Image API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_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": "4:5",
  "model_id": "z-image-turbo"
}' | 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('z_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'z-image-turbo',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("z_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "z-image-turbo",
})

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

Μοντέλα

Τιμές model_id του Z-Image

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

model_idΌνομαΠροεπιλογή
z-image-turboZ-ImageΝαι

Επιλογές

Παράμετροι του Z-Image

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

ΠεδίοΤιμές
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

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

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

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

    Anima API

    Φτιαγμένο ειδικά για anime

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

    Chroma API

    Ανοιχτά βάρη, βασισμένο στο Flux

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

    Flux 2 API

    Μεγάλα prompt και επεξεργασίες με πολλαπλές αναφορές

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

    GPT Image 2 API

    Ακριβή prompt και ευανάγνωστο κείμενο

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

    Grok Image API

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

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

    Guava API

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

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

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

Πόσο κοστίζει το Z-Image API;
Ένα αίτημα Z-Image με τις προεπιλεγμένες ρυθμίσεις (Z-Image) κοστίζει 10 Gems, περίπου $0,01. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση αναφέρει την ακριβή χρέωση. Μια δημιουργία που αποτυγχάνει επιστρέφεται· όσες μπλοκάρονται από την πολιτική περιεχομένου του Mage δεν επιστρέφονται.
Ποιο είναι το endpoint του Z-Image API;
POST https://api.mage.space/v1/z_image/generate με κεφαλίδα Authorization: Bearer που περιέχει το κλειδί API σου για το Mage. Η απάντηση περιλαμβάνει ένα status_url για να ελέγχεις περιοδικά το αποτέλεσμα.
Ποια μοντέλα Z-Image μπορώ να καλέσω;
z-image-turbo (Z-Image). Η προεπιλογή είναι το Z-Image.
Το Z-Image υποστηρίζει εικόνες αναφοράς ή Characters;
Το Z-Image δεν δέχεται εικόνες, βίντεο ή ήχο ως είσοδο. Το Z-Image δεν δέχεται αναφορές @handle.
Μπορώ να χρησιμοποιήσω το Z-Image από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή Mage MCP με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Z-Image με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και σου λέει την τιμή πριν δημιουργήσει.
Για πόσο διάστημα διατηρούνται τα αποτελέσματα του Z-Image;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

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

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