Ein Schlüssel, alle Modelle
28 Bild-, Video- und Audiomodelle über eine REST-API und ein Gems-Guthaben. Wechsle das Modell, indem du den URL-Pfad änderst.
Auf einen Blick
Die Mage Audio-API führt Seed Audio unter https://api.mage.space/v1/seed_audio/generate aus. Sende einen Text-Prompt, optional mit Stimmreferenzen oder einem Bild, und erhalte eine Audiodatei von bis zu 120 Sekunden Länge mit Stimmen, Musik oder Soundeffekten. Jeder Clip wird in Gems bezahlt, ganz ohne Abo.
1
Audiomodelle
$0.019
Günstigster Standard, pro Clip
20
Parallele Generierungen
$0
Monatliche Gebühr
Modelle
Alle Audiomodelle in der Mage API
Die Preise gelten pro Generierung, in Gems. 1.000 Gems kosten im Standardpaket 1 $, größere Pakete enthalten Bonus-Gems. Der Preis hängt von Modell, Auflösung und Dauer ab; angezeigt wird der Preis bei Standardeinstellungen, und jede Antwort nennt die genaue Abbuchung in billing.gems_charged. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.
| Modell | Ideal für | model_id-Werte | Standardpreis |
|---|---|---|---|
| Seed Audio | Stimmen, Musik und Soundeffekte aus einem Prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Schnellstart
Audio mit Seed Audio generieren
Setze MAGE_API_KEY, sende die Anfrage und frage den Status ab, bis sie abgeschlossen ist. Ersetze seed_audio in der URL durch ein beliebiges Modell oben.
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"])So funktioniert's
Vom API-Schlüssel zum fertigen Medium in drei Aufrufen
Alle Modelle teilen sich ein Authentifizierungsschema, einen asynchronen Anfrageablauf und dieselben Feldnamen.
API-Schlüssel erstellen
Melde dich bei Mage an, öffne API → API Keys und erstelle einen Schlüssel. Er beginnt mit mage_sk_ und wird nur einmal angezeigt. Ein Konto kann 10 aktive Schlüssel haben.
Generierung senden
Sende per POST einen JSON-Body an https://api.mage.space/v1/{model}/generate, mit einem Authorization: Bearer-Header. Die Antwort kommt sofort und enthält eine request_id, einen status und eine status_url. Sende einen Idempotency-Key-Header, damit eine Wiederholung nie doppelt kostet.
Abfragen und herunterladen
Frage die status_url ab, bis der Status completed, failed oder cancelled ist. Eine abgeschlossene Anfrage enthält result.url mit der Bild-, Video- oder Audiodatei, die 30 Tage lang gespeichert bleibt.
Für den Produktiveinsatz gebaut
Das bekommt jede Anfrage an die Mage API
Zahlung pro Generierung
Kein Abo und kein Mindestumsatz. Du kaufst Gems, und jede Anfrage kostet ihren angegebenen Preis. Eine fehlgeschlagene Generierung wird erstattet, es sei denn, die Inhaltsrichtlinie von Mage hat sie blockiert.
Sichere Wiederholungen
Mit Idempotency-Keys liefert ein erneut gesendeter Request die ursprüngliche Anfrage zurück, ohne erneut abzurechnen.
Konsistente Charaktere
Speichere einen Charakter oder eine Referenz einmal und schreibe dann @handle in einen beliebigen Prompt, um sie mit jedem unterstützten Modell zu verwenden.
Große Eingaben
Sende Bild-, Video- und Audioeingaben als URLs oder Data-URLs oder lade Dateien bis 100 MB über einen signierten Upload hoch.
20 Generierungen gleichzeitig
Jedes Konto kann 20 Generierungen gleichzeitig ausführen, und das Limit lässt sich für deinen Anwendungsfall erhöhen. Abgelehnte Anfragen werden nie berechnet.
Anwendungsfälle
Was Entwickler mit der Audio-API bauen
Erzählung und Voiceover
Erzeuge Sprecherstimmen für Videos, Erklärfilme und Hörbücher, mit Reglern für Sprechtempo, Lautstärke und Tonhöhe.
Gleichbleibende Stimmen
Speichere einen Stimm-Clip als Referenz und nenne ihn per @handle, um in allen Clips dieselbe Stimme zu behalten.
Soundeffekte
Erstelle Ambiente, Foley und UI-Sounds aus einer Beschreibung für Spiele und Apps.
Hintergrundmusik
Erzeuge Hintergrundmusik für Social-Clips und Anzeigen aus einem Prompt.
Soundtracks für generierte Videos
Kombiniere Seed Audio mit der Video-API, um Clips aus Modellen ohne Ton Sound hinzuzufügen.
Agenten, die sprechen
Lass Claude, ChatGPT oder deinen eigenen Agenten über den MCP-Server oder die REST-API Audio erzeugen.
FAQ
Häufig gestellte Fragen
Kann die Audio-API Text-to-Speech?
Ja. Seed Audio liest ein Skript in einer beschriebenen Stimme oder in einer gespeicherten Stimmreferenz vor und bietet Einstellungen für Sprechtempo, Lautstärke und Tonhöhe. Aus demselben Prompt-Feld erzeugt es auch Musik und Soundeffekte.
Wie lang darf generiertes Audio sein?
Seed Audio generiert Clips von bis zu 120 Sekunden.
Was kostet die Mage API?
Es gibt kein Abo und keine monatliche Gebühr. Jede Generierung wird in Gems zum angegebenen Preis des Modells bezahlt, und 1.000 Gems kosten im Standardpaket 1 $. Jede Modellseite nennt den Preis bei Standardeinstellungen, und jede Antwort enthält die genaue Abrechnung. Eine fehlgeschlagene Generierung wird erstattet; eine, die von der Inhaltsrichtlinie von Mage blockiert wird, nicht. Eine Anfrage, die dein Guthaben nicht deckt, wird abgelehnt, bevor etwas berechnet wird.
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Nein. Die API läuft ausschließlich über Gems. Mitgliedschaften und ihre unbegrenzten Generierungen in der App gelten nicht für API-Anfragen, daher kann jedes Mage-Konto mit Gems sie nutzen.
Kann ich API-Ergebnisse kommerziell nutzen?
Ja. Inhalte, die du mit Mage erstellst, auch über die API und den MCP-Server, kannst du kommerziell nutzen. Eine Namensnennung freut uns, ist aber nicht erforderlich.
Welche Rate Limits gibt es?
Ein Account kann 20 Generierungen gleichzeitig in der Warteschlange haben oder ausführen. Jede weitere Anfrage wird mit 429 abgelehnt und kostet nichts. Schreib an [email protected], um das Limit für deinen Anwendungsfall zu erhöhen.
Kann mein KI-Agent die Mage API nutzen?
Ja. Agenten können die REST-API mit einem Key aufrufen oder sich mit dem Mage MCP-Server verbinden. Er gibt Claude, ChatGPT, Claude Code, Grok und Cursor sechzehn fertige Tools an die Hand, um ein Modell auszuwählen, den Preis abzufragen, zu generieren und das Ergebnis abzurufen. Siehe den MCP-Server.
Gibt es ein SDK für die Mage API?
Ja. Das offizielle Paket @mage-space/sdk auf npm und mage-space auf PyPI sind Open Source und für jedes Modell typisiert. Sie senden Anfragen, warten auf das Ergebnis, wiederholen Anfragen sicher und laden Dateien für dich hoch. Wer ComfyUI nutzt, kann das Node-Pack comfyui-mage installieren. Siehe die Mage SDKs.
Ich nutze bereits eine andere Generierungs-API. Was muss ich ändern?
Richte deinen Client auf https://api.mage.space/v1 aus, sende deinen Mage Key als Bearer-Token und ordne deine Felder der Modellseite zu: prompt, aspect_ratio, resolution, duration und model_id funktionieren bei jedem Mage Modell gleich. Anfragen laufen asynchron: Sende sie ab und frage dann status_url ab.
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.