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

Mage API · Δημιουργία ήχου

Το API τεχνητής νοημοσύνης για δημιουργία ήχου: φωνές, μουσική και ηχητικά εφέ

Ομιλία, αφήγηση, μουσική και ηχητικά εφέ από μία εντολή με το Seed Audio, με φωνές αναφοράς και ρυθμίσεις ταχύτητας ομιλίας, έντασης και τόνου.

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

Με μια ματιά

Το API δημιουργίας ήχου του Mage εκτελεί το Seed Audio στο https://api.mage.space/v1/seed_audio/generate. Στείλε μια εντολή κειμένου, προαιρετικά με φωνές αναφοράς ή μια εικόνα, και λάβε ένα αρχείο ήχου έως 120 δευτερόλεπτα με φωνές, μουσική ή ηχητικά εφέ. Κάθε κλιπ πληρώνεται με Gems, χωρίς συνδρομή.

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

Μοντέλα

Όλα τα μοντέλα ήχου στο Mage API

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

ΜοντέλοΙδανικό γιαΤιμές model_idΠροεπιλεγμένη τιμή
Seed AudioΦωνές, μουσική και ηχητικά εφέ από μία εντολήseed-audio-1.019 Gems ($0.019)

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

Δημιούργησε ήχο με το Seed Audio

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A calm narrator reading a short weather report",
  "duration": "5",
  "model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seed_audio", {
    "prompt": "A calm narrator reading a short weather report",
    "duration": "5",
    "model_id": "seed-audio-1.0",
})

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 ήχου

  • Αφήγηση και voiceover

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

  • Σταθερές φωνές

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

  • Ηχητικά εφέ

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

  • Μουσική υπόκρουση

    Δημιούργησε μουσική υπόκρουση για κλιπ στα social και διαφημίσεις από μια εντολή.

  • Ηχητικό υπόβαθρο για βίντεο που δημιουργείται με AI

    Συνδύασε το Seed Audio με το API βίντεο για να προσθέσεις ήχο σε κλιπ από μοντέλα χωρίς ήχο.

  • Agents που μιλούν

    Άφησε το Claude, το ChatGPT ή τον δικό σου agent να παράγει ήχο μέσω του διακομιστή MCP ή του REST API.

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

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

Μπορεί το API ήχου να κάνει μετατροπή κειμένου σε ομιλία;
Ναι. Το Seed Audio διαβάζει ένα κείμενο με μια φωνή που περιγράφεις ή με μια αποθηκευμένη φωνή αναφοράς και προσφέρει ρυθμίσεις ταχύτητας ομιλίας, έντασης και τόνου. Δημιουργεί επίσης μουσική και ηχητικά εφέ από το ίδιο πεδίο εντολής.
Πόσο μεγάλος μπορεί να είναι ο ήχος που δημιουργείται;
Το Seed Audio δημιουργεί κλιπ έως 120 δευτερόλεπτα.
Πόσο κοστίζει το 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