오디오

Suno V5

Suno API는 프롬프트, 스타일, 가사를 통해 스튜디오 수준의 음악을 생성하며, 비동기 프로덕션 방식에 맞춰 실행당 두 개의 트랙을 반환합니다.

$0.12 / use

실행당 2개 트랙비동기 워크플로우프롬프트 및 가사 제어MP3 + 커버 아트

파라미터

Model Version*

Custom Mode*

활성화됨

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

비활성화됨

Vocal Gender Preference

출력

생성된 콘텐츠가 여기에 표시됩니다

엔드포인트

POSThttps://api.apixo.ai/api/v1/generateTask/suno작업 생성

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}상태 폴링

인증

API 액세스 확인 중...

로그인하여 무료 크레딧을 받고, 플레이그라운드를 테스트한 후 API 연동을 진행하세요.

요청 본문

request_type

async

웹훅을 위해 callback_url과 함께 콜백을 사용하세요.

provider

official

Seedance 2.0 매뉴얼과 일치합니다.

input

객체

모드, 프롬프트, 레퍼런스, 크기, 재생 시간 및 오디오 설정.

파라미터

request_type필수

유형select

Use async to poll or callback to receive a webhook when ready.async · callback

callback_url조건부

유형text

Publicly accessible URL for callback mode.다음에서만 가능: request_type=callback

mode필수

유형select

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customMode필수

유형boolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

title필수

유형text

Appears in metadata and can steer theme. Required when Custom Mode is on.다음에서만 가능: customMode=

style필수

유형string

Describe genre/mood/instrumentation. Required in Custom Mode.다음에서만 가능: customMode=

prompt조건부

유형string

Provide full lyrics for sung output. Required when Instrumental is off.다음에서만 가능: customMode=

songDescription필수

유형string

Simple mode: one field to steer both style and topic when Custom Mode is off.다음에서만 가능: customMode=

instrumental필수

유형boolean

Turn on to generate backing track without vocals.

negativeTags조건부

유형string

Negative Tags다음에서만 가능: customMode=

styleWeight조건부

유형slider

How strongly to follow the Style description.다음에서만 가능: customMode=

weirdnessConstraint조건부

유형slider

Push creativity/experimentation. Higher = wilder.다음에서만 가능: customMode=

audioWeight조건부

유형slider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.다음에서만 가능: customMode=

vocalGender조건부

유형select

Best-effort vocal timbre preference (custom mode only).f · m다음에서만 가능: customMode=

파라미터	유형	필수 항목	설명
`request_type`	select	필수	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	조건부	Publicly accessible URL for callback mode.다음에서만 가능: request_type=callback
`mode`	select	필수	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	필수	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	필수	Appears in metadata and can steer theme. Required when Custom Mode is on.다음에서만 가능: customMode=
`style`	string	필수	Describe genre/mood/instrumentation. Required in Custom Mode.다음에서만 가능: customMode=
`prompt`	string	조건부	Provide full lyrics for sung output. Required when Instrumental is off.다음에서만 가능: customMode=
`songDescription`	string	필수	Simple mode: one field to steer both style and topic when Custom Mode is off.다음에서만 가능: customMode=
`instrumental`	boolean	필수	Turn on to generate backing track without vocals.
`negativeTags`	string	조건부	Negative Tags다음에서만 가능: customMode=
`styleWeight`	slider	조건부	How strongly to follow the Style description.다음에서만 가능: customMode=
`weirdnessConstraint`	slider	조건부	Push creativity/experimentation. Higher = wilder.다음에서만 가능: customMode=
`audioWeight`	slider	조건부	Balance audio vs lyrical fidelity. Higher favors audio fidelity.다음에서만 가능: customMode=
`vocalGender`	select	조건부	Best-effort vocal timbre preference (custom mode only).f · m다음에서만 가능: customMode=

예시 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

전체 API 문서

출력 예시

APIXO의 Suno V5 API로 생성됨

2 트랙

Neon Freeway Nights

보기

전체 가이드

Suno API란 무엇인가요?

Suno API는 신속한 프로덕션 워크플로우를 위해 설계된 텍스트 투 뮤직 생성 인터페이스입니다. 프롬프트, 스타일 태그, 커스텀 가사를 관련 커버 이미지와 함께 두 개의 완성된 곡으로 변환할 수 있습니다.

수동 작곡보다 빠른 반복 작업이 중요한 크리에이터 도구, 브랜드 콘텐츠 생성 및 자동 음악 제작 사례에 적합합니다.

생성 워크플로우 작동 방식

프롬프트 전용 또는 커스텀 가사 모드 파라미터로 생성 요청을 제출합니다.
폴링 또는 콜백 엔드포인트를 통해 비동기적으로 작업 상태를 수신합니다.
성공 시, 생성된 트랙 2개와 그에 해당하는 아트워크 메타데이터가 소모됩니다.

Suno API 기술 사양

제품 및 백엔드 통합과 관련된 운영 특성입니다.

출력

생성당 2개 트랙

컨트롤 서피스

스타일, 기이함(weirdness), 오디오 가중치

생성 모드

프롬프트 전용 및 사용자 지정 가사 모드

전달

비동기 폴링 또는 콜백

주요 기능

듀얼 트랙 출력

생성 시마다 두 개의 곡 변형이 반환되어 제작 팀의 A/B 선택 및 크리에이티브 반복 작업을 가속화합니다.

크리에이티브 제어 슬라이더

스타일 가중치, 기괴함(weirdness), 오디오 가중치를 조정하여 안전한 상업용 트랙부터 실험적인 질감까지 결과물을 변화시킬 수 있습니다.

가사 및 보컬 워크플로우

프롬프트 전용 생성 및 악기 연주, 보컬 성별 선호도 옵션이 포함된 커스텀 가사 모드를 지원합니다.

비동기 통합 준비 완료

폴링 또는 콜백 전략과 호환되어 큐 기반 백엔드 워크플로우에 쉽게 통합할 수 있습니다.

무엇을 만들 수 있나요?

인앱 음악 생성

UGC, 숏폼 비디오, 소셜 제작 도구를 위한 브랜드 음악 스니펫과 크리에이터 친화적인 트랙을 생성하세요.

팟캐스트 및 비디오 브랜딩

분위기와 속도 조절이 가능한 인트로 및 아웃트로 트랙, 범퍼, 반복되는 테마 모티프를 제작하세요.

숏폼 콘텐츠 사운드트랙

스타일과 가사 훅을 빠르게 반복하여 TikTok, Shorts, Reels를 위한 맞춤형 배경 음악을 제작하세요.

게임 및 인터랙티브 오디오

게임 및 인터랙티브 경험을 위한 앰비언트 루프, 메뉴 테마, 가벼운 배경음악 아이디어를 프로토타이핑하세요.

참고 및 제한 사항

생성 시마다 정확히 두 개의 트랙이 반환되며, 출력 개수는 사용자 지정할 수 없습니다.
Playground 워크플로우는 비동기 우선 방식이며, 콜백 오케스트레이션은 API 레벨에서 사용 가능합니다.
지원되는 버전에서 커스텀 모드 프롬프트/가사 길이는 최대 5,000자로 제한됩니다.
보컬 성별 및 보컬 특성은 최선의 노력을 다하는 제어 항목이며, 엄격한 보장을 제공하지는 않습니다.

자주 묻는 질문

개발 시작하기

위의 플레이그라운드에서 테스트해 본 후, 연동 준비가 되면 API 문서를 확인하세요.

플레이그라운드 체험하기 API 문서 보기

Suno V5

출력 예시

Suno API란 무엇인가요?

생성 워크플로우 작동 방식

Suno API 기술 사양

출력

컨트롤 서피스

생성 모드

전달

주요 기능

듀얼 트랙 출력

크리에이티브 제어 슬라이더

가사 및 보컬 워크플로우

비동기 통합 준비 완료

무엇을 만들 수 있나요?

인앱 음악 생성

팟캐스트 및 비디오 브랜딩

숏폼 콘텐츠 사운드트랙

게임 및 인터랙티브 오디오

참고 및 제한 사항

자주 묻는 질문

두 개의 트랙 대신 하나의 트랙만 생성할 수 있나요?

정확한 가사 출력을 강제할 수 있나요?

이 API는 동기식인가요?

어떤 파일 형식이 반환되나요?

개발 시작하기