POST https://api.acedata.cloud/fish/model입니다.
참고 음성을 임시로만 사용해야 하는 경우 모델을 생성할 필요 없이, Fish TTS API의references를 직접 사용하여 일회성 즉시 복제를 할 수 있습니다. 기존 음색을 페이지네이션으로 검색하려면 Fish Model Query API를 참고하세요._id로 단일 음색 상세 정보를 조회하려면 Fish Model Get API를 참고하세요.
신청 절차
Fish Model API를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API Token을 발급받아 보관하세요.
아직 로그인하거나 가입하지 않은 경우 로그인 페이지로 자동 이동하여 가입 및 로그인을 안내하며, 완료 후 현재 페이지로 자동 반환됩니다.
하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 서비스별로 별도 신청할 필요가 없습니다. 최초 신청 시 무료 크레딧이 제공되어 무료로 체험할 수 있으며, 크레딧이 부족한 경우 콘솔에서 공통 잔액을 충전할 수 있습니다.
📘 전체 문서: Fish Model API →
요청 본문 필드
음색 모델에 대한 자세한 정보는 Fish 공식 문서를 참고하세요.
생성된 음색은 장기간 공개 저장되며, 다른 사용자가 검색하고 사용할 수 있습니다.visibility를 전달할 필요가 없으며,private또는unlist를 전달하더라도 현재 인터페이스는 이에 따라 공개 범위를 변경하지 않습니다.
예시: 공개 복제 음색 생성
주의:성공 응답은 Fish 플랫폼의 ModelEntity 객체를 직접 반환합니다(아래 예시는 당사에서 테스트한 최소 사용 가능 음색이며, 읽기 편하도록 일부 긴 필드는 제거했습니다).voices는 배열이 아닌 문자열(단일 오디오 URL)이어야 합니다.["..."]로 전달하면 업스트림에서 거부됩니다..mp3또는.wav확장자가 포함된 공개 다운로드 가능 직링크 사용을 권장합니다.
_id는 이후 Fish TTS API의 reference_id 필드 값으로 사용할 수 있으며, 해당 복제 음색을 사용한 음성 합성에 사용됩니다.
성공적으로 생성된 음색은 공개 저장되며, Fish Model Query API의 self=true를 통해 현재 호출 사용자가 본 플랫폼에서 생성한 음색을 조회할 수 있습니다. self=true는 목록만 필터링하며, 다른 사용자의 해당 음색 사용을 제한하지 않습니다.
샘플 요구 사항
경험적 기준(업스트림과 동일하며, Fish 공식 문서를 참고할 수 있음):- 길이는 30초 이상, 5분 이내가 가장 좋은 효과를 내며, 10분을 초과하면 한계 효용이 크지 않습니다.
- 샘플링 레이트는 16 kHz 이상이며, 모노 또는 스테레오 모두 가능합니다.
- 내용은 최대한 깨끗해야 합니다: 배경 음악, 에코, 뚜렷한 환경 소음이 없고 동일 화자여야 합니다.
- 권장 형식은
mp3/wav입니다.
enhance_audio_quality: true를 함께 전달하여 업스트림에서 먼저 음질 향상을 수행하도록 할 수 있습니다.
과금 안내
음색 복제 모델 생성(POST /fish/model)은 무료이며, 어떠한 비용도 부과되지 않습니다. 음색 조회 인터페이스(Fish Model Query, Fish Model Get) 역시 과금되지 않습니다. 비용은 이후 Fish TTS를 호출하여 음성을 합성할 때 사용량에 따라 발생합니다.
오류 처리
400 token_mismatched: 요청 파라미터가 누락되었거나 올바르지 않습니다(가장 흔한 경우는voices가 URL이 아니거나 배열로 전달된 경우입니다).400: 참조 오디오를 다운로드할 수 없거나, 길이가 너무 짧거나, 형식을 인식할 수 없는 경우 오디오 URL과 파일 형식을 확인하세요.401 invalid_token: 인증 token이 없거나 유효하지 않습니다.429 too_many_requests: 계정 속도 제한이 발생했습니다.500 api_error: 서버 내부 오류입니다.
결론
이 인터페이스를 호출하려면 공개적으로 접근 가능한 샘플 오디오 URL 하나를 준비하여voices 필드에 넣기만 하면 _id를 얻을 수 있고, 이후 이를 /fish/tts의 reference_id에 전달하면 엔드투엔드 「복제 → 합성」이 완료됩니다. 흔한 주의점은 voices가 반드시 문자열이어야 하며 배열일 수 없다는 것입니다.
MCP를 통해 음색 생성 및 재사용
Fish MCP에서fish_create_model(title="내 음색", voices="https://example.com/authorized-voice.wav")를 호출합니다.
voices는 단일 HTTP(S) 오디오 URL이며, description, cover_image, tags,
texts, enhance_audio_quality, generate_sample도 전달할 수 있습니다.
이 도구는 공개 음색을 장기간 저장하며, 다른 사용자가 발견하고 사용할 수 있습니다. 따라서 처리 및 공개가 허가된
오디오 자료만 사용하세요. 도구에는 비공개 또는 공개하지 않는 옵션이 없습니다. 생성에 성공하면 반환되는 _id는
fish_generate_audio의 reference_id에 사용되며, fish_list_models(self=true)를 통해 직접
저장한 음색을 조회할 수 있습니다. 일회성 참조 음성만 필요한 경우에는 fish_generate_audio의 references를 사용하면 되며,
장기 음색을 생성할 필요가 없습니다.
