오디오 API
텍스트 프롬프트로 음악을 생성합니다. 비동기로 동작하며, task_id를 반환합니다.
엔드포인트
POST
/api/v1/audio/generations공통 요청 파라미터
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
model* | string | * 필수 | 사용할 오디오 모델 ID. 현재 "suno"를 지원합니다. | - |
prompt* | string | * 필수 | 음악 설명 또는 가사. 장르, 분위기, 악기 등을 포함하면 좋습니다. | - |
duration | number | 선택 | 트랙 길이 (초). 최대 240초까지 지원합니다. | - |
style | string | 선택 | 음악 스타일. 예: "pop", "jazz", "classical", "electronic" | - |
응답 필드
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
task_id* | string | * 필수 | 비동기 작업 ID. 음악 생성은 비동기로 처리됩니다. | - |
status* | string | * 필수 | 작업 상태. "queued" | "running" | "completed" | "failed" | - |
estimated_time | number | 선택 | 예상 소요 시간 (초) | - |
코드 예제
curl -X POST https://api.billing-ai.kr/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"prompt": "밝고 경쾌한 팝 음악, 봄날의 산책을 떠올리는 멜로디",
"duration": 120,
"style": "pop"
}'