제품에 AI 생성 음악을 추가하는 것은 과거에는 스톡 라이브러리를 라이선스하거나 작곡가를 고용하는 것을 의미했습니다. 2026년에는 Suno v4.5를 호출하여 보컬, 하모니, 프로덕션이 포함된 4분짜리 완전한 곡을 약 60초의 실행 시간과 $0.50 미만의 비용으로 생성할 수 있습니다.

이 글에서는 첫 번째 curl 호출부터 웹훅 기반 오디오 전달까지의 전체 통합 과정을 안내합니다.

1. API 키 발급

aimarcus.eu/aigenerate/register에서 가입하세요. 가입 시 제공되는 $10 크레딧은 Suno v4.5 곡 약 20곡을 생성하기에 충분합니다.

2. 생성 요청 보내기

POST https://aimarcus.eu/aigenerate/api/v1/generate
Authorization: Bearer sk-aig-YOUR_KEY
Content-Type: application/json

{
  "model": "V4_5",
  "prompt": "Upbeat synthwave, driving bass, retro 80s vibe",
  "customMode": false,
  "instrumental": false,
  "callBackUrl": "https://your-app.com/webhooks/suno"
}

응답:

{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }

3. 맞춤 가사

customMode: true로 설정하고 프롬프트에 가사를 전달하세요. Suno는 멜로디, 편곡, 하모니, 보컬 퍼포먼스를 처리합니다.

{
  "model": "V4_5",
  "customMode": true,
  "prompt": "[Verse 1]\nWaking up to a city that never sleeps...",
  "style": "indie pop ballad",
  "title": "Midnight City",
  "callBackUrl": "..."
}

4. 폴링 또는 웹훅

두 가지 옵션:

  • 폴링: GET /api/v1/generate/record-info?taskId=...를 5초마다 호출하여 state="success" 상태를 확인합니다. 폴링 엔드포인트는 무료이며, 요금 제한이나 비용에 포함되지 않습니다.
  • 웹훅: callBackUrl을 제공합니다. 곡이 준비되면, 결과 JSON을 HMAC-SHA256 서명이 포함된 X-AI-Signature 헤더와 함께 지정된 URL로 POST합니다.

5. 최종 페이로드

성공적으로 완료되면 두 개의 오디오 URL(Suno가 생성한 변형)이 반환됩니다:

{
  "data": {
    "state": "success",
    "response": {
      "sunoData": [
        { "audioUrl": "https://.../track-a.mp3", "duration": 185 },
        { "audioUrl": "https://.../track-b.mp3", "duration": 194 }
      ]
    }
  }
}

두 파일 모두 MP3 형식, 44.1 kHz이며 바로 재생 가능합니다. URL은 무기한 유지되지만, 프로덕션에서는 다운로드 후 자체 CDN에 재호스팅하는 것이 좋습니다.

6. 프로덕션 팁

  • CDN에 캐시하세요 — Suno URL은 빠르지만, 자체 호스팅 시 SLA를 직접 제어할 수 있습니다.
  • 사용자 요청에 매핑된 taskId를 DB에 저장하세요 — 재시도 및 감사가 간단해집니다.
  • 대시보드 설정에서 일일 지출 한도를 설정하세요. 이를 최종 사용자에게 노출할 경우 유용합니다.
  • 팟캐스트 스타일의 음성 내레이션에는 Suno보다 빠르고 저렴한 전용 TTS 모델을 사용하는 것이 좋습니다.

이것이 전체 프로세스입니다. 동일한 패턴은 Suno v3.5, v4, v4.5 Plus, MusicGen, Mureka에서도 작동하며, model 필드만 변경하면 됩니다.