Mage API · Μοντέλα
28 μοντέλα δημιουργίας, ένα API
Όλα τα μοντέλα εικόνας, βίντεο και ήχου που εκτελεί το Mage API, με το πού ξεχωρίζει το καθένα, τις τιμές model_id και την τιμή τους στις προεπιλεγμένες ρυθμίσεις.
POST https://api.mage.space/v1/{model}/generateΜε μια ματιά
Το Mage API εκτελεί 15 μοντέλα εικόνας, 12 μοντέλα βίντεο και 1 μοντέλο ήχου στο https://api.mage.space/v1/{model}/generate. Όλα τα μοντέλα χρησιμοποιούν το ίδιο κλειδί, τον ίδιο κύκλο αιτημάτων και τα ίδια ονόματα πεδίων, και πληρώνονται ανά δημιουργία με Gems.
- 15Μοντέλα εικόνας
- 12Μοντέλα βίντεο
- 1Μοντέλα ήχου
- 1Κλειδί API για όλα
Μοντέλα εικόνας
Μοντέλα δημιουργίας εικόνων
Οι τιμές είναι ανά δημιουργία, σε Gems. 1.000 Gems κοστίζουν $1 στο τυπικό πακέτο και τα μεγαλύτερα πακέτα προσθέτουν bonus Gems. Η τιμή εξαρτάται από το μοντέλο, την ανάλυση και τη διάρκεια· εμφανίζεται η τιμή με τις προεπιλεγμένες ρυθμίσεις και κάθε απόκριση δείχνει την ακριβή χρέωση στο billing.gems_charged. Μια δημιουργία που αποτυγχάνει επιστρέφεται· μια δημιουργία που μπλοκάρεται από την πολιτική περιεχομένου του Mage δεν επιστρέφεται.
| Μοντέλο | Ιδανικό για | Τιμές model_id | Προεπιλεγμένη τιμή |
|---|---|---|---|
| Anima | Φτιαγμένο ειδικά για anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, βασισμένο στο Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Μεγάλα prompts και επεξεργασίες με πολλές αναφορές | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Ακριβή prompts και ευανάγνωστο κείμενο | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, σε τρία επίπεδα ποιότητας | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Φωτορεαλισμός που περνάει για φωτογραφία | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Γρήγορο και ευέλικτο, με αρνητικά prompts | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Εκπληκτική αισθητική σε δευτερόλεπτα | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Η κορυφαία οικογένεια μοντέλων εικόνας μας | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Καθαρό, ευανάγνωστο κείμενο, έως 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL με διορθωμένα πρόσωπα και χέρια | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Το κλασικό, με οικονομικό κόστος | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Το Stable Diffusion που ακούει καλύτερα | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL βελτιστοποιημένο για φωτορεαλισμό | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Το πιο γρήγορο μοντέλο εικόνας στο Mage | z-image-turbo | 10 Gems ($0.01) |
Μοντέλα βίντεο
Μοντέλα δημιουργίας βίντεο
| Μοντέλο | Ιδανικό για | Τιμές model_id | Προεπιλεγμένη τιμή |
|---|---|---|---|
| Berry | Βίντεο πιστό στις αναφορές σου | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Καθόρισε το πρώτο και το τελευταίο καρέ | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Η κορυφαία οικογένεια βίντεο μας | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Το Grok Imagine, σε κίνηση | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Βίντεο για κάθε μέρα, χωρίς ρυθμίσεις | kiwi | 270 Gems ($0.27) |
| Lemon | Όλες οι λειτουργίες βίντεο, σε πιο φιλική τιμή | lemon | 245 Gems ($0.245) |
| LTX Video | Γρήγορο βίντεο ανοιχτών βαρών για δοκιμές | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime σε κίνηση, με προαιρετικό ήχο | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Γρήγορο ανοιχτό βίντεο με στερεοφωνικό ήχο | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Ήχος σε κάθε κλιπ, έως 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Χαρακτήρες που ζωντανεύουν από ένα πρώτο καρέ | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Βίντεο ανοιχτών βαρών με παραλλαγή Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Μοντέλα ήχου
Μοντέλα δημιουργίας ήχου
| Μοντέλο | Ιδανικό για | Τιμές model_id | Προεπιλεγμένη τιμή |
|---|---|---|---|
| Seed Audio | Φωνές, μουσική και ηχητικά εφέ από μία εντολή | seed-audio-1.0 | 19 Gems ($0.019) |
Συχνές ερωτήσεις
Συχνές ερωτήσεις
Πόσο κοστίζει το 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, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.