음성, 음악, 사운드를 만드는 AI 오디오 생성 API

한눈에 보기

Mage 오디오 생성 API는 https://api.mage.space/v1/seed_audio/generate 에서 Seed Audio를 실행합니다. 텍스트 프롬프트를 보내면(음성 레퍼런스나 이미지는 선택 사항) 음성, 음악, 효과음이 담긴 최대 120초 길이의 오디오 파일을 받을 수 있습니다. 클립마다 Gems로 결제하며 구독은 필요 없습니다.

• 1

  오디오 모델

• $0.019

  클립당 최저 기본 가격

• 20

  동시 생성 수

• $0

  월 이용료

모델

Mage API의 모든 오디오 모델

가격은 생성 1회당 Gems 기준이에요. 표준 팩에서는 1,000 Gems가 $1이고, 더 큰 팩에는 보너스 Gems가 붙어요. 가격은 모델, 해상도, 길이에 따라 달라지며, 여기에는 기본 설정 가격이 표시돼요. 정확한 청구액은 응답의 billing.gems_charged에서 확인할 수 있어요. 생성에 실패하면 환불되지만, Mage의 콘텐츠 정책에 따라 차단된 경우에는 환불되지 않아요.

빠른 시작

Seed Audio로 오디오 생성하기

MAGE_API_KEY를 설정하고 요청을 보낸 뒤, 완료될 때까지 폴링하세요. URL의 seed_audio를 위의 다른 모델로 바꿔도 됩니다.

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

작동 방식

API 키부터 완성된 결과물까지, 세 번의 호출로

모든 모델이 하나의 인증 방식, 하나의 비동기 요청 흐름, 동일한 필드 이름을 공유합니다.

1. 01

   API 키 만들기

   Mage에 로그인한 뒤 API → API Keys에서 키를 만드세요. 키는 mage_sk_로 시작하며 한 번만 표시됩니다. 계정당 활성 키를 최대 10개까지 보유할 수 있습니다.

2. 02

   생성 요청하기

   Authorization: Bearer 헤더와 함께 https://api.mage.space/v1/{model}/generate로 JSON 본문을 POST하세요. 응답은 request_id, status, status_url과 함께 즉시 반환됩니다. Idempotency-Key 헤더를 보내면 재시도해도 중복 결제되지 않습니다.

3. 03

   상태 확인 및 다운로드

   status가 completed, failed, cancelled 중 하나가 될 때까지 status_url을 폴링하세요. 완료된 요청에는 이미지, 영상 또는 오디오 파일의 result.url이 담기며, 파일은 30일간 보관됩니다.

프로덕션을 위해 설계

모든 Mage API 요청에 제공되는 기능

활용 사례

개발자들이 오디오 API로 만드는 것들

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

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

관련 항목

• AI 이미지 생성 API
• AI 영상 생성 API
• Mage MCP 서버
• Mage SDK
• ComfyUI용 Mage
• 모든 API 모델
• API 플레이그라운드
• API 문서