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

Mage API · Μοντέλο ήχου

Seed Audio API

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

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

Με μια ματιά

Το Seed Audio API εκτελεί το Seed Audio μέσω του Mage στο POST https://api.mage.space/v1/seed_audio/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 19 Gems (περίπου $0.019), χωρίς συνδρομή. Το Seed Audio δέχεται αποθηκευμένες αναφορές ήχου με @handle στο prompt.

  • ΉχοςΈξοδος
  • 1Παραλλαγή
  • 19Gems ανά κλιπ, προεπιλογή
  • $0.019Περίπου, σε USD

Επισκόπηση

Τι κάνει το Seed Audio API

Ομιλία, διάλογος, μουσική και ηχητικά εφέ από ένα μόνο prompt, ως MP3 ακριβώς της διάρκειας που ζητάς, από 5 δευτερόλεπτα έως 2 λεπτά. Ταίριαξε μια φωνή από έως 3 ηχητικά κλιπ.

Φωνές, διάλογος, μουσική και ηχητικά εφέ από ένα prompt, ως MP3 ακριβώς της διάρκειας που ζητήθηκε.

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

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

Κάλεσε το Seed Audio API

Όρισε το MAGE_API_KEY, στείλε το αίτημα στο /seed_audio/generate και κάνε poll στο status_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"])

Μοντέλα

Τιμές model_id του Seed Audio

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

model_idΌνομαΠροεπιλογή
seed-audio-1.0Seed AudioΝαι

Επιλογές

Παράμετροι του Seed Audio

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

ΠεδίοΤιμές
duration5, 10, 30, 60, 120

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Seed Audio

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

ΠεδίοΡόλος
imageΗ εικόνα αναφοράς.

Κανόνες

Τι επιβάλλει το Seed Audio API

  • Μια αναφορά εικόνας δεν μπορεί να συνδυαστεί με αναφορές ήχου: στείλε το ένα είδος ή το άλλο.
  • Το prompt έχει το πολύ 2986 χαρακτήρες.
  • Το `sample_rate` είναι ένα από τα 8000, 16000, 24000, 32000, 44100, 48000.
  • Το `speech_rate` είναι ακέραιος αριθμός από -50 έως 100.
  • Το `loudness_rate` είναι ακέραιος αριθμός από -50 έως 100.
  • Το `pitch_rate` είναι ακέραιος αριθμός από -12 έως 12.

Περισσότερα μοντέλα ήχου

Άλλα API δημιουργίας ήχου στο Mage

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

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

    Πόσο κοστίζει το Seed Audio API;
    Ένα αίτημα Seed Audio με τις προεπιλεγμένες ρυθμίσεις (Seed Audio) κοστίζει 19 Gems, περίπου $0.019. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση δείχνει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή χρημάτων· αν τη μπλοκάρει η πολιτική περιεχομένου του Mage, όχι.
    Ποιο είναι το endpoint του Seed Audio API;
    POST https://api.mage.space/v1/seed_audio/generate με header Authorization: Bearer που περιέχει το κλειδί API σου στο Mage. Η απάντηση περιλαμβάνει ένα status_url για να κάνεις poll και να πάρεις το αποτέλεσμα.
    Ποια μοντέλα Seed Audio μπορώ να καλέσω;
    seed-audio-1.0 (Seed Audio). Το προεπιλεγμένο είναι το Seed Audio.
    Υποστηρίζει το Seed Audio εικόνες αναφοράς ή χαρακτήρες;
    Το Seed Audio δέχεται image. Το Seed Audio δέχεται αποθηκευμένες αναφορές ήχου με @handle στο prompt.
    Μπορώ να χρησιμοποιήσω το Seed Audio από το Claude ή το ChatGPT;
    Ναι. Σύνδεσε τον διακομιστή MCP του Mage με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Seed Audio με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και σου λέει την τιμή πριν δημιουργήσει.
    Για πόσο καιρό διατηρούνται τα αποτελέσματα του Seed Audio;
    Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

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

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