Przejdź do treści

API Mage · Model audio

API Seed Audio

Głosy, muzyka i efekty dźwiękowe z jednego promptu

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

W skrócie

API Seed Audio uruchamia Seed Audio przez Mage pod adresem POST https://api.mage.space/v1/seed_audio/generate. Żądanie z ustawieniami domyślnymi kosztuje 19 Gems (około 0,019 $), bez subskrypcji. Seed Audio przyjmuje zapisane referencje audio przez @handle w prompcie.

  • AudioWynik
  • 1Wariant
  • 19Gems za klip, domyślnie
  • $0.019Około, w USD

Przegląd

Co potrafi API Seed Audio

Mowa, dialogi, muzyka i efekty dźwiękowe z jednego promptu, jako plik MP3 dokładnie o zadanej długości, od 5 sekund do 2 minut. Dopasuj głos na podstawie maksymalnie 3 klipów audio.

Głosy, dialogi, muzyka i efekty dźwiękowe z jednego promptu, jako plik MP3 dokładnie o żądanym czasie trwania.

Jako dane wejściowe przyjmuje image.

Szybki start

Wywołaj API Seed Audio

Ustaw MAGE_API_KEY, wyślij żądanie do /seed_audio/generate i odpytuj status_url, aż żądanie się zakończy.

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

Wartości model_id dla Seed Audio

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
seed-audio-1.0Seed AudioTak

Opcje

Parametry Seed Audio

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
duration5, 10, 30, 60, 120

Dane wejściowe

Dane wejściowe, które akceptuje Seed Audio

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.

Zasady

Jakie ograniczenia egzekwuje API Seed Audio

  • Referencji obrazu nie można łączyć z referencjami audio: wyślij jeden rodzaj albo drugi.
  • Prompt ma maksymalnie 2986 znaków.
  • `sample_rate` to jedna z wartości: 8000, 16000, 24000, 32000, 44100, 48000.
  • `speech_rate` to liczba całkowita od -50 do 100.
  • `loudness_rate` to liczba całkowita od -50 do 100.
  • `pitch_rate` to liczba całkowita od -12 do 12.

Więcej modeli audio

Inne API do generowania dźwięku w Mage

  • Audio · od 113 Gems

    Eleven Music API

    Piosenki ElevenLabs z wokalem lub bez

  • Audio · od 30 Gems

    Eleven Speech API

    ElevenLabs v4: realistyczna mowa, którą możesz reżyserować

  • Dźwięk · od 125 Gems

    MiniMax Music 3 API

    Pełne piosenki z twojego tekstu, otwarte wagi

FAQ

Najczęściej zadawane pytania

Ile kosztuje API Seed Audio?
Żądanie Seed Audio z ustawieniami domyślnymi (Seed Audio) kosztuje 19 Gems, czyli około 0,019 $. Inne rozdzielczości, długości i warianty zmieniają cenę, a dokładną kwotę podaje odpowiedź. Za nieudaną generację zwracamy koszt, ale nie za taką, którą zablokowały zasady dotyczące treści Mage.
Jaki jest endpoint API Seed Audio?
POST https://api.mage.space/v1/seed_audio/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz o wynik.
Które modele Seed Audio mogę wywołać?
seed-audio-1.0 (Seed Audio). Domyślny to Seed Audio.
Czy Seed Audio obsługuje obrazy referencyjne lub postacie?
Seed Audio akceptuje image. Seed Audio przyjmuje zapisane referencje audio przez @handle w prompcie.
Czy mogę używać Seed Audio z poziomu Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Seed Audio po nazwie. Twój asystent odczyta opcje modelu przez get_model i poda cenę przed generowaniem.
Jak długo są przechowywane wyniki Seed Audio?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

CharactersSpołeczność