The AI audio generation API for voices, music, and sound

At a glance

The Mage audio generation API runs Seed Audio at https://api.mage.space/v1/seed_audio/generate. Send a text prompt, optionally with voice references or an image, and receive an audio file up to 120 seconds long with voices, music, or sound effects. Each clip is paid in Gems, with no subscription.

• 1

  audio models

• $0.019

  Cheapest default, per clip

• 20

  Concurrent generations

• $0

  Monthly fee

Models

Every audio model in the Mage API

Prices are per generation, in Gems. 1,000 Gems cost $1 on the standard pack, and larger packs add bonus Gems. The price depends on the model, resolution, and duration; the default-settings price is shown, and every response reports the exact charge in billing.gems_charged. A generation that fails is refunded; one Mage's content policy blocks is not.

Quick start

Generate audio with Seed Audio

Set MAGE_API_KEY, submit the request, and poll until it completes. Swap seed_audio in the URL for any model above.

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"

import os, time, requests

headers = {"Authorization": f"Bearer {os.environ['MAGE_API_KEY']}"}
request = requests.post(
    "https://api.mage.space/v1/seed_audio/generate",
    headers=headers,
    json={
      "prompt": "A calm narrator reading a short weather report",
      "duration": "5",
      "model_id": "seed-audio-1.0"
    },
).json()

while request["status"] in ("queued", "in_progress"):
    time.sleep(3)
    request = requests.get(request["status_url"], headers=headers).json()

print(request["status"], request["result"] and request["result"]["url"])

const headers = {
  Authorization: `Bearer ${process.env.MAGE_API_KEY}`,
  'Content-Type': 'application/json',
};
let request = await fetch('https://api.mage.space/v1/seed_audio/generate', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    "prompt": "A calm narrator reading a short weather report",
    "duration": "5",
    "model_id": "seed-audio-1.0"
  }),
}).then((response) => response.json());

while (['queued', 'in_progress'].includes(request.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  request = await fetch(request.status_url, { headers }).then((r) => r.json());
}

console.log(request.status, request.result?.url);

How it works

From API key to finished media in three calls

Every model shares one authentication scheme, one asynchronous request lifecycle, and the same field names.

1. 01

   Create an API key

   Sign in to Mage, open API → API Keys, and create a key. It starts with mage_sk_ and is shown once. An account can hold 10 active keys.

2. 02

   Submit a generation

   POST a JSON body to https://api.mage.space/v1/{model}/generate with an Authorization: Bearer header. The response returns at once with a request_id, a status, and a status_url. Send an Idempotency-Key header so a retry never pays twice.

3. 03

   Poll and download

   Poll status_url until the status is completed, failed, or cancelled. A completed request carries result.url with the image, video, or audio file, kept for 30 days.

Built for production

What every Mage API request gets

Use cases

What developers build with the audio API

FAQ

Frequently asked questions

Start building with Mage

One account, one Gems balance, every model. Pay only for what you generate.

Related

• AI image generation API
• AI video generation API
• Mage MCP server
• All API models
• API playground
• API documentation