API 참조음성을 텍스트로
음성을 텍스트로
Open API를 통해 오디오를 녹음합니다.
음성을 텍스트로
Speech to Text는 오디오 URL을 텍스트 및 선택적 세그먼트 메타데이터로 변환합니다. 업로드된 오디오, 통화 녹음, 작성자 워크플로 및 백엔드 전사 작업에 사용하세요.
POST /api/open/v1/speech/transcriptions
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json요구
{
"audioUrl": "https://example.com/audio.mp3",
"language": "en"
}audioUrl는 API 서비스를 통해 연결할 수 있어야 합니다. 파일이 비공개인 경우 처리할 수 있을 만큼 오랫동안 유효하게 유지되는 단기 서명 URL을 생성하세요. language는 선택 사항입니다. 원본 언어를 알고 있는 경우 en, zh 또는 ru와 같은 언어 힌트를 사용하세요.
curl https://fishaudio.org/api/open/v1/speech/transcriptions \
-H "Authorization: Bearer FISHAUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audioUrl":"https://example.com/audio.mp3","language":"en"}'응답
{
"text": "This is the transcription result.",
"duration": 12.4,
"segments": [],
"credits_used": 13,
"quota_remaining": 987987
}세그먼트 형태는 모델 및 계정 기능에 따라 다를 수 있습니다. 파서는 세그먼트 메타데이터를 선택 사항으로 처리하고 text를 기본 결과로 사용해야 합니다.
청구 및 크레딧
일반적으로 녹음 비용은 오디오 지속 시간을 기준으로 청구됩니다. 가능하다면 특히 사용자가 업로드한 녹음을 제출하기 전에 파일 기간을 확인하세요. 제품이 한 번에 많은 업로드를 허용하는 경우 작업을 대기열에 추가하고 배치 간 계정 잔액을 확인하세요.
오디오 처리가 시작되기 전에 요청이 실패하면 크레딧은 완료된 텍스트 변환과 동일하게 처리되어서는 안 됩니다. 운영 조정을 위해 응답 필드와 프로필 확인을 사용합니다.
오류
| 상태 | 의미 | 액션 |
|---|---|---|
400 | 잘못된 URL, 지원되지 않는 오디오 또는 잘못된 형식의 JSON | 요청 수정 |
401 | API 키가 없거나 잘못되었습니다. | 자격 증명 새로 고침 |
402 | 크레딧 또는 할당량이 부족합니다 | 일괄 처리 중지 |
422 | 오디오에 연결할 수 있지만 처리할 수 없습니다 | 사용자에게 다른 파일을 요청하세요 |
500 | 전사 서비스 실패 | URL이 유효한 경우 백오프로 재시도 |