Treci la conținut

API Mage · Model audio

API Seed Audio

Voci, muzică și efecte sonore dintr-un singur prompt

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

Pe scurt

API-ul Seed Audio rulează Seed Audio prin Mage, la POST https://api.mage.space/v1/seed_audio/generate. O cerere cu setările implicite costă 19 Gems (aproximativ 0,019 $), fără abonament. Seed Audio folosește referințe audio salvate prin @handle în prompt.

  • AudioRezultat
  • 1Variantă
  • 19Gems per clip, implicit
  • $0.019Aproximativ, în USD

Prezentare generală

Ce face API-ul Seed Audio

Vorbire, dialog, muzică și efecte sonore dintr-un singur prompt, ca MP3 cu exact durata cerută, de la 5 secunde la 2 minute. Potrivește o voce pornind de la cel mult 3 clipuri audio.

Voci, dialog, muzică și efecte sonore dintr-un singur prompt, ca MP3 cu exact durata cerută.

Acceptă image ca intrare.

Pornire rapidă

Apelează API-ul Seed Audio

Setează MAGE_API_KEY, trimite cererea la /seed_audio/generate și interoghează status_url până când cererea se termină.

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

Modele

Valorile model_id pentru Seed Audio

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
seed-audio-1.0Seed AudioDa

Opțiuni

Parametrii Seed Audio

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
duration5, 10, 30, 60, 120

Intrări

Fișiere media acceptate de Seed Audio

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.

Reguli

Ce reguli impune API-ul Seed Audio

  • O referință de imagine nu poate fi combinată cu referințe audio: trimite doar un tip sau celălalt.
  • Promptul are cel mult 2986 de caractere.
  • `sample_rate` este una dintre valorile 8000, 16000, 24000, 32000, 44100, 48000.
  • `speech_rate` este un număr întreg între -50 și 100.
  • `loudness_rate` este un număr întreg între -50 și 100.
  • `pitch_rate` este un număr întreg între -12 și 12.

Mai multe modele audio

Alte API-uri de generare audio pe Mage

    Întrebări frecvente

    Întrebări frecvente

    Cât costă API-ul Seed Audio?
    O cerere Seed Audio cu setările implicite (Seed Audio) costă 19 Gems, aproximativ 0,019 $. Alte rezoluții, durate și variante schimbă prețul; răspunsul indică exact suma taxată. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
    Care este endpoint-ul API-ului Seed Audio?
    POST https://api.mage.space/v1/seed_audio/generate, cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
    Ce modele Seed Audio pot apela?
    seed-audio-1.0 (Seed Audio). Modelul implicit este Seed Audio.
    Acceptă Seed Audio imagini de referință sau personaje?
    Seed Audio acceptă image. Seed Audio folosește referințe audio salvate prin @handle în prompt.
    Pot folosi Seed Audio din Claude sau ChatGPT?
    Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Seed Audio pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte de a genera.
    Cât timp sunt păstrate rezultatele Seed Audio?
    Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

    Începe să construiești cu Mage

    Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.