음악 API 및 CLI

계정 연결

1. 계정 생성 후 이메일을 인증해 보세요.
2. 설정을 열고 API 키를 생성해 보세요. API 키
3. 키는 서버나 비밀 관리자에 보관하세요. URL이나 프런트엔드 코드에 넣지 말고, Authorization 헤더로 전송하세요.

키는 90일 후에 만료돼요. 최대 5개의 활성 키를 가질 수 있으며, 설정에서 언제든지 키를 즉시 폐기할 수 있어요. 읽기 전용 키로는 곡을 생성할 수 없어요.

curl https://mcp.wordsintomusic.com/v1/account \
  -H "Authorization: Bearer $WIM_API_KEY"

곡 준비, 시작 및 확인

먼저 크레딧을 사용하지 않고 브리프를 준비해 보세요. 준비를 시작하면 기존 곡 크레딧 하나가 사용돼요. 재시도 시에는 동일한 요청 ID를 유지하세요. 타임아웃으로 인해 다른 곡이 시작되어서는 안 돼요.

{
  "requestId": "my-first-song-20261021",
  "input": {
    "mode": "idea",
    "idea": "새로운 도시에서 다시 시작하는 것에 대한 희망찬 노래",
    "direction": "따뜻한 어쿠스틱 팝, 안정적인 드럼, 부드러운 보컬",
    "language": "ko",
    "duration": 120
  },
  "uiLocale": "ko"
}

이 JSON을 POST /v1/songs/prepare로 전송하세요. 그런 다음 해당 preparedRequestId를 POST /v1/songs/start로 전송하세요. GET /v1/jobs/{jobId}를 최소 15초 간격으로 확인해 보세요. 준비가 완료되면 반환된 비공개 라이브러리 링크를 열어 듣거나 다운로드해 보세요.

지원하는 곡 언어는 영어, 스페인어, 독일어, 프랑스어, 브라질 포르투갈어, 이탈리아어, 네덜란드어, 폴란드어, 스웨덴어, 일본어, 한국어입니다. 길이는 60~180초로 요청하세요. 직접 쓴 가사를 쓰려면 가사 모드를, 보컬 없는 음악을 만들려면 instrumental: true를 사용하세요.

API 엔드포인트

API 기본 URL은 다음과 같아요 https://mcp.wordsintomusic.com/v1. OpenAPI 사양 다운로드 요청 필드, 제한, 권한 및 응답 형식에 대한 정보예요.

명령줄 사용

npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10

Node.js 22 이상을 사용하세요. 표준 입력을 통해 로그인 키를 전달하거나, 비밀 관리자에서 WIM_API_KEY를 제공하세요. 명령 인자나 셸 기록에 키를 넣지 마세요. 자세한 내용은 wim --help를 실행해 보세요.

크레딧, 제한 및 개인 정보 보호

곡 크레딧이 필요한 경우 API는 HTTP 402를 반환해요. GET /v1/account에서 제안을 선택한 다음, 확인된 선택 사항으로 POST /v1/billing/checkout을 호출하세요. 다른 웹사이트 로그인 없이 Stripe에서 결제하세요. 결제가 확인된 후 잔액을 확인하고 원래 preparedRequestId로 다시 시도해 보세요.

API 접근 및 CLI에는 별도의 구독이 없어요. 녹음을 생성하는 것은 앱과 동일한 계정 제한 내에서 기존 곡 허용량을 사용해요. API는 자동으로 요금을 청구하지 않아요.

키 소유자의 곡만 읽을 수 있어요. 가사는 요청 시에만 반환돼요. 키를 폐기하면 새로운 API 호출은 중단되지만, 이미 승인된 곡은 계속 처리돼요.

게이트웨이는 IP당 분당 최대 30개의 API 요청을 허용해요. API 및 MCP 호출은 또한 분당 120개 요청의 계정 제한을 공유해요. 429 응답 시 Retry-After를 준수하세요. 성공적인 준비 ID는 만료 후 30일 동안 재시도 보호를 위해 계속 사용할 수 있어요.

어시스턴트 연결의 경우, 다음을 사용하세요 MCP 설정 가이드. 계정 허용량은 다음을 참조하세요 가격.