Mage API · Audiogeneratie

De AI-audio-API voor stemmen, muziek en geluid

Spraak, voice-overs, muziek en geluidseffecten vanuit één prompt met Seed Audio, met stemreferenties en instellingen voor spreektempo, volume en toonhoogte.

Vraag een API-sleutel aanLees de API-documentatie
POST https://api.mage.space/v1/{model}/generate

In één oogopslag

De Mage API voor audiogeneratie draait Seed Audio op https://api.mage.space/v1/seed_audio/generate. Stuur een tekstprompt, eventueel met stemreferenties of een afbeelding, en ontvang een audiobestand van maximaal 120 seconden met stemmen, muziek of geluidseffecten. Elke clip betaal je in Gems, zonder abonnement.

Modellen

Alle audiomodellen in de Mage API

Prijzen gelden per generatie, in Gems. 1.000 Gems kosten $1 in het standaardpakket, en grotere pakketten bevatten extra Gems. De prijs hangt af van model, resolutie en duur; getoond wordt de prijs bij standaardinstellingen, en elke respons geeft de exacte kosten weer in billing.gems_charged. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.

ModelHet meest geschikt voormodel_id-waardenStandaardprijs
Seed AudioStemmen, muziek en geluidseffecten vanuit één promptseed-audio-1.019 Gems ($0.019)

Snel starten

Audio genereren met Seed Audio

Stel MAGE_API_KEY in, verstuur het verzoek en poll tot het klaar is. Vervang seed_audio in de URL door een van de modellen hierboven.

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"])

Zo werkt het

Van API-sleutel tot kant-en-klare media in drie aanroepen

Elk model gebruikt hetzelfde authenticatieschema, dezelfde asynchrone aanvraagcyclus en dezelfde veldnamen.

  1. Maak een API-sleutel aan

    Log in bij Mage, open API → API Keys en maak een sleutel aan. Die begint met mage_sk_ en wordt maar één keer getoond. Een account kan 10 actieve sleutels hebben.

  2. Dien een generatie in

    Stuur een POST met een JSON-body naar https://api.mage.space/v1/{model}/generate met een Authorization: Bearer-header. Het antwoord komt direct terug met een request_id, een status en een status_url. Stuur een Idempotency-Key-header mee, zodat een nieuwe poging nooit dubbel kost.

  3. Poll en download

    Poll status_url tot de status completed, failed of cancelled is. Een voltooid verzoek bevat result.url met het afbeeldings-, video- of audiobestand, dat 30 dagen bewaard blijft.

Gebouwd voor productie

Dit krijgt elke Mage API-aanvraag

Eén sleutel, elk model

28 afbeeldings-, video- en audiomodellen achter één REST API en één Gems-saldo. Wissel van model door het URL-pad te wijzigen.

Betaal per generatie

Geen abonnement en geen minimumbesteding. Je koopt Gems en elke aanvraag kost de vermelde prijs. Een mislukte generatie wordt terugbetaald, tenzij het contentbeleid van Mage deze heeft geblokkeerd.

Veilig opnieuw proberen

Met idempotentiesleutels geeft een opnieuw verzonden aanvraag de oorspronkelijke aanvraag terug, zonder nogmaals kosten te rekenen.

Consistente personages

Sla een personage of referentie één keer op en schrijf daarna @handle in een prompt om het te gebruiken met elk model dat dit ondersteunt.

Grote invoer

Stuur afbeeldings-, video- en audio-invoer als URL's of data-URL's, of upload bestanden tot 100 MB via een ondertekende upload.

20 generaties tegelijk

Elk account kan 20 generaties tegelijk uitvoeren en de limiet kan voor jouw toepassing worden verhoogd. Geweigerde aanvragen worden nooit in rekening gebracht.

Toepassingen

Wat ontwikkelaars bouwen met de audio-API

Verteltekst en voice-over

Genereer voice-overs voor video's, uitlegvideo's en audioboeken, met instellingen voor spreektempo, volume en toonhoogte.

Consistente stemmen

Sla een stemclip op als referentie en noem die met een @handle om in alle clips dezelfde stem te houden.

Geluidseffecten

Maak omgevingsgeluid, foley en UI-geluiden op basis van een beschrijving, voor games en apps.

Achtergrondmuziek

Maak achtergrondmuziek voor socialmediaclips en advertenties vanuit een prompt.

Soundtracks voor gegenereerde video

Combineer Seed Audio met de video-API om geluid toe te voegen aan clips van modellen zonder audio.

Agents die praten

Laat Claude, ChatGPT of je eigen agent audio maken via de MCP-server of de REST API.

FAQ

Veelgestelde vragen

Kan de audio-API tekst omzetten naar spraak?

Ja. Seed Audio leest een script voor in een beschreven stem of in een opgeslagen stemreferentie en biedt instellingen voor spreektempo, volume en toonhoogte. Het genereert ook muziek en geluidseffecten vanuit hetzelfde promptveld.

Hoe lang mag gegenereerde audio zijn?

Seed Audio genereert clips tot 120 seconden.

Hoeveel kost de Mage API?

Er is geen abonnement of maandelijks bedrag. Elke generatie betaal je in Gems tegen de vermelde prijs van het model, en 1.000 Gems kosten $1 met het standaardpakket. Op elke modelpagina staat de prijs met standaardinstellingen en elke respons toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet. Een aanvraag die je saldo niet dekt, wordt geweigerd voordat er iets in rekening wordt gebracht.

Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?

Nee. De API werkt alleen met Gems. Lidmaatschappen en hun onbeperkte generatie in de app gelden niet voor API-aanvragen, dus elk Mage-account met Gems kan de API aanroepen.

Mag ik API-uitvoer commercieel gebruiken?

Ja. Content die je met Mage maakt, ook via de API en de MCP-server, mag je commercieel gebruiken. Naamsvermelding wordt gewaardeerd, maar is niet verplicht.

Wat zijn de rate limits?

Een account kan 20 generaties tegelijk in de wachtrij hebben of laten lopen. Een aanvraag daarboven wordt geweigerd met een 429 en kost niets. Mail naar [email protected] om de limiet te verhogen voor jouw toepassing.

Kan mijn AI-agent de Mage API gebruiken?

Ja. Agents kunnen de REST API aanroepen met een sleutel, of verbinden met de Mage MCP-server, die Claude, ChatGPT, Claude Code, Grok en Cursor zestien kant-en-klare tools geeft om een model te kiezen, de prijs op te vragen, te genereren en het resultaat op te halen. Zie de MCP-server.

Is er een SDK voor de Mage API?

Ja. De officiële pakketten @mage-space/sdk op npm en mage-space op PyPI zijn open source en getypeerd voor elk model. Ze dienen aanvragen in, wachten op het resultaat, proberen veilig opnieuw en uploaden bestanden voor je. ComfyUI-gebruikers kunnen het nodepakket comfyui-mage installeren. Zie de Mage SDK's.

Ik gebruik al een andere generatie-API. Wat moet ik wijzigen?

Richt je client op https://api.mage.space/v1, stuur je Mage-sleutel mee als Bearer-token en koppel je velden aan de modelpagina: prompt, aspect_ratio, resolution, duration en model_id werken bij elk Mage-model hetzelfde. Aanvragen zijn asynchroon, dus dien eerst in en poll daarna status_url.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Vraag een API-sleutel aanLees de API-documentatie

Gerelateerd