API 문서 및 디버깅 도구

텍스트 음성 변환

보이스 클론

립싱크

기타

텍스트 음성 변환 (HTTP)

HTTP로 TTS API를 테스트합니다.

텍스트 음성 변환 API

엔드포인트

POST /api/open/tts

요청 헤더

// undefined
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN  // API 키

// undefined
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_TOKEN  // API 키

요청 파라미터

예시 요청 파라미터

Version Notes:

  • • Legacy Versions: v1, v2, s1 (basic text-to-speech functionality)
  • • V3 Versions: v3-turbo, v3-hd (advanced features including emotion control and language boost)
  • • The system will automatically select the corresponding version based on model configuration, no manual specification needed

응답 데이터

// undefined (cache=false) - 200
Content-Type: audio/mpeg
<undefined>

// undefined (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // undefined
  "audio_url": string,       // undefined
  "format": string,          // undefined
  "characters_used": number, // undefined
  "quota_remaining": number  // undefined
}

// undefined
{
  "error": string     // undefined
}

CURL 예시

# undefined - undefined
curl -X POST https://fishaudio.net/api/open/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "reference_id": "your_model_id",
    "text": "undefined",
    "speed": 1.0,
    "volume": 0,
    "version": "s1",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# undefined - undefined
curl -X POST https://fishaudio.net/api/open/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "reference_id": "your_model_id",
    "text": "undefined",
    "speed": 1.0,
    "volume": 0,
    "version": "v3-hd",
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# undefined (undefined)

온라인 디버그

상태 코드

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error