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.
Audio
Wynik
1
Wariant
19
Gems za klip, domyślnie
$0.019
Okoł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_id | Nazwa | Domyślny |
|---|---|---|
| seed-audio-1.0 | Seed Audio | Tak |
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.
| Pole | Wartości |
|---|---|
| duration | 5, 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.
| Pole | Rola |
|---|---|
| image | Obraz 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
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.