APIXO

오디오

Suno V5

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

$0.12 / generation

실행당 2개 트랙V4 / V4.5 / V5사용자 지정 가사 모드MP3 + 커버 아트

작업 공간 로딩 중...

엔드포인트

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

비동기 방식으로 statusTask 상태를 폴링하거나, 결과가 준비되면 콜백으로 webhook을 받으세요.async · callback

callback_url조건부

유형text

콜백 전송을 위한 공개 HTTPS URL입니다.다음에서만 가능: request_type=callback

mode필수

유형select

생성 백엔드 버전을 선택하세요.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4

customMode필수

유형boolean

사용자 지정 가사 모드를 활성화합니다. 비활성화 시 프롬프트 전용 곡 설명 모드가 사용됩니다.

title필수

유형text

사용자 지정 모드가 켜져 있을 때 필요합니다.다음에서만 가능: customMode=

style필수

유형string

장르, 분위기, 악기 구성, 보컬 스타일을 설명하세요. 사용자 지정 모드에서 필수 항목입니다.다음에서만 가능: customMode=

prompt선택 사항

유형string

곡 설명 또는 가사. 사용자 지정 모드에서는 최신 Suno 버전의 경우 더 긴 가사를 지원합니다.

songDescription필수

유형string

사용자 지정 모드가 꺼져 있을 때 사용되는 프롬프트 전용 모드 필드입니다.다음에서만 가능: customMode=

instrumental필수

유형boolean

보컬 없이 연주 음원을 생성하려면 켜세요.

negativeTags조건부

유형string

피해야 할 아티팩트나 스타일을 설명하세요.다음에서만 가능: customMode=

styleWeight조건부

유형slider

스타일 설명을 얼마나 강하게 따를지 결정합니다.다음에서만 가능: customMode=

weirdnessConstraint조건부

유형slider

값이 높을수록 더 실험적인 결과물이 생성됩니다.다음에서만 가능: customMode=

audioWeight조건부

유형slider

오디오 충실도와 가사 제어의 균형을 맞춥니다.다음에서만 가능: customMode=

vocalGender조건부

유형select

선호하는 음색을 최대한 반영합니다.f · m다음에서만 가능: customMode=

파라미터	유형	필수 항목	설명
`request_type`	select	필수	비동기 방식으로 statusTask 상태를 폴링하거나, 결과가 준비되면 콜백으로 webhook을 받으세요.async · callback
`callback_url`	text	조건부	콜백 전송을 위한 공개 HTTPS URL입니다.다음에서만 가능: request_type=callback
`mode`	select	필수	생성 백엔드 버전을 선택하세요.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4
`customMode`	boolean	필수	사용자 지정 가사 모드를 활성화합니다. 비활성화 시 프롬프트 전용 곡 설명 모드가 사용됩니다.
`title`	text	필수	사용자 지정 모드가 켜져 있을 때 필요합니다.다음에서만 가능: customMode=
`style`	string	필수	장르, 분위기, 악기 구성, 보컬 스타일을 설명하세요. 사용자 지정 모드에서 필수 항목입니다.다음에서만 가능: customMode=
`prompt`	string	선택 사항	곡 설명 또는 가사. 사용자 지정 모드에서는 최신 Suno 버전의 경우 더 긴 가사를 지원합니다.
`songDescription`	string	필수	사용자 지정 모드가 꺼져 있을 때 사용되는 프롬프트 전용 모드 필드입니다.다음에서만 가능: customMode=
`instrumental`	boolean	필수	보컬 없이 연주 음원을 생성하려면 켜세요.
`negativeTags`	string	조건부	피해야 할 아티팩트나 스타일을 설명하세요.다음에서만 가능: customMode=
`styleWeight`	slider	조건부	스타일 설명을 얼마나 강하게 따를지 결정합니다.다음에서만 가능: customMode=
`weirdnessConstraint`	slider	조건부	값이 높을수록 더 실험적인 결과물이 생성됩니다.다음에서만 가능: customMode=
`audioWeight`	slider	조건부	오디오 충실도와 가사 제어의 균형을 맞춥니다.다음에서만 가능: customMode=
`vocalGender`	select	조건부	선호하는 음색을 최대한 반영합니다.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",
    "input": {
      "mode": "V5",
      "customMode": true,
      "instrumental": false,
      "title": "Neon Freeway Nights",
      "style": "Synthwave, dreamy pop",
      "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful."
    }
  }'

전체 API 문서

Suno V5 API 가이드

오디오 생성 워크플로우를 위한 Suno API

APIXO를 통해 Suno을 사용해 Playground에서 프롬프트를 테스트하고, 데모를 확인하고, 가격을 비교한 뒤, 동일한 설정으로 프로덕션 API 호출에 적용하세요.

Suno V5 워크플로우

한 페이지에서 Suno V5 API 워크플로우를 구축하고 배포하세요.

이 Suno V5 랜딩 페이지는 출력 품질을 평가하고, 가격을 비교하고, API 키를 생성하고, 검증된 설정을 동일한 워크플로에서 프로덕션 코드로 넘기려는 팀을 위해 설계되었습니다.

Suno V5 프롬프트 테스트

Suno V5 playground에서 prompt, mode 선택, 출력 설정을 테스트한 뒤 요청을 프로덕션으로 옮기세요.

Suno V5 데모 리뷰

실제 또는 플레이스홀더 오디오 출력을 먼저 확인한 후, 동일한 데모 파라미터를 Playground에 로드하여 더 빠르게 반복 작업하세요.

Suno V5 API 핸드오프

이 모델 페이지에서 시각적 테스트부터 API 키, cURL 예제, 요청 JSON, 문서까지 모두 확인하세요.

Suno V5 명확한 가격 정책

프로덕션 작업에 사용할 비용 프로필을 선택하기 전에, 동일한 페이지에서 사용 가능한 가격 등급을 비교하세요.

Suno V5 입력 제어

테스트된 양식이 문서화된 API 사양과 일치하도록 플레이그라운드에서 가사, 스타일 및 보컬 제어을(를) 직접 조정하세요.

Suno V5 프로덕션 준비 상태

비동기 폴링, 콜백 전달, 생성 기록, 예측 가능한 과금이 팀 워크플로우에서 중요할 때는 APIXO를 사용하세요.

모델 개요

Suno API란 무엇인가요?

Suno은(는) APIXO를 통해 오디오 생성을(를) 위한 프로덕션 API로 제공됩니다. 모델 페이지에서 플레이그라운드 테스트, 실제 요청 매개변수 확인, 가격 정보, 문서 핸드오프까지 하나의 워크플로우로 모두 해결할 수 있습니다.

먼저 이 페이지에서 프롬프트와 모드 선택을 검증한 다음, API 키, cURL 예제, 백엔드 통합, 반복 가능한 생성 작업에도 동일한 설정을 유지하세요.

프로덕션 팀을 위한 Suno API 워크플로우

플레이그라운드에서 시작하여 입력 에셋에 맞는 모드를 선택하세요.
빠른 기준점이 필요할 때 예시 결과물을 검토하고 데모 파라미터를 로드하세요.
대량 배치 또는 고해상도 작업을 보내기 전에 가격을 확인하세요.
대화형 UX에는 비동기 폴링을, 백엔드 큐에는 콜백 모드를 사용하세요.

Suno API 기술 사양

현재 Suno API의 기능 및 통합 관련 제약 조건입니다.

Suno 모드

프롬프트 전용, 사용자 지정 가사, 연주곡

Suno 결과물

실행당 2개 트랙

Suno 컨트롤

V4 / V4.5 / V5 / 사용자 지정 가사 모드

Suno 지연 시간

일반적으로 60~90초

Suno V5 주요 기능

Suno 음악 생성

구조화된 프롬프트로 오디오 결과물을 생성하고, API 핸드오프를 위해 생성 설정을 계속 볼 수 있도록 합니다.

Suno 크리에이티브 컨트롤

프로덕션 호출로 전환하기 전에 Playground에서 가사, 스타일 또는 모드 설정을 직접 조정하세요.

Suno API 워크플로우

동일한 모델 페이지에서 비동기 작업 생성, 폴링, 콜백 전달, 요청 예제를 모두 사용하세요.

Suno V5으로 무엇을 만들 수 있나요?

Suno 크리에이터 도구

사용자가 빠른 프롬프트-오디오 반복 작업을 필요로 하는 크리에이터 워크플로우에 음악 생성 기능을 추가하세요.

Suno 브랜드 오디오

API 작업을 통해 캠페인 트랙, 숏폼 배경 음악, 인트로, 아웃트로 또는 사운드 컨셉을 생성하세요.

Suno 프로덕션 자동화

입력, 작업 ID, 결과 URL을 추적하면서 백엔드 큐에서 반복 가능한 비동기 오디오 작업을 실행하세요.

Suno V5 참고 사항 및 제한

Suno 생성은 비동기 태스크 전송 방식을 사용하므로, 프로덕션 시스템은 폴링 또는 콜백 처리를 지원해야 합니다.
결과 품질은 프롬프트의 명확성, 입력 에셋 품질, 제공자 측 모델의 동작에 따라 달라집니다.
모든 요청은 제공업체의 안전, 검토 및 계정 접근 확인 절차를 통과해야 합니다.
동일한 프롬프트 구조를 사용하더라도 오디오 출력은 가사, 보컬 스타일, 타이밍, 믹스에서 차이가 있을 수 있습니다.

Suno V5 자주 묻는 질문

개발 시작하기

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

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

오디오 생성 워크플로우를 위한 Suno API

한 페이지에서 Suno V5 API 워크플로우를 구축하고 배포하세요.

Suno API란 무엇인가요?

프로덕션 팀을 위한 Suno API 워크플로우

Suno API 기술 사양

Suno 모드

Suno 결과물

Suno 컨트롤

Suno 지연 시간

Suno V5 주요 기능

Suno 음악 생성

Suno 크리에이티브 컨트롤

Suno API 워크플로우

Suno V5으로 무엇을 만들 수 있나요?

Suno 크리에이터 도구

Suno 브랜드 오디오

Suno 프로덕션 자동화

Suno V5 참고 사항 및 제한

Suno V5 자주 묻는 질문

API 코드를 작성하기 전에 Suno을 테스트해 볼 수 있나요?

Suno은 비동기 생성을 지원하나요?

Suno 파라미터는 어디에서 오나요?

나중에 데모 에셋을 교체할 수 있나요?

개발 시작하기