audio_id 사용)와 달리, 이 API는 본인의 음성 녹음인 공개적으로 접근 가능한 audio_url을 받습니다. 이 문서는 음성 복제 API의 연동 방법을 설명합니다.
첫 번째 단계: 음성 캐릭터 생성
이 API에는 세 개의 입력 파라미터가 있습니다.audio_url(필수)은 한 명의 선명한 음성이 포함된 공개적으로 접근 가능한 MP3 또는 WAV 형식 오디오 파일 URL입니다. name과 description(선택 사항)은 음성 캐릭터의 이름과 설명입니다.
오디오 파일 요구 사항
- 오디오 형식은
WAV또는MP3여야 합니다- 오디오 길이는
10~240초사이여야 하며,30~60초의 깨끗한 단일 인물 무반주 음성 소재 사용을 권장합니다- 오디오에는 선명하고 식별 가능한 한 명의 말하는 또는 노래하는 음성이 포함되어야 합니다
- 배경 소음, 반주, 에코, 리버브를 반드시 피하십시오. 반주가 포함된 완성된 노래는 일반적으로 음성 지문 검증을 통과할 수 없습니다
- 여러 화자 또는 다중 음성을 포함하지 마십시오
- 볼륨이 너무 낮거나, 음성이 선명하지 않거나, 소음이 너무 심한 소재는 복제 실패 또는 생성 효과 저하를 초래할 수 있습니다 사용 제한 안내
- 오디오 업로드를 통해 생성된 음성 캐릭터는 비공개 리소스입니다
- 해당 음성 캐릭터는 계정 간 재사용을 지원하지 않습니다
- 생성에 성공한 후 가능한 한 빨리 사용하는 것을 권장하며, 장기간 사용하지 않으면 만료되거나 사용할 수 없게 될 수 있습니다
- 반환되는
name은 시스템에서 자동 생성되므로, 반환된persona_id를 기준으로 하십시오
호출 실패 시 먼저 재시도하십시오
음성 복제는 연산 집약적인 작업이므로, 소재가 완전히 규정을 준수하더라도 일정 확률로 간헐적인 실패가 발생할 수 있으며, 일반적인 반환값으로는
voices_sound_different(음성 지문 검증 미통과) 등이 있습니다. 이러한 실패는 오디오 품질과 무관하며, 동일한 소재로 재시도하면 일반적으로 성공할 수 있습니다.
통합 시 실패 결과에 대해 1~2회의 자동 재시도를 구현하는 것을 권장합니다. 실패한 요청에는 과금되지 않습니다.
위의결과는 다음과 같습니다:https://cdn.acedata.cloud/suno_demo.mp3는 직접 호출할 수 있는 예제 소재입니다(MP3, 41초, 단일 인물 무반주 음성).WAV형식 예제가 필요한 경우https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765(WAV, 41초, 모노 44.1kHz)를 사용할 수 있습니다.
data의 persona_id 필드가 바로 생성된 음성 캐릭터 ID입니다. 오디오 업로드를 통해 생성된 음성 캐릭터는 비공개이므로 is_public 필드는 항상 false입니다. 반환되는 name은 시스템에서 자동 생성되므로, 이후에는 persona_id를 사용하여 해당 음성 캐릭터를 참조하십시오.
두 번째 단계: 음성 캐릭터를 사용하여 음악 생성
음성 캐릭터 ID를 얻은 후에는 Suno Audios Generation API를 사용하여 음악을 생성할 수 있습니다.action을 generate로 설정하고, persona_id를 위에서 반환된 음성 캐릭터 ID로 설정하면 생성된 노래는 복제된 음성으로 노래합니다.
주의: 음성 복제는chirp-v4-5이상의 모델(예:chirp-v4-5,chirp-v5,chirp-v5-5)만 지원하며,chirp-v4는 지원하지 않습니다.
persona_id는 generate 생성에 사용할 수 있으며, cover / upload_cover 리메이크에도 사용할 수 있습니다. 음성을 지정할 때 vocal_gender를 동시에 입력할 필요는 없습니다. 음성 유사도는 여전히 참조 소재와 생성 결과에 따라 달라집니다.
이 인터페이스를 통해 생성된 음성은 비공개 리소스입니다. 기존 노래를 리메이크하기 전에 먼저 /suno/upload를 호출하여 원곡 audio_url과 해당 음성의 persona_id를 전달하십시오. 업로드에 성공한 후, 반환된 data.audio_id와 동일한 persona_id를 사용하여 /suno/audios를 호출합니다:

