Mage API · 오디오 모델
Seed Audio API
프롬프트 하나로 음성, 음악, 효과음까지
POST https://api.mage.space/v1/seed_audio/generate한눈에 보기
Seed Audio API는 POST https://api.mage.space/v1/seed_audio/generate를 통해 Mage에서 Seed Audio를 실행합니다. 기본 설정의 요청은 19 Gems(약 $0.019)이며 구독이 필요 없습니다. Seed Audio는 프롬프트에 @handle을 넣어 저장된 오디오 레퍼런스를 사용할 수 있습니다.
- 오디오출력
- 1버전
- 19클립당 Gems(기본)
- $0.019약 USD 기준
개요
Seed Audio API로 할 수 있는 일
프롬프트 하나로 음성, 대화, 음악, 효과음을 만들고, 원하는 길이(5초~2분)에 정확히 맞춘 MP3로 받아 보세요. 최대 3개의 오디오 클립으로 목소리를 맞출 수도 있습니다.
프롬프트 하나로 음성, 대화, 음악, 효과음을 만들고, 요청한 길이에 정확히 맞춘 MP3로 받아 보세요.
입력으로 image를 받습니다.
빠른 시작
Seed Audio API 호출하기
MAGE_API_KEY를 설정하고 /seed_audio/generate로 요청을 보낸 뒤, 요청이 완료될 때까지 status_url을 폴링하세요.
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"])모델
Seed Audio model_id 값
model_id를 보내 버전을 선택하세요. 지정하지 않으면 기본 모델이 실행됩니다.
| model_id | 이름 | 기본값 |
|---|---|---|
| seed-audio-1.0 | Seed Audio | 예 |
옵션
Seed Audio 파라미터
모든 버전에서 허용되는 값입니다. 일부 버전은 지원 범위가 더 좁을 수 있습니다. 버전별 옵션은 문서에서 확인하세요.
| 필드 | 값 |
|---|---|
| duration | 5, 10, 30, 60, 120 |
입력
Seed Audio에서 사용할 수 있는 미디어 입력
각각 https URL, data URL 또는 최대 100 MB 업로드로 보내세요.
| 필드 | 역할 |
|---|---|
| image | 기준 레퍼런스 이미지. |
규칙
Seed Audio API의 제한 사항
- 이미지 레퍼런스와 오디오 레퍼런스는 함께 사용할 수 없습니다. 한 가지만 보내 주세요.
- 프롬프트는 최대 2986자입니다.
- `sample_rate`는 8000, 16000, 24000, 32000, 44100, 48000 중 하나입니다.
- `speech_rate`는 -50에서 100 사이의 정수입니다.
- `loudness_rate`는 -50에서 100 사이의 정수입니다.
- `pitch_rate`는 -12에서 12 사이의 정수입니다.
다른 오디오 모델
Mage의 다른 오디오 생성 API
Eleven Music API
보컬이 있거나 없는 ElevenLabs 노래
Eleven Speech API
ElevenLabs v4: 직접 연출할 수 있는 생생한 음성
MiniMax Music 3 API
가사로 만드는 완성곡, 오픈 웨이트
FAQ
자주 묻는 질문
Seed Audio API 요금은 얼마인가요?
Seed Audio API 엔드포인트는 무엇인가요?
어떤 Seed Audio 모델을 호출할 수 있나요?
Seed Audio는 참조 이미지나 캐릭터를 지원하나요?
Claude나 ChatGPT에서 Seed Audio를 쓸 수 있나요?
Seed Audio 결과물은 얼마 동안 보관되나요?
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.