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

Mage API · Δημιουργία βίντεο

Το API δημιουργίας βίντεο με τεχνητή νοημοσύνη, από κείμενο ή εικόνες

Κείμενο σε βίντεο, εικόνα σε βίντεο, πρώτο και τελευταίο καρέ και αναφορά σε βίντεο από 12 μοντέλα, με κορυφαίο το Cherry 2 Pro του Mage και ήχο σε πολλά κλιπ.

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

Με μια ματιά

Το API δημιουργίας βίντεο του Mage είναι ένα REST API στο https://api.mage.space/v1 που τρέχει 12 μοντέλα κειμένου σε βίντεο και εικόνας σε βίντεο, όπως τα Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video και Wan. Στέλνεις ένα prompt και προαιρετικά καρέ ή αναφορές, ελέγχεις το αίτημα και κατεβάζεις ένα MP4. Κάθε κλιπ πληρώνεται σε Gems ανάλογα με το μοντέλο, την ανάλυση και τη διάρκεια.

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

Μοντέλα

Όλα τα μοντέλα βίντεο στο Mage API

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

ΜοντέλοΙδανικό γιαΤιμές model_idΠροεπιλεγμένη τιμή
BerryΒίντεο πιστό στις αναφορές σουberry, berry-2189 Gems ($0.189)
BlueberryΚαθόρισε το πρώτο και το τελευταίο καρέblueberry, blueberry-v2360 Gems ($0.36)
CherryΗ κορυφαία οικογένεια βίντεο μαςcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoΤο Grok Imagine, σε κίνησηgrok-imagine-video375 Gems ($0.375)
KiwiΒίντεο για κάθε μέρα, χωρίς ρυθμίσειςkiwi270 Gems ($0.27)
LemonΌλες οι λειτουργίες βίντεο, σε πιο φιλική τιμήlemon245 Gems ($0.245)
LTX VideoΓρήγορο βίντεο ανοιχτών βαρών για δοκιμέςltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime σε κίνηση, με προαιρετικό ήχοmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Γρήγορο ανοιχτό βίντεο με στερεοφωνικό ήχοminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumΉχος σε κάθε κλιπ, έως 2Kplum, plum-max338 Gems ($0.338)
RaspberryΧαρακτήρες που ζωντανεύουν από ένα πρώτο καρέraspberry360 Gems ($0.36)
Wan Video v2.2Βίντεο ανοιχτών βαρών με παραλλαγή Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

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

Δημιούργησε ένα βίντεο με το Berry 2

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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

    Φτιάξε κάθετα κλιπ για TikTok, Reels και Shorts από ένα prompt ή μια εικόνα προϊόντος.

  • Δώσε κίνηση σε στατικές εικόνες

    Μετέτρεψε ένα πρώτο καρέ, ή ένα πρώτο και ένα τελευταίο, σε κίνηση με μοντέλα εικόνας σε βίντεο όπως τα Lemon και Kiwi.

  • Ιστορίες με πρωταγωνιστές χαρακτήρες

    Κράτα τον ίδιο χαρακτήρα σε όλα τα πλάνα με μοντέλα αναφοράς σε βίντεο που δέχονται χαρακτήρες @handle.

  • Βίντεο με ήχο

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

  • Διαφημίσεις και demo προϊόντων

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

  • Επεξεργασία υπαρχόντων κλιπ

    Τα Berry, Plum και Grok Video επεξεργάζονται ένα βίντεο που στέλνεις· τα Lemon και MiniMax-H3 δέχονται επίσης βίντεο αναφοράς.

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

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

Ποιο είναι το καλύτερο API δημιουργίας βίντεο με τεχνητή νοημοσύνη;
Στο Mage, το Cherry 2 Pro είναι η προεπιλογή για βίντεο: υποστηρίζει χαρακτήρες, πολλές εικόνες αναφοράς, ηχητικές αναφορές, έξοδο από 480p έως 1080p και κλιπ έως 30 δευτερόλεπτα. Το Lemon είναι η επιλογή για έλεγχο πρώτου και τελευταίου καρέ, το Plum για κλιπ με παραγόμενο ήχο έως 2K, και τα Cherry Mini ή Wan για φθηνότερα προσχέδια.
Υποστηρίζει το API βίντεο τη μετατροπή εικόνας σε βίντεο;
Ναι. Τα μοντέλα εικόνας σε βίντεο δέχονται ένα πρώτο καρέ, και ορισμένα δέχονται και τελευταίο καρέ ή εικόνες αναφοράς, ως URL, data URL ή ανεβασμένα αρχεία. Η σελίδα κάθε μοντέλου αναφέρει τις εισόδους του και αν απαιτείται εικόνα.
Πόσο μεγάλα μπορούν να είναι τα βίντεο που δημιουργούνται;
Εξαρτάται από το μοντέλο και την ανάλυση. Πολλά μοντέλα δημιουργούν από 4 έως 15 δευτερόλεπτα, ενώ το Cherry 2 Pro φτάνει τα 20, 25 και 30 δευτερόλεπτα. Η σελίδα κάθε μοντέλου αναφέρει τις διάρκειές του.
Πόση ώρα παίρνει η δημιουργία ενός βίντεο;
Εξαρτάται από το μοντέλο, την ανάλυση και τη διάρκεια. Το API είναι ασύγχρονο: υπέβαλε το αίτημα και μετά έλεγχε το status_url με backoff, ή άσε τον MCP client σου να περιμένει με το get_request.
Πόσο κοστίζει το 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