Seed Audio API

한눈에 보기

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을 폴링하세요.

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"

// 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);

# 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를 보내 버전을 선택하세요. 지정하지 않으면 기본 모델이 실행됩니다.

옵션

Seed Audio 파라미터

모든 버전에서 허용되는 값입니다. 일부 버전은 지원 범위가 더 좁을 수 있습니다. 버전별 옵션은 문서에서 확인하세요.

입력

Seed Audio에서 사용할 수 있는 미디어 입력

각각 https URL, data URL 또는 최대 100 MB 업로드로 보내세요.

규칙

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

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.

관련 항목

• AI 오디오 생성 API
• Seed Audio API 레퍼런스
• Seed Audio 플레이그라운드
• 모든 API 모델
• Mage MCP 서버