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

Mage API · Φτιαγμένο για την επόμενη ιδέα σου

Ένα API. Απεριόριστες δυνατότητες.

Φέρε το καλύτερο του Mage στο προϊόν σου και στον AI βοηθό σου. Δημιούργησε εικόνες, βίντεο και ήχο με ένα μόνο κλειδί API ή μία μόνο σύνδεση MCP.

Απόκτησε κλειδί APIΣύνδεσε τον βοηθό σουΔιάβασε την τεκμηρίωση του API
https://api.mage.space/v1

Με μια ματιά

Το Mage προσφέρει στους προγραμματιστές ένα REST API στο https://api.mage.space/v1 και έναν απομακρυσμένο MCP server στο https://mcp.mage.space/mcp. Και τα δύο τρέχουν τα ίδια 28 μοντέλα εικόνας, βίντεο και ήχου, μεταξύ των οποίων τα αποκλειστικά του Mage Mango 3 και Cherry 2 Pro, με έναν λογαριασμό, και κάθε δημιουργία πληρώνεται με Gems χωρίς συνδρομή.

  • 28Μοντέλα
  • 3Τύποι πολυμέσων
  • 16Εργαλεία MCP
  • $0Μηνιαία χρέωση

Τρόποι χρήσης

Κάλεσέ το από κώδικα, τον βοηθό σου ή το ComfyUI

  • REST API

    Το Mage API

    Υπέβαλε δημιουργίες από τον δικό σου κώδικα με ένα κλειδί. Ασύγχρονα αιτήματα, idempotent επαναλήψεις, μεταφορτώσεις έως 100 MB και 20 δημιουργίες σε εξέλιξη.

  • SDK

    SDK για TypeScript και Python

    Επίσημοι clients με τύπους, που υποβάλλουν, περιμένουν το αποτέλεσμα, κάνουν ασφαλείς επαναλήψεις και ανεβάζουν αρχεία με λίγες γραμμές.

  • MCP server

    Ο MCP server του Mage

    Σύνδεσε το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor με μια σύνδεση λογαριασμού και ζήτα εικόνες, βίντεο και ήχο με απλά λόγια.

  • ComfyUI

    Το Mage για ComfyUI

    Τα Mango, Cherry, Seed Audio και κάθε άλλο μοντέλο του Mage ως nodes του ComfyUI. Χωρίς GPU, χωρίς λήψεις μοντέλων.

Ανά τύπο πολυμέσων

API δημιουργίας

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

Η πρώτη σου δημιουργία

Δημιούργησε ένα κλειδί στο API → API Keys, κάνε το export ως MAGE_API_KEY και τρέξε ένα από τα παρακάτω.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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 ημέρες.

MCP

Το Mage στον AI βοηθό σου

  • Το Mage στο Claude

    Δημιούργησε εικόνες, βίντεο και ήχο στο Claude στον ιστό, στην εφαρμογή για υπολογιστή, στις εφαρμογές για κινητά και στο Cowork.

  • Το Mage στο ChatGPT

    Δημιούργησε εικόνες, βίντεο και ήχο στο ChatGPT ως προσωπική εφαρμογή MCP.

  • Το Mage στο Claude Code

    Δημιούργησε εικόνες, βίντεο και ήχο στο Claude Code, μέσα από το τερματικό και τον επεξεργαστή κώδικά σου.

  • Το Mage στο Grok

    Δημιούργησε εικόνες, βίντεο και ήχο στο Grok ως προσαρμοσμένος σύνδεσμος.

  • Το Mage στο Cursor

    Δημιούργησε εικόνες, βίντεο και ήχο στη λειτουργία Agent του Cursor.

Μοντέλα

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

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

    Flux 2 API

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

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

    GPT Image 2 API

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

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

    Guava API

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

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

    Mango API

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

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

    Nano Banana 2 API

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

  • Βίντεο · από 618 Gems

    Cherry API

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

  • Βίντεο · από 245 Gems

    Lemon API

    Όλες οι δυνατότητες βίντεο, σε πιο προσιτή τιμή

  • Βίντεο · από 338 Gems

    Plum API

    Ήχος σε κάθε κλιπ, έως 2K

  • Ήχος · από 19 Gems

    Seed Audio API

    Φωνές, μουσική και ηχητικά εφέ από ένα μόνο prompt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Τι είναι το Mage API;
Το Mage API είναι ένα REST API στη διεύθυνση https://api.mage.space/v1 για τη δημιουργία εικόνων, βίντεο και ήχου με 28 μοντέλα από τον δικό σου κώδικα. Τα αιτήματα είναι ασύγχρονα και πληρώνονται ανά δημιουργία σε Gems.
Τι είναι ο διακομιστής Mage MCP;
Ένας απομακρυσμένος διακομιστής Model Context Protocol στη διεύθυνση https://mcp.mage.space/mcp που επιτρέπει σε βοηθούς AI να δημιουργούν εικόνες, βίντεο και ήχο στον λογαριασμό σου στο Mage. Δίνει στον βοηθό 16 εργαλεία για να επιλέγει μοντέλο, να δίνει προσφορά τιμής, να δημιουργεί, να περιμένει το αποτέλεσμα και να χρησιμοποιεί τους αποθηκευμένους χαρακτήρες, τις αναφορές και το ιστορικό σου.
Χρειάζομαι κλειδί API για να χρησιμοποιήσω τον διακομιστή MCP;
Όχι. Τα Claude, ChatGPT, Grok, Cursor και Claude Code συνδέονται με είσοδο στο Mage μέσω OAuth. Το κλειδί API είναι προαιρετικό, για διαμορφώσεις χωρίς γραφικό περιβάλλον, όπως το CI.
Πόσο κοστίζει το 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Σύνδεσε τον βοηθό σου