Suno v6 API가 제공하는 것
Suno v6 API를 사용하면 서버 측 애플리케이션이 텍스트 프롬프트나 커스텀 가사로 완성곡을 만들 수 있습니다. chirp-v6 패밀리에서 모델을 고르고 POST 요청 한 번을 보내면 비동기 작업의 workId를 받습니다. 보컬, 구성, 편곡은 모두 자동으로 만들어집니다.
세 개의 현재 모델이 같은 엔드포인트를 공유합니다. chirp-v6은 프로덕션 릴리스용 플래그십이고, chirp-v6-mini는 대량 작업이나 프로토타입용의 빠르고 경제적인 티어이며, chirp-v6-wild는 더 자유롭고 실험적인 편곡을 위한 변형입니다. 모든 결과는 실제로 오디오를 생성한 모델을 model_name으로 보고하므로 레거시 연동을 안전하게 마이그레이션할 수 있습니다.
빠른 시작: 태스크 생성 및 폴링
인증된 POST를 /v2/generate에 보내고, 반환된 workId를 저장한 뒤 태스크가 완료될 때까지 /v2/feed를 폴링하세요. 또는 callback_url을 전달해 webhook을 기다리면 됩니다.
curl -X POST "https://udioapi.pro/api/v2/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "chirp-v6",
"prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
"style": "pop, upbeat, electronic, 120 bpm",
"title": "Summer Dreams",
"make_instrumental": false
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"생성은 비동기입니다. 5~10초 간격으로 제한된 시간 내 폴링하고, 오디오 URL은 빠르게 다운로드하세요. 미디어 링크는 임시입니다.
Suno v6 모델 및 가격
세 모델 모두 generate, upload-cover, extend에서 사용할 수 있습니다. 가격은 요청당이며 1 USD = 100 크레딧입니다.
| 모델 | 크레딧 | ≈ USD | 포지셔닝 |
|---|---|---|---|
| chirp-v6 | 12 | ≈ $0.12 | 플래그십 — 프로덕션 릴리스용 최고 충실도 곡 |
| chirp-v6-mini | 10 | ≈ $0.10 | 빠르고 경제적 — 배치 작업과 프로토타이핑 |
| chirp-v6-wild | 12 | ≈ $0.12 | 더 실험적 — 과감한 편곡 |
레거시 식별자는 기존 가격 그대로 계속 작동합니다. chirp-v5와 chirp-v5-5는 chirp-v6이, chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v4-5-all은 chirp-v6-mini가 처리합니다. model 필드를 생략하면 5크레딧 기본 티어로 chirp-v6-mini가 처리합니다.
무엇을 만들 수 있나요
같은 계정과 API 키로 문서화된 오디오 엔드포인트를 모두 사용할 수 있습니다.
텍스트와 가사로 곡 생성
가사, 스타일, 제목을 지정하는 커스텀 모드 또는 간단한 설명만으로 되는 인스피레이션 모드. 선택적 image_urls로 분위기를 조정합니다.
문서 읽기기존 트랙 연장
상속 설정 또는 새 프롬프트로 생성된 곡을 이어가고 feed에서 결과를 받습니다.
문서 읽기내 오디오 커버
오디오를 업로드하고 upload-cover 엔드포인트로 커버 버전을 생성합니다.
문서 읽기타임스탬프 가사
줄 단위 가사 타이밍을 가져와 가라오케 스타일 또는 싱크 가사 경험을 구현합니다.
문서 읽기WAV 변환
생성된 트랙을 WAV로 변환해 마스터링 또는 방송 파이프라인에 사용합니다.
문서 읽기Webhook 및 폴링
태스크 완료는 feed 폴링과 callback 알림 중에서 선택할 수 있습니다.
문서 읽기작동 방식
API 키에서 재생 가능한 트랙까지 네 단계.
- 1
API 키 생성
로그인 후 대시보드에서 키를 복사하세요. 서버 측 비밀로 보관하고 브라우저 코드에는 절대 넣지 마세요.
- 2
태스크 제출
모델과 프롬프트를 담아 /v2/generate에 POST합니다. 응답은 비동기 작업의 workId를 반환합니다.
- 3
폴링 또는 콜백 수신
5~10초마다 GET /v2/feed?workId=...를 호출하거나 callback_url을 전달해 완료 webhook을 처리합니다.
- 4
오디오 다운로드
SUCCESS가 되면 feed 응답에 임시 오디오 URL이 포함됩니다. 파일을 자체 스토리지에 저장하세요.
제한 및 참고 사항
- 모든 생성 엔드포인트는 비동기입니다. POST 응답에는 오디오가 아닌 workId가 포함됩니다.
- /v2/feed를 제한된 재시도로 폴링하거나 callback_url로 서버 간 전달을 사용하세요.
- chirp-v5와 chirp-v5-5 요청은 chirp-v6 오디오를, 그 이전 레거시 식별자는 chirp-v6-mini를 생성합니다.
- 미디어 URL은 임시입니다. 결과를 자체 스토리지에 다운로드해 보존하세요.
- 프롬프트, 제목, 스타일은 문서화된 제한 내로 유지하세요. 초과분은 잘립니다.
udioapi.pro는 독립적인 제3자 서비스입니다. Suno, Udio, MiniMax와 제휴하거나 보증받거나 운영되지 않습니다.
Suno v6 API FAQ
모델, 과금, 비동기 워크플로에 대한 답변.
이것이 Suno 공식 API인가요?
아니요. udioapi.pro는 자체 엔드포인트, 계정, 크레딧, 약관, 지원을 갖춘 독립적인 제3자 API 서비스입니다. Suno 또는 Udio와 제휴하거나 보증받거나 운영되지 않습니다.
어떤 Suno v6 모델부터 시작해야 하나요?
프로토타이핑과 대량 작업에는 chirp-v6-mini — 10크레딧의 빠르고 경제적인 티어를 사용하세요. 플래그십 품질이 필요하면 chirp-v6(12크레딧), 더 실험적인 결과물에는 chirp-v6-wild로 전환하세요.
요청당 비용은 얼마인가요?
chirp-v6과 chirp-v6-wild는 요청당 12크레딧, chirp-v6-mini는 10크레딧입니다. 1 USD = 100 크레딧 기준으로 곡당 약 $0.10~$0.12입니다. model을 생략하면 chirp-v6-mini가 처리하는 5크레딧 기본 티어로 과금됩니다.
생성된 오디오는 어떻게 받나요?
승인된 모든 요청은 workId를 반환합니다. 5~10초마다 GET /v2/feed?workId=...를 폴링해 상태가 SUCCESS가 될 때까지 기다리거나 callback_url로 webhook을 받으세요. feed 응답에 오디오 URL이 포함됩니다.
예전 모델 식별자도 계속 쓸 수 있나요?
네. chirp-v5와 chirp-v5-5는 chirp-v6이, chirp-v3-5부터 chirp-v4-5-all까지는 chirp-v6-mini가 각각 기존 가격으로 처리합니다. model_name이 실제 오디오를 생성한 모델을 보고합니다.
생성된 곡을 연장하거나 커버할 수 있나요?
네 — chirp-v6 패밀리는 generate, upload-cover, extend에서 사용 가능합니다. 연장은 원본 트랙의 모델 가격으로 과금되며, 거부되거나 실패한 요청은 환불됩니다.