Μετάβαση στο περιεχόμενο
PlaygroundΤεκμηρίωσηΑπόκτησε κλειδί API

Mage API · Δημιουργία εικόνων

Το API δημιουργίας εικόνων με τεχνητή νοημοσύνη για κάθε μοντέλο

Κείμενο σε εικόνα, επεξεργασία εικόνας και συνεπείς χαρακτήρες από 15 μοντέλα, μεταξύ των οποίων το Mango 3, το κορυφαίο μοντέλο του Mage, με ένα κλειδί και ένα υπόλοιπο.

Απόκτησε κλειδί APIΔιάβασε την τεκμηρίωση του API
POST https://api.mage.space/v1/{model}/generate

Με μια ματιά

Το API δημιουργίας εικόνων του Mage είναι ένα REST API στο https://api.mage.space/v1 που τρέχει 15 μοντέλα κειμένου σε εικόνα και επεξεργασίας εικόνας, όπως τα Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 και Krea 2. Στέλνεις με POST ένα prompt στο /{model}/generate, ελέγχεις το αίτημα και κατεβάζεις την εικόνα. Κάθε εικόνα πληρώνεται με Gems, χωρίς συνδρομή.

  • 15μοντέλα εικόνας
  • $0.009Φθηνότερη προεπιλογή, ανά εικόνα
  • 20Ταυτόχρονες δημιουργίες
  • $0Μηνιαία χρέωση

Μοντέλα

Όλα τα μοντέλα εικόνας στο Mage API

Οι τιμές είναι ανά δημιουργία, σε Gems. 1.000 Gems κοστίζουν $1 στο τυπικό πακέτο και τα μεγαλύτερα πακέτα προσθέτουν bonus Gems. Η τιμή εξαρτάται από το μοντέλο, την ανάλυση και τη διάρκεια· εμφανίζεται η τιμή με τις προεπιλεγμένες ρυθμίσεις και κάθε απόκριση δείχνει την ακριβή χρέωση στο billing.gems_charged. Μια δημιουργία που αποτυγχάνει επιστρέφεται· μια δημιουργία που μπλοκάρεται από την πολιτική περιεχομένου του Mage δεν επιστρέφεται.

ΜοντέλοΙδανικό γιαΤιμές model_idΠροεπιλεγμένη τιμή
AnimaΦτιαγμένο ειδικά για animeanima-v120 Gems ($0.02)
ChromaOpen-weights, βασισμένο στο Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Μεγάλα prompts και επεξεργασίες με πολλές αναφορέςflux2-dev40 Gems ($0.04)
GPT Image 2Ακριβή prompts και ευανάγνωστο κείμενοgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine, σε τρία επίπεδα ποιότηταςgrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
GuavaΦωτορεαλισμός που περνάει για φωτογραφίαguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamΓρήγορο και ευέλικτο, με αρνητικά promptshidream-fast20 Gems ($0.02)
Krea 2Εκπληκτική αισθητική σε δευτερόλεπταkrea-2-turbo20 Gems ($0.02)
MangoΗ κορυφαία οικογένεια μοντέλων εικόνας μαςmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo135 Gems ($0.135)
Nano Banana 2Καθαρό, ευανάγνωστο κείμενο, έως 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL με διορθωμένα πρόσωπα και χέρια6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
Stable Diffusion v1.5Το κλασικό, με οικονομικό κόστος15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeΤο Stable Diffusion που ακούει καλύτεραsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL βελτιστοποιημένο για φωτορεαλισμό6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageΤο πιο γρήγορο μοντέλο εικόνας στο Magez-image-turbo10 Gems ($0.01)

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

Δημιούργησε μια εικόνα με το Anima v1

Όρισε το MAGE_API_KEY, υπέβαλε το αίτημα και έλεγχε μέχρι να ολοκληρωθεί. Αντικατέστησε το anima στο URL με οποιοδήποτε μοντέλο παραπάνω.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Πώς λειτουργεί

Από το κλειδί API στο έτοιμο αποτέλεσμα με τρεις κλήσεις

Όλα τα μοντέλα μοιράζονται ένα σχήμα ταυτοποίησης, έναν ασύγχρονο κύκλο ζωής αιτημάτων και τα ίδια ονόματα πεδίων.

  1. Δημιούργησε ένα κλειδί API

    Συνδέσου στο Mage, άνοιξε το API → API Keys και δημιούργησε ένα κλειδί. Ξεκινά με mage_sk_ και εμφανίζεται μία μόνο φορά. Ένας λογαριασμός μπορεί να έχει 10 ενεργά κλειδιά.

  2. Υπέβαλε μια δημιουργία

    Στείλε με POST ένα JSON body στο https://api.mage.space/v1/{model}/generate με header Authorization: Bearer. Η απόκριση επιστρέφει αμέσως με request_id, status και status_url. Στείλε ένα header Idempotency-Key ώστε μια επανάληψη να μην χρεώνεται ποτέ δύο φορές.

  3. Έλεγχος και λήψη

    Έλεγχε το status_url μέχρι το status να γίνει completed, failed ή cancelled. Ένα ολοκληρωμένο αίτημα περιέχει το result.url με το αρχείο εικόνας, βίντεο ή ήχου, που διατηρείται για 30 ημέρες.

Φτιαγμένο για παραγωγή

Τι παίρνει κάθε αίτημα στο Mage API

  • Ένα κλειδί, όλα τα μοντέλα

    28 μοντέλα εικόνας, βίντεο και ήχου πίσω από ένα REST API και ένα υπόλοιπο Gems. Αλλάζεις μοντέλο αλλάζοντας τη διαδρομή του URL.

  • Πληρώνεις ανά δημιουργία

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

  • Ασφαλείς επαναλήψεις

    Τα κλειδιά idempotency κάνουν μια επανυποβολή να επιστρέφει το αρχικό αίτημα χωρίς νέα χρέωση.

  • Συνεπείς χαρακτήρες

    Αποθήκευσε έναν χαρακτήρα ή μια αναφορά μία φορά και μετά γράψε @handle σε οποιοδήποτε prompt για να τα χρησιμοποιήσεις με κάθε μοντέλο που τα υποστηρίζει.

  • Μεγάλα αρχεία εισόδου

    Στείλε εικόνες, βίντεο και ήχο ως URL ή data URL, ή ανέβασε αρχεία έως 100 MB μέσω υπογεγραμμένης μεταφόρτωσης.

  • 20 δημιουργίες ταυτόχρονα

    Κάθε λογαριασμός μπορεί να εκτελεί 20 δημιουργίες ταυτόχρονα και το όριο μπορεί να αυξηθεί ανάλογα με τη χρήση σου. Τα αιτήματα που απορρίπτονται δεν χρεώνονται ποτέ.

Περιπτώσεις χρήσης

Τι φτιάχνουν οι developers με το API εικόνων

  • Εικόνες προϊόντων και μάρκετινγκ

    Δημιούργησε φωτογραφίες προϊόντων, παραλλαγές διαφημίσεων και αναρτήσεις για social κατά παραγγελία, με ευανάγνωστο κείμενο από το GPT Image 2.5 ή το Nano Banana 2.

  • Συνεπείς χαρακτήρες

    Αποθήκευσε έναν χαρακτήρα μία φορά και κράτα το ίδιο πρόσωπο σε ολόκληρη τη σειρά εικόνων με το Mango 3, το Guava 2 Pro και άλλα μοντέλα που δέχονται αναφορές @handle.

  • Ροές επεξεργασίας εικόνας

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

  • Εφαρμογές και παιχνίδια

    Δημιούργησε avatar, αυτοκόλλητα, κάρτες και σκηνές μέσα στο προϊόν σου χωρίς να φιλοξενείς ούτε μία GPU.

  • Ρεαλιστικά πορτρέτα

    Το Guava 2 Pro δημιουργεί πορτρέτα, φωτογραφίες μόδας και lifestyle με δέρμα, ύφασμα και φως πιστά στην πραγματικότητα.

  • Γρήγορα προσχέδια σε μεγάλη κλίμακα

    Τα Z-Image Turbo και Krea 2 κρατούν τις τιμές χαμηλές για thumbnails μεγάλου όγκου και πρώτες δοκιμές.

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

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

Ποιο είναι το καλύτερο API δημιουργίας εικόνων με τεχνητή νοημοσύνη;
Εξαρτάται από τη δουλειά. Στο Mage, το Mango 3 είναι η προεπιλογή για τις περισσότερες εικόνες: ακολουθεί ακριβείς οδηγίες, κρατά τους χαρακτήρες συνεπείς και κάνει επεξεργασία χωρίς να αλλοιώνει την υπόλοιπη εικόνα. Το Guava 2 Pro είναι ιδανικό για φωτορεαλισμό, τα GPT Image 2.5 και Nano Banana 2 για κείμενο μέσα σε εικόνες, και τα Z-Image Turbo ή Krea 2 για γρήγορα προσχέδια χαμηλού κόστους. Όλα τρέχουν μέσω του ίδιου API.
Υποστηρίζει το API εικόνων επεξεργασία εικόνας και εικόνες αναφοράς;
Ναι. Τα μοντέλα που δέχονται εικόνες τις παίρνουν στα πεδία image και additional_images ως URL, data URL ή ανεβασμένα αρχεία. Η σελίδα κάθε μοντέλου αναφέρει τις εισόδους του και πόσες εικόνες αναφοράς δέχεται.
Ποιες αναλύσεις υποστηρίζει το API εικόνων;
Εξαρτάται από το μοντέλο: 1K και 2K στα περισσότερα, 3K στο Mango 3S και έως 4K στα Mango 2 και Nano Banana 2. Η σελίδα κάθε μοντέλου αναφέρει τις επιλογές ανάλυσης και αναλογίας διαστάσεων.
Πόσο κοστίζει το Mage API;
Δεν υπάρχει συνδρομή ούτε μηνιαία χρέωση. Κάθε δημιουργία πληρώνεται σε Gems με την τιμή που αναγράφεται για το μοντέλο της, και 1.000 Gems κοστίζουν $1 στο τυπικό πακέτο. Κάθε σελίδα μοντέλου δείχνει την τιμή με τις προεπιλεγμένες ρυθμίσεις και κάθε απάντηση αναφέρει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή· αν την αποκλείσει η πολιτική περιεχομένου του Mage, δεν γίνεται. Ένα αίτημα που το υπόλοιπό σου δεν καλύπτει απορρίπτεται πριν γίνει οποιαδήποτε χρέωση.
Χρειάζομαι συνδρομή στο Mage για να χρησιμοποιήσω το API;
Όχι. Το API λειτουργεί αποκλειστικά με Gems. Τα πλάνα συνδρομής και η απεριόριστη δημιουργία μέσα στην εφαρμογή δεν ισχύουν για αιτήματα API, οπότε οποιοσδήποτε λογαριασμός Mage με Gems μπορεί να το καλέσει.
Μπορώ να χρησιμοποιήσω τα αποτελέσματα του API εμπορικά;
Ναι. Το περιεχόμενο που δημιουργείς με το Mage, μεταξύ άλλων μέσω του API και του MCP server, μπορεί να χρησιμοποιηθεί εμπορικά. Η αναφορά στην πηγή είναι ευπρόσδεκτη αλλά δεν είναι υποχρεωτική.
Ποια είναι τα όρια χρήσης (rate limits);
Ένας λογαριασμός μπορεί να έχει ταυτόχρονα 20 δημιουργίες σε ουρά ή σε εκτέλεση. Μια υποβολή πέρα από αυτό το όριο απορρίπτεται με 429 και δεν χρεώνεται. Γράψε στο [email protected] για να αυξηθεί το όριο για τη δική σου περίπτωση χρήσης.
Μπορεί ο AI agent μου να χρησιμοποιήσει το Mage API;
Ναι. Οι agents μπορούν να καλέσουν το REST API με ένα κλειδί ή να συνδεθούν στον MCP server του Mage, που δίνει στα Claude, ChatGPT, Claude Code, Grok και Cursor δεκαέξι έτοιμα εργαλεία για να επιλέγουν μοντέλο, να βλέπουν την τιμή, να δημιουργούν και να παίρνουν το αποτέλεσμα. Δες τον MCP server.
Υπάρχει SDK για το Mage API;
Ναι. Το επίσημο πακέτο @mage-space/sdk στο npm και το mage-space στο PyPI είναι ανοιχτού κώδικα και έχουν τύπους για κάθε μοντέλο. Υποβάλλουν το αίτημα, περιμένουν το αποτέλεσμα, κάνουν ασφαλείς επαναπροσπάθειες και ανεβάζουν αρχεία για σένα. Οι χρήστες του ComfyUI μπορούν να εγκαταστήσουν το πακέτο κόμβων comfyui-mage. Δες τα Mage SDKs.
Χρησιμοποιώ ήδη άλλο API δημιουργίας. Τι πρέπει να αλλάξω;
Κατεύθυνε τον client σου στο https://api.mage.space/v1, στείλε το κλειδί σου του Mage ως Bearer token και αντιστοίχισε τα πεδία σου με τη σελίδα του μοντέλου: τα prompt, aspect_ratio, resolution, duration και model_id λειτουργούν με τον ίδιο τρόπο σε κάθε μοντέλο του Mage. Τα αιτήματα είναι ασύγχρονα, οπότε κάνε υποβολή και μετά έλεγχε επαναλαμβανόμενα το status_url.

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

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

Απόκτησε κλειδί APIΔιάβασε την τεκμηρίωση του API