플레이그라운드
Udio, 지금 바로 사용해 보세요.
고급 설정
출력이 여기에 표시됩니다. 생성을 누르면 Studio에서 이 요청이 실행됩니다.
요금
단순한 생성당 과금.
1–12 크레딧 / 생성 1회당 ≈ $0.01–$0.12
요금은 선택한 해상도와 옵션에 따라 달라집니다.
- 성공한 생성에 대해서만 비용을 지불합니다. 실패한 작업은 자동으로 환불됩니다.
- Apiframe의 모든 모델에서 하나의 크레딧 잔액을 사용합니다. 모델별 요금제가 없습니다.
- 무료 크레딧으로 시작하세요. 구독이 필요 없습니다.
- 대용량 플랜에는 볼륨 할인이 적용됩니다.
스펙
한눈에 보기.
빠른 시작
Udio API 호출 방법.
API 키와 함께 POST /v2/music/generate 요청 하나만 보내세요. 호출은 폴링할 수 있는 jobId를 반환하며, webhook_url을 전달하면 결과가 준비되는 즉시 푸시됩니다.
모델 값 udio만 다른 모델로 바꾸면 나머지는 그대로입니다.
const response = await fetch("https://api.apiframe.ai/v2/music/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "an upbeat synthwave track with a driving bassline",
"model": "udio",
"udioParams": {
"lyrics_type": "generate",
"lyrics": "Optional — your own words",
"lyrics_prompt": "e.g. leaving a small town at dawn",
"title": "Optional"
}
}),
});
const { jobId } = await response.json();
console.log(jobId); 입력 스키마
Udio 모델이 받는 모든 필드와 타입, 기본값입니다. 전체 레퍼런스는 문서에 있습니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| prompt 필수 | string | 생성할 내용에 대한 텍스트 설명. |
| model 필수 | string | 이 엔드포인트의 모델 식별자. 기본값:"udio" · "udio" |
| udioParams.lyrics_type | string | Lyrics 기본값:"generate" · "generate", "user", "instrumental" |
| udioParams.lyrics | string | Your lyrics |
| udioParams.lyrics_prompt | string | Udio writes the lyrics from this, free, before the song is generated. |
| udioParams.title | string | Track title |
| udioParams.style | string | Style hints |
| udioParams.negative_tags | string | Negative tags |
| udioParams.model | string | The udio130 models cannot be extended afterwards. 기본값:"udio32-v1.5" · "udio32-v1.5", "udio32-v1", "udio32-v2", "udio130-v1.5", "udio130-v1" |
| udioParams.bpm | number | BPM min 60, max 200, step 1 |
| udioParams.prompt_strength | number | Prompt strength min 0, max 1, step 0.05 |
| udioParams.lyrics_strength | number | Lyrics strength min 0, max 1, step 0.05 |
| udioParams.clarity_strength | number | Clarity min 0, max 1, step 0.05 |
| udioParams.generation_quality | number | Generation quality min 0, max 1, step 0.05 |
| udioParams.manual_mode | boolean | Send the prompt verbatim, without Udio’s prompt optimizer. 기본값:false |
| udioParams.style_ref | string | Udio’s "Use a Style" tab. Setting this generates from the style instead of a description, so the prompt becomes optional. |
| udioParams.voice | string | A voice to sing it. |
| udioParams.seed | number | Reuse a number to reproduce the same result. step 1 |
Udio 관련 질문
Udio 도입 전에 팀들이 자주 묻는 질문입니다. 그 외 내용은 문서에 있습니다.
Udio API가 있나요?
네. Apiframe는 단일 REST 엔드포인트(POST /v2/music/generate, model: "udio")로 Udio을(를) 제공합니다. 지원되는 모든 모델에서 통합된 API, 키, 청구를 사용할 수 있으며 별도의 Udio 계정이 필요하지 않습니다.
Udio API 비용은 얼마인가요?
Udio은(는) Apiframe에서 간단한 사용량 기반 과금을 사용하며, 성공한 생성에 대해서만 비용을 지불합니다. 요금제와 대량 할인은 가격 페이지를 참고하세요.
Udio API는 어떻게 호출하나요?
X-API-Key와 model: "udio"을(를) 포함한 JSON 본문을 담아 /v2/music/generate에 POST 요청을 보냅니다. 응답으로 반환되는 jobId를 GET /v2/jobs/{id}로 폴링하거나 웹훅으로 결과를 받습니다.
Udio은(는) 어떤 파라미터를 지원하나요?
Udio은(는) 공통 prompt, webhook_url 필드와 함께 udioParams 아래에 중첩된 16개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.
9,800+
개발자와 기업
공식 파트너