Μετάβαση στο περιεχόμενο

Mage API · Μοντέλο βίντεο

Magejutsu API

Άλλαξε το καστ σε οποιοδήποτε βίντεο, κρατώντας την κίνησή του

POST https://api.mage.space/v1/magejutsu/generate

Με μια ματιά

Το Magejutsu API εκτελεί το Magejutsu και 2 ακόμη παραλλαγές μέσω του Mage στο POST https://api.mage.space/v1/magejutsu/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 1.856 Gems (περίπου $1,856), χωρίς συνδρομή. Το Magejutsu δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.

  • ΒίντεοΈξοδος
  • 3Παραλλαγές
  • 1,856Gems ανά κλιπ, προεπιλογή
  • $1.856Περίπου, σε USD

Επισκόπηση

Τι κάνει το Magejutsu API

Αλλάζει το καστ ενός βίντεο που ήδη έχεις: στέλνεις το κλιπ και φωτογραφίες αυτού ή αυτού που το αντικαθιστά, και η κίνηση, η κάμερα, ο χρονισμός και ο ήχος μένουν όπως γυρίστηκαν. Τα βίντεο-πηγή έχουν διάρκεια από 4 έως 30 δευτερόλεπτα.

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

Δέχεται ως είσοδο τα image, additional_images, videos.

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

Κάλεσε το Magejutsu API

Όρισε το MAGE_API_KEY, στείλε αίτημα στο /magejutsu/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί το αίτημα.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
  "videos": [
    "https://example.com/input.jpg"
  ],
  "image": "https://example.com/input.jpg",
  "model_id": "magejutsu"
}' | 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('magejutsu', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  videos: [
    'https://example.com/input.jpg',
  ],
  image: 'https://example.com/input.jpg',
  model_id: 'magejutsu',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("magejutsu", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "videos": [
        "https://example.com/input.jpg",
    ],
    "image": "https://example.com/input.jpg",
    "model_id": "magejutsu",
})

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

Μοντέλα

Τιμές model_id του Magejutsu

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
magejutsuMagejutsuΝαι
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

Επιλογές

Παράμετροι του Magejutsu

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

Είσοδοι

Αρχεία πολυμέσων που δέχεται το Magejutsu

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.
videosΤα βίντεο-πηγή.

Κανόνες

Τι επιβάλλει το Magejutsu API

  • Το αρχικό βίντεο έχει διάρκεια από 4 έως 30 δευτερόλεπτα στο magejutsu και από 4 έως 15 στο magejutsu-lite, τη γρηγορότερη και φθηνότερη παραλλαγή, καθώς και στο magejutsu-feather, την πιο οικονομική και γρήγορη, που εκτελεί μόνο motion_transfer και αποδίδει σε 480p και 720p. Το αποτέλεσμα ακολουθεί τη διάρκεια και την αναλογία διαστάσεων του αρχικού βίντεο.
  • Κάθε αίτημα τρέχει τον ίδιο director στο backend. Επίλεξε motion_transfer για να αναδημιουργήσεις τους ερμηνευτές και να κρατήσεις την κίνηση, ή object_swap για να αλλάξεις συγκεκριμένα στοιχεία και να διατηρήσεις τα υπόλοιπα του πλάνου όπως γυρίστηκαν. Η λειτουργία καθορίζει και πώς προετοιμάζεται η πηγή: το motion transfer καθοδηγεί την επεξεργασία με την κίνηση και το πρόσωπο κάθε ερμηνευτή που αντικαθίσταται, ενώ το object swap επεξεργάζεται την πηγή όπως γυρίστηκε. Αν ένα κλιπ δεν μπορεί να διαβαστεί από την καθοδήγηση, για παράδειγμα επειδή δεν έχει κανένα άτομο, αποδίδεται από την πηγή όπως γυρίστηκε. Δεν υπάρχουν χειροκίνητα βήματα έγκρισης ούτε αποδόσεις πρόχειρων εκδόσεων.
  • Στείλε έως 30 εικόνες αναφοράς μέσω των image και additional_images. Ο director τις διαβάζει όλες και η επεξεργασία λαμβάνει όσες χρησιμοποιεί το prompt της: έως 27 στο magejutsu, 9 στο magejutsu-lite και 8 στο magejutsu-feather.
  • Το prompt είναι προαιρετικό: χωρίς αυτό, ο director αντιστοιχίζει τις αναφορές στην πηγή με βάση την προβολή και την καταλληλότητά τους.
  • Ο αρχικός ήχος αποκαθίσταται από προεπιλογή· όρισε το keep_original_audio σε false για να διατηρήσεις τον ήχο που δημιουργήθηκε.
  • Οι εικόνες είναι η αντικατάσταση· αναφέρσου σε καθεμία στο prompt με βάση τη θέση της ("η εικόνα 1 είναι το άτομο αριστερά").
  • Το βίντεο-πηγή είναι το μόνο βίντεο που γίνεται δεκτό σε ένα αίτημα· ένα μεγαλύτερο κλιπ απορρίπτεται αντί να κοπεί.

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

Άλλα API δημιουργίας βίντεο στο Mage

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

    Melon API

    Anime σε κίνηση, με προαιρετικό ήχο

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

    MiniMax-H3 API

    Γρήγορο ανοιχτό βίντεο με στερεοφωνικό ήχο

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

    Plum API

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

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

    Raspberry API

    Χαρακτήρες που ζωντανεύουν από ένα πρώτο καρέ

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

    Wan Video v2.2 API

    Βίντεο ανοιχτών βαρών με παραλλαγή Lightning

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

    Berry API

    Βίντεο που μένει πιστό στις αναφορές σου

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

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

Πόσο κοστίζει το Magejutsu API;
Ένα αίτημα Magejutsu με τις προεπιλεγμένες ρυθμίσεις (Magejutsu) κοστίζει 1.856 Gems, περίπου $1,856. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση αναφέρει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή των Gems· αν όμως αποκλειστεί από την πολιτική περιεχομένου του Mage, δεν γίνεται επιστροφή.
Ποιο είναι το endpoint του Magejutsu API;
POST https://api.mage.space/v1/magejutsu/generate με header Authorization: Bearer που περιέχει το κλειδί σου για το Mage API. Η απάντηση περιλαμβάνει ένα status_url για να ελέγξεις το αποτέλεσμα.
Ποια μοντέλα του Magejutsu μπορώ να καλέσω;
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather). Η προεπιλογή είναι το Magejutsu.
Υποστηρίζει το Magejutsu εικόνες αναφοράς ή χαρακτήρες;
Το Magejutsu δέχεται image, additional_images, videos. Το Magejutsu δέχεται αποθηκευμένους χαρακτήρες και αναφορές με @handle στο prompt.
Μπορώ να χρησιμοποιήσω το Magejutsu από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον Mage MCP server με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Magejutsu με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με get_model και αναφέρει την τιμή πριν δημιουργήσει.
Για πόσο διατηρούνται τα αποτελέσματα του Magejutsu;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

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

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