
스타일 설명을 바탕으로 보컬, 편곡, 믹싱, 또는 연주곡과 커버곡을 포함한 완전한 곡을 씁니다.
스타일 설명을 바탕으로 보컬, 편곡, 믹싱, 또는 연주곡과 커버곡을 포함한 완전한 곡을 씁니다.
생성은 비동기식이며 보통 수십 초에서 몇 분 정도 소요됩니다.
다른 이름 StepFun StepAudio 3 Music
stepaudio-3-music/v1/audio/generationsstepaudio-3-music-previewstepfun/stepaudio-3-musicEmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
StepAudio 3 Music은(는) POST /v1/audio/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
curl https://api.empiriolabs.ai/v1/audio/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "stepaudio-3-music",
"prompt": "Describe what you want StepAudio 3 Music to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/audio/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "stepaudio-3-music",
"prompt": "Describe what you want StepAudio 3 Music to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs에서 StepAudio 3 Music API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| prompt | string | - | - | 스타일 설명: 장르, 보컬, 분위기, 악기, 그리고 조. |
| lyrics | string | - | - | 선택 가사. [Verse], [Chorus], [Outro]와 같은 섹션 태그가 구조를 형성합니다. 비워 두면 모델이 이를 작성합니다. 커버곡이나 보컬 편곡에 필수입니다. |
| task | enum | text_to_music | text_to_music, music_cover, vocal_to_music | 새 곡을 쓰거나, 참조곡을 커버하거나, 건조한 보컬을 중심으로 편곡을 만들어보세요. |
| instrumental | boolean | false | - | 보컬이 없는 트랙을 생성하세요. 가사와 결합할 수 없습니다. |
| song_audio | string | - | - | Base64 참조 곡. 커버곡에 필수. |
| vocal_audio | string | - | - | 반주 없는 베이스64 드라이 보컬. 보컬 편곡에 필수. |
| response_format | enum | mp3 | mp3, wav, flac, opus, pcm | 출력 오디오 형식. |
| temperature | number | 0.85 | 0.01 ~ 2 | 샘플링 온도. 온도가 높을수록 더 다양합니다. |
| top_p | number | 0.92 | 0 ~ 1 | 핵 샘플링 확률 질량. |
| lyrics_rewrite | boolean | false | - | 모델이 당신이 제공한 가사를 다시 쓰게 하세요. |
스타일을 설명하면 모델이 완전한 곡을 쓰고 연주합니다. 가사를 제공하거나 모델이 직접 쓰게 하거나, 보컬이 없는 트랙에 연주곡을 설정하거나, 커버곡이나 드라이 보컬을 참고할 곡을 첨부해 편곡을 구성하세요. [Verse], [Chorus], [Outro]와 같은 섹션 태그가 구조를 형성합니다. 출력 길이는 모델이 결정하며 보통 1분에서 3분까지이므로 매개변수로 정해지지 않고 같은 프롬프트를 두 번 반복할 경우 다를 수 있습니다. 청구는 생성된 길이를 따릅니다. 기악곡과 가사는 결합할 수 없습니다. 이 모델은 미리보기 단계이며 기능이 변경될 수 있습니다.
EmpirioLabs에서 StepAudio 3 Music은(는) 종량제로 청구됩니다: 음악 생성 $0.0018 생성된 초당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
StepAudio 3 Music은(는) api.empiriolabs.ai의 POST /v1/audio/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 StepAudio 3 Music을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.