--- title: AI 음악 생성 API | RunAPI | RunAPI description: 하나의 AI 음악 생성 API로 완성 트랙, 연주곡, 스템을 만드세요. url: https://runapi.ai/ko/music.md canonical: https://runapi.ai/ko/music locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-f702f2b1.png alternates: en: https://runapi.ai/music zh-CN: https://runapi.ai/zh-CN/music es: https://runapi.ai/es/music ja: https://runapi.ai/ja/music de: https://runapi.ai/de/music fr: https://runapi.ai/fr/music pt-BR: https://runapi.ai/pt-BR/music ko: https://runapi.ai/ko/music it: https://runapi.ai/it/music nl: https://runapi.ai/nl/music pl: https://runapi.ai/pl/music tr: https://runapi.ai/tr/music zh-TW: https://runapi.ai/zh-TW/music zh-HK: https://runapi.ai/zh-HK/music ar: https://runapi.ai/ar/music x-default: https://runapi.ai/music --- > HTML version: https://runapi.ai/ko/music > Site index for agents: https://runapi.ai/llms.txt # AI 음악 생성 API 하나의 AI 음악 생성 API로 완성 트랙, 연주곡, 스템을 만드세요. - [API 키 받기](https://runapi.ai/ko/login) - [모델 둘러보기](https://runapi.ai/ko/models.md) 음악 모델 14개 · 보컬 포함 완성 트랙 · 초 단위 과금 ## Playground Available models: Producer/fuzz-0.8 ($0.13 / track), Suno/suno-v4 ($0.17 / track) ## AI로 생성된 트랙 듣기 - **시네마틱 오케스트라 — 에픽** - 오케스트라, 트레일러, 영웅적 - 3:24 - Suno v4 - **로파이 스터디 루프** - 로파이, 칠, 연주곡 - 2:48 - Suno v4 - **신스웨이브 나이트 드라이브** - 신스웨이브, 레트로, 드라이빙 - 4:02 - Udio 2 - **어쿠스틱 포크 선라이즈** - 포크, 어쿠스틱, 따뜻한 - 3:10 - Udio 2 ## 음악 엔드포인트가 할 수 있는 모든 것 - **텍스트를 음악으로** - 장르, 분위기, 템포를 설명하면 보컬 유무에 관계없이 완성된 트랙을 받으세요. - **트랙 확장** - 키, 템포, 편곡을 유지하면서 기존 트랙을 목표 길이로 연장하세요. - **스템 분리** - 렌더링을 보컬, 드럼, 베이스, 기타 요소로 분리하여 믹싱이나 리스코어링에 활용하세요. - **가사 생성** - 절과 후렴 마커가 포함된 구조화된 가사를 작성한 뒤 보컬 렌더링에 바로 사용하세요. ## 하나의 키로 사용하는 음악 모델 | Model | Provider | Price | | --- | --- | --- | | Producer/fuzz-0.8 | Producer | $0.13 / track | | Suno/suno-v4 | Suno | $0.17 / track | [전체 음악 모델 14개 보기](https://runapi.ai/ko/models.md) ## 빠른 시작 ### 트랙 생성하기 #### curl ```bash curl https://runapi.ai/api/v1/producer/text_to_music \ -H "Authorization: Bearer $RUNAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"fuzz-0.8","vocal_mode":"instrumental","prompt":"Soft piano with gentle percussion."}' ``` #### Python ```python import json import os import requests response = requests.post( "https://runapi.ai/api/v1/producer/text_to_music", headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"}, json=json.loads("{\"model\":\"fuzz-0.8\",\"vocal_mode\":\"instrumental\",\"prompt\":\"Soft piano with gentle percussion.\"}") ) response.raise_for_status() print(response.json()) ``` #### Node.js ```javascript const response = await fetch("https://runapi.ai/api/v1/producer/text_to_music", { method: "POST", headers: { "Authorization": "Bearer " + process.env.RUNAPI_API_KEY, "Content-Type": "application/json" }, body: JSON.stringify({"model":"fuzz-0.8","vocal_mode":"instrumental","prompt":"Soft piano with gentle percussion."}) }); console.log(await response.json()); ``` #### Go ```go package main import ( "io" "net/http" "os" "strings" ) func main() { payload := strings.NewReader("{\"model\":\"fuzz-0.8\",\"vocal_mode\":\"instrumental\",\"prompt\":\"Soft piano with gentle percussion.\"}") request, err := http.NewRequest("POST", "https://runapi.ai/api/v1/producer/text_to_music", payload) if err != nil { panic(err) } request.Header.Set("Authorization", "Bearer "+os.Getenv("RUNAPI_API_KEY")) request.Header.Set("Content-Type", "application/json") response, err := http.DefaultClient.Do(request) if err != nil { panic(err) } defer response.Body.Close() io.Copy(os.Stdout, response.Body) } ``` #### 응답 ```json { "id": "tsk_example", "status": "processing" } ``` ## 첫 생성까지 4단계 **이용 방법** 1. **API 키 받기** - 모든 음악 생성 모델을 위한 하나의 키입니다. 2. **트랙 설명하기** - 장르, 분위기, 템포, 악기 편성을 포함한 프롬프트를 작성하세요. 3. **생성** - /api/v1/producer/text_to_music로 POST 요청을 보내세요. 사용 가능한 음악 모델 중에서 선택하세요. 4. **스트리밍 또는 다운로드** - 생성된 트랙을 MP3/WAV로 받으세요. 스템 분리도 가능합니다. ## 개발자가 RunAPI를 선택하는 이유 - **하나의 키, 모든 모델** - 여러 API 키를 관리할 필요가 없습니다. 하나의 통합으로 모든 제공업체의 230+개 모델에 접근할 수 있습니다. - **15-25% 비용 절감** - 제공업체와의 대량 계약 덕분에 직접 이용하는 것보다 낮은 가격을 추가 인상 없이 제공합니다. - **자동 장애 조치** - 제공업체에 장애가 발생하면 다음으로 적합한 옵션으로 자동 라우팅합니다. 앱은 계속 실행됩니다. - **OpenAI 호환** - OpenAI SDK를 바로 대체할 수 있습니다. 코드 한 줄만 바꾸면 모든 모델에 접근할 수 있습니다. - **실시간 청구** - 사용한 만큼만 지불하세요. 최소 금액 없이 요청 단위로 청구되며, 모델과 프로젝트별로 비용을 추적할 수 있습니다. - **데이터 보호** - 개인정보 처리방침에서 요청 데이터와 생성된 콘텐츠의 처리 및 보관 방법을 확인할 수 있습니다. ### 탐색 ## 더 많은 AI API - [영상 API](https://runapi.ai/ko/models?modality=video) - 80개 모델로 영상을 생성, 편집, 업스케일하세요 [더 알아보기](https://runapi.ai/ko/models?modality=video) - [이미지 API](https://runapi.ai/ko/models?modality=image) - 49개 모델로 이미지를 생성하고 변형하세요 [더 알아보기](https://runapi.ai/ko/models?modality=image) - [오디오 API](https://runapi.ai/ko/models?modality=audio_music) - 31개 모델로 음성과 사운드를 만드세요 [더 알아보기](https://runapi.ai/ko/models?modality=audio_music) - [LLM API](https://runapi.ai/ko/models?modality=text) - 66개 언어 모델로 채팅 완성을 사용하세요 [더 알아보기](https://runapi.ai/ko/models?modality=text) ## 팀이 이것으로 만드는 것 - **배경 음악**: 스톡 라이브러리 대신 생성된 트랙으로 제품 영상과 데모에 사운드를 입히세요. - **팟캐스트**: 매 에피소드의 톤에 맞는 인트로, 스팅어, 베드 뮤직을 생성하세요. - **영상 사운드트랙**: 영상 엔드포인트와 함께 사용: 클립을 생성한 뒤 정확한 런타임에 맞춰 음악을 입히세요. - **게임 오디오**: 레벨이나 바이옴별 루핑 앰비언스를 제작하고, 테마 변경 시 재렌더링하세요. ## RunAPI vs 대안 비교 | 기능 | RunAPI | Suno 직접 | Replicate | | --- | --- | --- | --- | | 음악 모델 | 14 | 지원 안 함 | 지원 안 함 | | 가격 | $0.13 / track | 지원 안 함 | 지원 안 함 | | 스템 분리 | Yes | 지원 안 함 | 지원 안 함 | | 통합 청구 | Yes | 지원 안 함 | 지원 안 함 | | MCP 서버 | Yes | 지원 안 함 | 지원 안 함 | | 제공업체 장애 조치 | Yes | 지원 안 함 | 지원 안 함 | ## 음악 API 질문 ### 음악은 어떻게 청구되나요? 렌더링된 오디오 초 단위로 청구됩니다. Suno에서 30초 트랙은 약 1달러 정도이며, 실패한 렌더링은 청구되지 않습니다. ### 보컬을 넣을 수 있나요? 네. instrumental을 false로 두고 가사를 전달하거나, 가사 엔드포인트로 모델이 먼저 가사를 작성하도록 할 수 있습니다. ### 스템을 분리해서 받을 수 있나요? 네. 완료된 렌더링에 task_type separate_stems를 사용하면 보컬, 드럼, 베이스, 기타 요소를 파일로 받을 수 있습니다. ### 트랙 길이는 최대 얼마나 되나요? Suno와 Udio에서는 한 번의 호출로 최대 4분까지 가능합니다. 더 긴 곡은 기존 렌더링을 확장해서 만듭니다. ### 결과물을 상업적으로 사용할 수 있나요? 모델 제공업체의 라이선스에 따라 다르며, 카탈로그에서 모델별 라이선스 링크를 확인할 수 있습니다. RunAPI는 추가 제한을 두지 않습니다. ### 렌더링에는 얼마나 걸리나요? 30초 트랙 기준 약 40-90초가 소요됩니다. 작업을 폴링하는 대신 웹훅을 사용하세요. ## 생성된 음악으로 제품에 사운드를 입히세요 하나의 키로 Suno와 Udio를 모두 사용하고 초 단위로 청구됩니다. 신용카드 없이 무료로 시작하세요. - [API 키 받기](https://runapi.ai/ko/login) - [문서 보기](https://runapi.ai/ko/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] } ] ```