비동기 작업

오디오가 처리되는 동안 사용자가 페이지를 떠날 수 있는 긴 텍스트, 일괄 생성, 웹훅 스타일 워크플로 및 UI 흐름에 비동기 TTS 작업을 사용하세요.

작업 생성

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

요구

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

텍스트 해시, 요청한 음성 및 반환된 작업 ID를 데이터베이스에 유지합니다. 작업자 생성 후 충돌이 발생하는 경우 작업 ID로 폴링하는 것이 두 번째 작업을 생성하는 것보다 안전합니다.

이 예에서는 공개 시스템 테스트 음성 00a1b221-6137-4b73-ad62-b0cbce134167를 사용합니다. 연결을 확인한 후 원하는 Voice ID로 교체하세요.

curl https://fishaudio.org/api/open/v1/speech/tts/jobs \
  -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-s2pro","format":"mp3"}'

응답

생성 끝점은 작업 개체와 함께 202 Accepted를 반환합니다. 정확한 작업 필드는 발전할 수 있지만 클라이언트는 최소한 ID와 상태를 저장해야 합니다.

{
  "id": "task_123",
  "status": "queued"
}

취업

GET /api/open/v1/speech/tts/jobs/{taskId}
Authorization: Bearer FISHAUDIO_API_KEY

성공적인 작업에는 단기 오디오 URL을 생성할 수 있는 경우 audioUrl가 포함됩니다. 실패한 작업에는 오류 코드 또는 메시지가 포함됩니다. queued 및 processing를 비종단 상태로 처리하고 백오프로 폴링합니다.

청구 및 크레딧

비동기 작업은 활성화된 모델에 따라 작업 생성 또는 완료 중에 크레딧을 예약하거나 소비할 수 있습니다. 사용자가 명시적으로 두 번째 출력을 요청하지 않는 한 재시도 전략으로 중복 작업을 생성하지 마세요. 작업 ID를 저장하고 복구합니다.

일괄 처리의 경우 많은 수의 작업을 추가하기 전에 동시성을 조절하고 프로필을 확인하세요. 크레딧 부족으로 인해 하나의 작업이 실패하면 계정 소유자가 잔액을 해결할 때까지 배치의 rest를 일시 중지합니다.

오류