Přeskočit na obsah

Mage API · Audio model

Seed Audio API

Hlasy, hudba a zvukové efekty z jednoho promptu

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

Stručně

Seed Audio API spouští Seed Audio přes Mage na POST https://api.mage.space/v1/seed_audio/generate. Požadavek s výchozím nastavením stojí 19 Gems (asi 0,019 $), bez předplatného. Seed Audio přijímá uložené zvukové reference přes @handle v promptu.

  • ZvukVýstup
  • 1Varianta
  • 19Gems za klip, výchozí
  • $0.019Přibližně v USD

Přehled

Co umí Seed Audio API

Řeč, dialogy, hudba a zvukové efekty z jediného promptu, jako MP3 přesně v požadované délce, od 5 sekund do 2 minut. Napodob hlas až ze 3 zvukových klipů.

Hlasy, dialogy, hudba a zvukové efekty z jednoho promptu, jako MP3 přesně v požadované délce.

Jako vstup přijímá image.

Rychlý start

Volání Seed Audio API

Nastav MAGE_API_KEY, odešli požadavek na /seed_audio/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Seed Audio

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
seed-audio-1.0Seed AudioAno

Možnosti

Parametry Seed Audio

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
duration5, 10, 30, 60, 120

Vstupy

Vstupní média, která Seed Audio přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.

Pravidla

Co Seed Audio API vynucuje

  • Obrázkovou referenci nelze kombinovat se zvukovými referencemi: pošli jen jeden druh.
  • Prompt má nejvýše 2986 znaků.
  • `sample_rate` je jedna z hodnot 8000, 16000, 24000, 32000, 44100, 48000.
  • `speech_rate` je celé číslo od -50 do 100.
  • `loudness_rate` je celé číslo od -50 do 100.
  • `pitch_rate` je celé číslo od -12 do 12.

Další audio modely

Další API pro generování zvuku na Mage

    Časté dotazy

    Často kladené otázky

    Kolik stojí Seed Audio API?
    Požadavek na Seed Audio s výchozím nastavením (Seed Audio) stojí 19 Gems, asi 0,019 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Neúspěšné generování se vrací zpět; generování zablokované pravidly obsahu Mage ne.
    Jaký je endpoint Seed Audio API?
    POST https://api.mage.space/v1/seed_audio/generate s hlavičkou Authorization: Bearer obsahující tvůj klíč Mage API. Odpověď obsahuje status_url, na který se dotazuješ na výsledek.
    Které modely Seed Audio mohu volat?
    seed-audio-1.0 (Seed Audio). Výchozí je Seed Audio.
    Podporuje Seed Audio referenční obrázky nebo postavy?
    Seed Audio přijímá image. Seed Audio přijímá uložené zvukové reference přes @handle v promptu.
    Mohu používat Seed Audio z Claude nebo ChatGPT?
    Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursoru a požádej o Seed Audio jménem. Tvůj asistent si přečte jeho možnosti přes get_model a před generováním sdělí cenu.
    Jak dlouho se uchovávají výsledky Seed Audio?
    Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

    Začni tvořit s Mage

    Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.