APIMart
APIMart

Suno v5.5 사용법: AI 노래와 보이스 가이드

단계별 Suno v5.5 가이드: 액세스 설정, 모드별 노래 생성, 보이스 관리, 클립 확장, 파일 저장, 상업용 음악 권리 확인까지 다룹니다.

튜토리얼

Suno는 2026년 9월 9일 V6 시리즈로 v5.5를 대체했지만, 이 가이드의 흐름은 그대로 유효합니다. 텍스트 프롬프트를 보내고, 작업을 폴링한 뒤, 파일을 검토·저장·배포 단계로 넘기면 됩니다. APIMart의 Suno API에서는 이제 v5.5 대신 v6, v6-wild, v6-mini를 호출합니다(Suno 공식: Introducing v6).

이 가이드를 한마디로 압축하면 다음과 같습니다:

  • 키, 헤더, 폴링으로 API 액세스를 설정합니다

  • 올바른 모드를 선택합니다: 설명, 커스텀 가사, 또는 음악 전용

  • 짧은 프롬프트, 보이스 큐, 클립 확장으로 출력을 다듬습니다

  • 스템, 믹싱, 내보내기, 승인 단계를 거쳐 초안을 옮깁니다

  • APIMart는 생성 결과를 72시간만 보관하므로 파일을 바로 저장합니다

  • 배포 전에 상업용 권리, 동의 기록, 승인 로그를 확인합니다

이 가이드는 노래 생성을 손으로만 테스트하는 것이 아니라 실제 콘텐츠 파이프라인의 일부로 만들고자 하는 사람들을 위한 것입니다. 여기에는 앱 팀, 광고 팀, 팟캐스트 제작자, 게임 스튜디오, 영화 편집자가 포함됩니다.

몇 가지 숫자는 처음부터 중요합니다:

  • 커스텀 모드에서 duration은 10–360초로 지정할 수 있고, 최종 길이는 결과에 따라 정해집니다

  • 첫 폴링 전에는 약 3초 기다립니다

  • 폴링은 보통 5~10초마다 계속됩니다

  • 429 같은 속도 제한 오류는 짧은 재시도 지연이 필요합니다

  • 승인 로그의 날짜는 07/16/2026처럼 미국 형식으로 저장해야 합니다

이 설정에서 마음에 드는 점은 경로가 단순하다는 것입니다: 요청 전송 → 작업 ID 획득 → 상태 폴링 → 오디오 다운로드 → 저장 → 권리 검토.

다음은 워크플로의 짧은 버전입니다:

단계내가 하는 일
액세스API 키, 인증 헤더, JSON 본문 추가
생성올바른 모드와 모델로 프롬프트 전송
보이스기본 보이스 프롬프트, 복제된 보이스, 또는 편집된 보이스 흐름 사용
편집클립 확장, 스템 분리, 믹싱, 내보내기
검토가사, 초상 사용, 상업 조건 확인
저장승인된 MP3/WAV 파일을 S3, Drive, 또는 다른 영구 위치에 저장

다시 말해: 이것은 "노래를 만드는 것"보다는 명확한 입력, 검토 단계, 파일 처리를 갖춘 반복 가능한 음악 제작 시스템 구축에 가깝습니다.

APIMart
[Suno](https://suno.com/home) v5.5 API 음악 파이프라인: 프롬프트에서 배포된 트랙까지

핵심 요약

  • Suno는 2026년 9월 9일 V6, V6 Wild, V6 Mini를 내놓으며 v5.5를 대체했습니다. APIMart에서는 model: "suno"와 함께 version을 v6, v6-wild, v6-mini 중 하나로 지정합니다.
  • 흐름은 비동기입니다. POST /v1/music/generations가 작업 ID를 반환하면 status가 completed가 될 때까지 GET /v1/music/tasks/{task_id}를 폴링하고 data.result.music[].audio_url을 읽습니다.
  • 영감 모드(custom: false)는 설명만으로 곡을 만들고, 커스텀 모드(custom: true)는 [Verse], [Chorus] 같은 태그를 붙인 직접 쓴 가사를 사용하며, instrumental: true는 보컬을 뺍니다.
  • 첫 폴링은 약 3초 뒤에 하고 이후 5–10초마다 확인합니다. 429 속도 제한 오류가 나면 잠시 간격을 두고 재시도합니다.
  • 반환되는 트랙 수는 고정되어 있지 않고 결과는 72시간 동안만 보관되므로, 승인된 파일은 바로 다운로드하고 상업적 이용 권한을 확인하며 클론 보이스의 동의 기록을 남겨 두세요.

Suno V6 한눈에 보기

항목내용
모델 유형비동기 API 기반 AI 노래 생성(작업 ID 수신 후 상태 폴링)
입력텍스트 프롬프트, [Verse]/[Chorus]/[Bridge]/[Outro] 태그가 있는 사용자 가사, 스타일 태그, instrumental: true
출력status가 completed가 되면 data.result.music[]의 각 트랙에 audio_url이 포함됨. audio_format은 mp3, m4a, wav 중 선택
클립 길이커스텀 모드의 duration은 10–360초. 실제 길이는 결과에 따라 결정
핵심 기능영감·커스텀·인스트루멘털 모드, vocal_gender, Persona와 커스텀 모델
이용 방법APIMart Suno API: model: "suno"와 version(v6 / v6-wild / v6-mini) 또는 custom_model_id. Bearer API 키 인증
적합한 용도광고 징글, 브랜드 송, 크리에이터 사운드트랙, 팟캐스트, 배경 음악
제한결과는 72시간 보관. 작업당 트랙 수는 고정되지 않음. 아티스트 이름이나 무단 초상 관련 요청은 거부될 수 있음

실제 프로젝트를 위한 Suno V6 액세스 설정

APIMart

첫 번째 요청은 세 가지로 요약됩니다: 자격 증명, 헤더, 비동기 폴링.

API 키, 인증, 기본 요청 구조

APIMart 계정을 만든 뒤 콘솔에서 API 키를 발급하세요. 테스트용과 운영용 키를 나눠 두면 하나를 교체해도 다른 쪽에 영향이 없습니다.

소스 파일에 키를 하드코딩하지 마세요. 대신 환경 변수에 넣으세요:

SUNO_API_KEY=your_key_here

로컬 작업에는 .env 파일을 사용하세요. 프로덕션에서는 GitHub Secrets나 AWS Secrets Manager 같은 시크릿 매니저를 사용하세요. 모든 요청에서 다음 헤더를 전송하세요:

  • Authorization: Bearer YOUR_API_KEY

  • Content-Type: application/json

요청 흐름은 간단합니다. POST https://api.apimart.ai/v1/music/generations를 보내고, 반환된 task_id를 저장한 뒤, 약 3초 기다렸다가 status가 completed 또는 failed가 될 때까지 5–10초마다 GET /v1/music/tasks/{task_id}를 폴링합니다. 완료되면 data.result.music[]에서 각 audio_url을 읽으세요. 트랙 수가 정해져 있다고 가정하면 안 됩니다. failed라면 이유가 data.error.message에 담기고 요금은 자동으로 환불됩니다(APIMart 문서: 음악 생성, 작업 규칙).

트랙이 준비되면 바로 다운로드하거나 S3 버킷 같은 영구 저장소로 옮기세요. APIMart는 결과를 72시간만 보관하므로 결과 URL을 파일의 장기 보관 위치로 쓸 수 없습니다.

오류 코드의미조치
401Unauthorized키를 확인하세요.
402결제 필요APIMart 잔액을 충전하세요.
429속도 제한잠시 간격을 둔 뒤 재시도하세요.
502업스트림 오류나중에 다시 시도하되, 타임아웃 후 유료 요청을 무작정 다시 보내지 마세요.

JSON 페이로드에서는 model을 "suno"로 두고 version을 명시적으로 지정하세요. v6(플래그십), v6-wild(결과가 더 다양함), v6-mini(더 빠름) 중에서 고릅니다. Suno가 V6를 내놓으면서 이전 모델을 종료했기 때문에 v5.5는 더 이상 선택할 수 없습니다. 커스텀 모델을 쓴다면 version 대신 custom_model_id를 보내며, 둘은 함께 쓸 수 없습니다.

워크플로 레이어로 APIMart 사용하기

APIMart

APIMart는 Suno 요청을 하나의 서버 측 워크플로를 통해 전송하여 자격 증명을 클라이언트 코드에서 분리합니다. 쉽게 말해, 원시 토큰은 클라이언트에서 떨어져 있고 모든 호출은 동일한 통합 레이어를 거칩니다.

요청마다 model과 version을 명시해서 테스트한 V6 변형으로 작업이 실행되게 하세요. 접근 설정이 끝났다면 다음은 프롬프트 설계와 출력 설정입니다.

올바른 프롬프트, 모드, 출력 설정으로 노래 생성하기

접근 설정을 마쳤다면 프롬프트를 쓰기 전에 생성 모드와 출력 형식을 먼저 정하세요. APIMart에서는 custom과 instrumental이 미리 정해야 할 두 필드이고, audio_format으로 mp3, m4a, wav를 고릅니다. 그다음 보컬과 검토 단계를 다듬으면 거친 초안을 영상 프로젝트 배경음악 같은 실제로 쓸 수 있는 에셋으로 바꿀 수 있습니다.

설명 모드 vs. 커스텀 가사 모드

설명 모드(custom: false)는 AI가 짧은 텍스트 프롬프트로부터 가사를 쓰고 음악 스타일을 선택하도록 합니다. 가벼운 방향 제시로 빠른 출력을 원할 때 가장 좋습니다. 커스텀 가사 모드(custom: true)는 여러분이 주도권을 갖습니다. 정확한 가사, [Verse], [Chorus], [Bridge], [Outro] 같은 섹션 태그, 그리고 장르, 분위기, 템포 같은 스타일 세부 정보를 제공합니다. 이는 정해진 구조를 가진 광고, 브랜드 노래, 크리에이터 트랙에 더 적합합니다.

모드속도제어최적 사용 사례필요 입력
설명가장 빠름낮음 (AI 주도)배경 트랙, 로파이 비트, 분위기 조성짧은 설명 프롬프트
커스텀 가사더 느림높음 (사용자 정의)광고 징글, 브랜드 노래, 스토리텔링전체 가사 + 스타일 태그 + 제목
인스트루멘탈빠름중간팟캐스트, 비디오 전환, 앰비언트 베드스타일 태그 + instrumental: true

인스트루멘탈 전용 출력을 원하면 instrumental: true로 설정하세요. 그런 다음 negative_tags를 사용해 원하지 않는 보컬, 예를 들어 "vocals, singing, voice"를 차단하세요.

광고, 브랜드 음악, 크리에이터 콘텐츠를 위한 프롬프트 패턴

여기서는 간단한 프롬프트 패턴이 잘 작동합니다: [genre] [mood] [instruments] [voice] [era/influence]. 경험상 단어를 길게 늘어놓기보다 분명한 핵심어 몇 개만 담은 짧은 프롬프트가 모델이 방향을 잃지 않게 해 줍니다. 뒤섞인 신호가 너무 많으면 모델이 흔들릴 수 있습니다.

모드는 작업에 맞춰야 합니다. 분위기를 노릴 때는 설명 모드를 사용하세요. 노래가 메시지, 브랜드 문구, 또는 이야기를 담아야 할 때는 커스텀 가사 모드를 사용하세요. "soft female vocals", "deep male baritone", 또는 "ethereal" 같은 문구로 보컬 질감을 직접 지정하여 사운드를 브랜드 톤이나 채널 스타일에 맞출 수도 있습니다.

프로덕션 용도의 출력 계획

길이를 조절하려면 커스텀 모드에서 duration(10–360초)을 지정하고, 목표 길이가 보장되지 않으므로 결과의 실제 duration을 확인하세요. 기존 트랙을 늘리려면 이어 쓰기 엔드포인트 POST /v1/music/generations/extend를 사용합니다(APIMart 문서: 이어 쓰기와 확장). 전용 [Outro]나 분명한 엔딩 표시를 넣으면 트랙이 깔끔하게 마무리됩니다.

프로덕션 작업에서는 여러 버전을 생성하고, 각각을 즉시 다운로드하고, 모든 보컬 트랙과 함께 인스트루멘탈 컷을 저장하세요. 그러면 보컬 버전이 광고, 편집, 또는 최종 검토에 맞지 않을 경우 대비책이 생깁니다. 모든 자산을 프롬프트와 메타데이터와 함께 하나의 일관된 프로젝트 폴더에 저장하는 것도 도움이 됩니다.

다음으로, 보이스와 편집 단계를 다듬어 최상의 버전이 검토 준비가 되도록 합니다.

보이스, 편집 단계, 상업용 워크플로 제어 처리하기

기본 보이스, 복제된 보이스, 개인화된 보이스 워크플로

Suno V6는 세 가지 보컬 워크플로를 제공하며, 시작 시 올바른 것을 선택하면 나중에 정리 작업을 많이 줄일 수 있습니다.

기본 보이스는 가장 빠른 경로입니다. soft female vocals, ethereal이나 deep male baritone 같은 보컬 스타일을 프롬프트에 설명하면 모델이 나머지를 처리합니다. 이 옵션은 하나의 고정된 보이스 정체성이 필요하지 않은 빠른 상업용 초안에 잘 작동합니다.

복제된 보이스는 설정이 더 필요하지만, 안정적이고 인식 가능한 사운드를 제공합니다. 복제된 보이스는 보이스 소유자로부터 명확하고 문서화된 동의가 있을 때만 사용하세요.

개인화 보이스 워크플로는 한 단계 더 나아갑니다. Suno에서 Persona는 Premier 기능이고, 커스텀 모델은 Pro와 Premier 모두에서 쓸 수 있습니다(Suno 요금 페이지). APIMart에서는 persona_id(커스텀 모드 전용) 또는 custom_model_id를 전달하며, 두 값은 한 요청에서 함께 쓸 수 없습니다(APIMart 문서).

보이스 유형브랜드 일관성설정 노력거버넌스 요구사항
기본 보이스프롬프트 기반최소낮음 - 표준 AI 권리
복제된 보이스높음 - 특정 초상중간 - 학습 데이터 필요높음 - 동의 및 법률 문서 필요
개인화매우 높음 - 커스텀 모델높음 - 반복 편집중간 - 내부 승인 필요

보이스 경로를 선택했다면 다음 단계는 간단합니다: 초안을 편집과 승인 과정으로 옮기는 것입니다.

초안 노래에서 사용 가능한 자산으로

첫 번째 생성물은 초안입니다. 완성된 자산이 아닙니다.

워크플로는 다음과 같습니다: 초안 → 확장 → 스템 분리 → 믹싱 → 내보내기.

먼저 가사와 보컬 톤을 브리프와 대조해 확인하세요. 그런 다음 스템을 분리하여 보컬과 인스트루멘탈이 별도 레이어에 놓이도록 하세요. 그러면 오디오 팀이 FL Studio나 Ableton 같은 DAW 안에서 EQ, 컴프레션, 리버브를 적용할 여지가 생깁니다. 그 후 최종 버전을 WAV로 내보내고 BPM, 장르, 스타일 태그 같은 메타데이터를 첨부한 다음 프로젝트 폴더에 저장하세요.

프로덕션 단계작업도구
초안 작성훅이 있는 초기 클립 생성Suno V6 API, 구조화된 가사
확장목표 길이 맞추기커스텀 모드의 duration 또는 이어 쓰기 엔드포인트 POST /v1/music/generations/extend
정제보컬과 인스트루멘탈 분리스템 분리 API
후반 작업믹싱, EQ, 오토튠DAW (FL Studio, Ableton)
내보내기WAV로 변환, BPM과 장르 첨부메타데이터 태깅, WAV 변환

승인된 오디오는 즉시 다운로드하세요.

라이선싱, 상업적 사용, 내부 승인 확인

배포 전에 모든 완성된 트랙에 대해 권리를 정리하고 승인을 기록하세요.

먼저, 노래를 생성하는 데 사용된 계정에 상업적 사용 권리가 포함되어 있는지 확인하세요.

그다음 가벼운 내부 승인 단계를 설정하세요. 특정 아티스트 이름이나 무단 초상을 언급하는 프롬프트나 가사 세트에 플래그를 지정하세요. 무단 초상이나 아티스트 이름과 연결된 요청은 거부될 수 있습니다. 복제된 보이스 자산으로 작업하는 경우 동의 기록을 오디오 파일과 함께 보관하세요.

감사 추적을 위해 각 최종 자산에 대해 Task ID, 노래 제목, 길이, 스타일 태그, 승인 날짜를 기록하세요. 07/16/2026처럼 미국 날짜 형식을 사용하고 누가 승인했는지 기록하세요.

엔드투엔드 APIMart 음악 파이프라인 구축하기

팀을 위한 간단한 프로덕션 파이프라인

프롬프트, 보이스, 라이선싱 선택이 고정되면 이들을 하나의 반복 가능한 흐름으로 묶으세요: 브리프 입력, 승인된 오디오 출력, 그다음 비디오, 광고, 또는 소셜용으로 저장.

브리프를 APIMart를 통해 Suno로 보냅니다. API가 작업 ID를 반환하면 n8n 같은 오케스트레이션 레이어에서 status가 completed 또는 failed로 돌아올 때까지 폴링 루프를 돌릴 수 있습니다. 불필요한 요청을 보내지 않도록 첫 폴링 전에는 약 3초 기다리세요.

목표는 간단합니다: 각 핸드오프를 도구나 API에 매핑하여 누군가 손으로 파일이나 상태 업데이트를 쫓지 않고도 프로세스가 실행되도록 하는 것입니다.

워크플로 단계도구 / API핵심 작업
브리핑LLM테마에서 가사와 스타일 태그 생성
생성Suno 생성 API (APIMart)프롬프트와 모드로 POST 요청 제출
상태 추적n8n 폴링 루프5~10초마다 작업 상태 확인
사람 검토검토 양식저장 전 승인 또는 거부
저장Google Drive / S3MP3/WAV를 메타데이터와 함께 다운로드 및 저장
프로덕션편집 스위트오디오를 비디오 또는 광고 템플릿으로 가져오기

여기서 중요한 점이 하나 있습니다. APIMart는 생성 결과를 72시간 동안만 보관합니다. 그러니 파이프라인에서 승인된 파일을 바로 다운로드해 그 기간이 끝나기 전에 영구 저장소로 옮겨야 합니다.

기본 흐름이 돌아가면, 거절된 생성 결과를 프롬프트 단계로 되돌리는 실패 라우팅을 추가하세요. 작업이 failed로 끝나면 data.error.message를 읽고 프롬프트를 고친 뒤 다시 제출합니다. 실패한 작업은 APIMart가 자동으로 환불하므로 대기열이 막히지 않고 계속 흘러갑니다.

첫걸음

반복할 수 있는 하나의 워크플로로 시작한 다음, 엔드투엔드로 작동한 후에만 거기서 확장하세요. 먼저 하나의 사용 사례를 고르세요 - 광고 징글, 브랜드 배경 트랙, 또는 크리에이터 사운드트랙.

무언가가 라이브로 나가기 전에, 플랜에 상업적 사용 권리가 명확히 포함되어 있는지 확인하세요. 그런 다음 APIMart를 음악 생성을 더 큰 AI 콘텐츠 워크플로에 연결하는 레이어로 사용하여, 하나의 노래 요청이 팀이 반복해서 사용할 수 있는 시스템을 통과하도록 하세요.

FAQ

설명, 커스텀 가사, 인스트루멘탈 모드 중 어떻게 선택하나요?

원하는 제어 수준에 따라 선택하세요.

  • AI가 텍스트 프롬프트로 가사와 작곡을 만들기를 원하면 설명 모드를 사용하세요.

  • 자신의 가사와 노래 구조를 제공하고 싶으면 커스텀 모드를 사용하세요.

  • 배경 음악이나 징글처럼 보컬 없는 트랙을 원하면 인스트루멘탈 모드를 사용하세요.

상업적 승인을 위해 각 생성된 트랙과 함께 무엇을 저장해야 하나요?

만드는 모든 트랙에 대해 명확한 기록을 유지하세요. 최소한 다음을 저장하세요:

  • 고유 작업 ID

  • 최종 생성된 오디오 파일

  • 노래 제목, 길이, 스타일 태그나 프롬프트 같은 메타데이터

  • 모델 버전과 생성 날짜

그 기록은 라이선싱 준수를 확인하고 상업적 사용을 위한 감사 추적을 유지하기가 훨씬 쉬워지게 합니다.

프로덕션에서 임시 오디오 링크가 만료되지 않도록 어떻게 하나요?

APIMart의 Suno API 생성 결과는 72시간 동안만 보관되므로, 결과 링크는 장기적인 제작 에셋 보관용으로 적합하지 않습니다.

더 안전한 방법은 다음과 같습니다: 상태 폴링이 작업이 성공적으로 완료되었음을 보여주는 즉시, 오디오 파일을 바로 다운로드하여 영구 저장소로 보내세요.

이는 다음과 같은 것일 수 있습니다:

  • Google Drive

  • 로컬 파일 시스템

너무 오래 기다리면 링크가 만료되어 앱이 파일을 가져오려 할 때 파일이 사라졌을 수 있습니다.

태그#Suno v5.5#Suno API#AI 노래 생성#음악 API#상업용 음악 권리

APIMart 팀 소개

APIMart 팀은 AI로 제품을 만드는 개발자를 위해 모델 가이드, 비교 분석, 가격 분석을 작성합니다. APIMart는 하나의 API로 여러 제공업체의 채팅·이미지·영상 모델을 제공하므로, 이 글에서 다룬 모델을 출시 전에 나란히 비교해 볼 수 있습니다.

이제 직접 테스트해 보세요

모델 마켓에서 원하는 모델을 선택하세요

APIMart 모델 마켓에서 채팅, 이미지, 비디오 모델을 사용해 보고 하나의 통합 API로 모델 기능을 빠르게 경험하세요.

채팅 모델이미지 모델비디오 모델
모델 마켓 보기