HTTP 동기화

요청-응답 흐름에 맞게 텍스트가 충분히 짧고 제품이 계속하기 전에 오디오를 기다릴 수 있는 경우 동기화 TTS 엔드포인트를 사용하세요. 긴 텍스트, 일괄 작업 또는 사용자에게 표시되는 대기열의 경우 비동기 작업을 사용하세요.

클라이언트가 OpenAI /v1/audio/speech 요청 형태를 예상하는 경우 OpenAI 호환 TTS 엔드포인트를 대신 사용하세요.

POST /api/open/v1/speech/tts
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json

요구

{
  "text": "Hello from Fish Audio.",
  "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "modelId": "fishaudio-s21pro-flash",
  "format": "mp3"
}

공통 필드:

새로운 통합에서는 GET /api/open/v1/voices의 voiceId를 사용해야 합니다. 빠른 연결 테스트를 위해서는 공용 시스템 음성 00a1b221-6137-4b73-ad62-b0cbce134167를 사용하세요.

이전 SDK 또는 기타 사이트 변형의 필드를 현재 해외 Open API 계약에 혼합하지 마십시오.

curl https://fishaudio.org/api/open/v1/speech/tts \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from Fish Audio.","voiceId":"00a1b221-6137-4b73-ad62-b0cbce134167","modelId":"fishaudio-s21pro-flash","format":"mp3"}' \
  --output speech.mp3

응답

cache가 false이거나 생략된 경우 성공적인 응답은 이진 오디오를 반환합니다. cache가 true이면 성공적인 응답은 JSON 메타데이터를 반환합니다.

{
  "audio_url": "https://example.com/generated.mp3",
  "credits_used": 12,
  "quota_remaining": 987988
}

클라이언트는 하나의 응답 형태를 가정하는 대신 Content-Type 헤더에서 분기해야 합니다. URL이 수명이 짧은 경우 생성된 오디오를 지속 가능한 저장소에 저장하세요.

청구 및 크레딧

동기화 TTS는 생성된 콘텐츠 및 모델 구성을 기반으로 크레딧을 소비합니다. 엔드포인트는 HTTP 요청 내에서 생성을 수행하므로 클라이언트 시간 초과가 항상 서버가 작업을 취소했다는 의미는 아닙니다. 사용자 작업을 재시도할 때 자체 애플리케이션 계층에서 멱등성을 사용하세요.

정확한 사후 생성 잔액이 필요한 경우 요청이 완료된 후 Profile을 호출하세요. 대규모 배치의 경우 각 작업이 지속적인 ID와 상태를 갖도록 비동기 작업을 선호합니다.

오류