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

Mage API · SDKs

Επίσημα SDKs για το Mage API

Πελάτες με τύπους για TypeScript και Python και nodes του Mage για το ComfyUI. Κάθε μοντέλο εικόνας, βίντεο και ήχου σε λίγες γραμμές κώδικα.

Απόκτησε κλειδί APIΔιάβασε τα έγγραφα των SDK

Με μια ματιά

Το Mage δημοσιεύει SDK ανοιχτού κώδικα για το API του: @mage-space/sdk στο npm για TypeScript και JavaScript, mage-space στο PyPI για Python και το πακέτο nodes comfyui-mage για το ComfyUI. Κάθε SDK τυλίγει το REST API με ρυθμίσεις με τύπους για και τα 28 μοντέλα, αυτόματο polling, idempotent επαναλήψεις και uploads.

  • 3SDKs και ενσωματώσεις
  • 28Μοντέλα με τύπους
  • MITΑνοιχτός κώδικας
  • $0Για εγκατάσταση

Διάλεξε το δικό σου

SDKs και ενσωματώσεις

  • npm install @mage-space/sdk

    SDK για TypeScript

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

  • pip install mage-space

    SDK για Python

    Δημιούργησε εικόνες, βίντεο και ήχο από την Python με sync και asyncio clients και ρυθμίσεις με τύπους για κάθε μοντέλο του Mage.

  • comfy node install comfyui-mage

    Το Mage για ComfyUI

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

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

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

Εγκατάστησε το πακέτο, όρισε το 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"])

Ενσωματωμένα

Τι αναλαμβάνει κάθε SDK για σένα

  • Μία κλήση, έτοιμο πολυμέσο

    Το run υποβάλλει τη δημιουργία, κάνει polling με το backoff που προτείνει το API και επιστρέφει το ολοκληρωμένο αίτημα με το result.url.

  • Επαναλήψεις χωρίς διπλή χρέωση

    Κάθε υποβολή φέρει ένα idempotency key. Τα σφάλματα δικτύου και διακομιστή επαναλαμβάνονται με backoff και μια υποβολή που επαναλαμβάνεται δεν χρεώνεται ξανά.

  • Uploads με μία κλήση

    Τα αρχεία που είναι πολύ μεγάλα για data URL περνούν από υπογεγραμμένο upload, με το ticket, το PUT και τον έλεγχο μεγέθους να γίνονται για σένα.

  • Σαφή σφάλματα

    Οι απορρίψεις του API περιλαμβάνουν το HTTP status, τον κωδικό σφάλματος και το request id· οι αποτυχημένες ή ακυρωμένες δημιουργίες και τα timeouts έχουν δικούς τους τύπους σφαλμάτων.

Πακέτα

Πού θα τα βρεις

SDKΠακέτοΕγκατάστασηΠηγαίος κώδικας
SDK για TypeScript@mage-space/sdknpm install @mage-space/sdkGitHub
SDK για Pythonmage-spacepip install mage-spaceGitHub
Mage για ComfyUIcomfyui-magecomfy node install comfyui-mageGitHub

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

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

Είναι τα Mage SDK δωρεάν και ανοιχτού κώδικα;
Ναι. Τα SDK και οι κόμβοι ComfyUI έχουν άδεια MIT στο GitHub και η εγκατάστασή τους είναι δωρεάν. Πληρώνεις μόνο για τις δημιουργίες που εκτελείς, σε Gems, στην τιμή που αναφέρεται για κάθε μοντέλο.
Λειτουργούν τα νέα μοντέλα της Mage με παλαιότερο SDK;
Ναι. Πέρασε το id του νέου μοντέλου ως string και θα τρέξει· το SDK ελέγχει τη ρύθμισή του με βάση τα πεδία που μοιράζονται όλα τα μοντέλα. Ένα bot ενημερώνει τους τύπους κάθε φορά που αλλάζει η τεκμηρίωση του API, οπότε τα νέα μοντέλα έρχονται με τους δικούς τους τύπους στην επόμενη έκδοση.
Πώς αποφεύγουν τα SDK τη διπλή χρέωση όταν ένα αίτημα επαναλαμβάνεται;
Κάθε υποβολή περιλαμβάνει ένα Idempotency-Key. Το SDK δημιουργεί νέο κλειδί για κάθε κλήση και το επαναχρησιμοποιεί όταν επαναλαμβάνει μόνο του την ίδια κλήση, έτσι μια υποβολή που επαναλαμβάνεται επιστρέφει το αρχικό αίτημα και δεν χρεώνει τίποτα.
Είναι σταθερά τα SDK;
Βρίσκονται σε beta στην έκδοση 0.x, επομένως μια δευτερεύουσα έκδοση (minor) μπορεί ακόμη να τα αλλάξει. Το ίδιο το API έχει ξεχωριστή αρίθμηση εκδόσεων και παραμένει σταθερό μέσα στο v1.
Πόσο κοστίζει το Mage API;
Δεν υπάρχει συνδρομή ούτε μηνιαία χρέωση. Κάθε δημιουργία πληρώνεται σε Gems με την τιμή που αναγράφεται για το μοντέλο της, και 1.000 Gems κοστίζουν $1 στο τυπικό πακέτο. Κάθε σελίδα μοντέλου δείχνει την τιμή με τις προεπιλεγμένες ρυθμίσεις και κάθε απάντηση αναφέρει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή· αν την αποκλείσει η πολιτική περιεχομένου του Mage, δεν γίνεται. Ένα αίτημα που το υπόλοιπό σου δεν καλύπτει απορρίπτεται πριν γίνει οποιαδήποτε χρέωση.
Χρειάζομαι συνδρομή στο Mage για να χρησιμοποιήσω το API;
Όχι. Το API λειτουργεί αποκλειστικά με Gems. Τα πλάνα συνδρομής και η απεριόριστη δημιουργία μέσα στην εφαρμογή δεν ισχύουν για αιτήματα API, οπότε οποιοσδήποτε λογαριασμός Mage με Gems μπορεί να το καλέσει.
Μπορώ να χρησιμοποιήσω τα αποτελέσματα του API εμπορικά;
Ναι. Το περιεχόμενο που δημιουργείς με το Mage, μεταξύ άλλων μέσω του API και του MCP server, μπορεί να χρησιμοποιηθεί εμπορικά. Η αναφορά στην πηγή είναι ευπρόσδεκτη αλλά δεν είναι υποχρεωτική.

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

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

Απόκτησε κλειδί APIΔιάβασε τα έγγραφα των SDK