Açıklamalar İngilizce
Fish Audio Voices
The voice catalogue of the Fish Audio text-to-speech service: active voices, filterable
by language (ru, en, es), gender (male/female) and a search string. Put the
voice_id from the response (a 32-character hex string, not a UUID) into
tts_settings.voice_id of a template with service_key: fishaudio; the voice_id
parameter finds one voice by its exact id — the name of a voice already chosen in a
template.
Your own cloned voice does not show up in the catalogue — its voice_id comes from
GET /voices/fishaudio/clones (only once the clone is ready).
If the service is closed to the key owner (closed testing), the answer is 404
with reason: service_not_found.
Required key permission: voices.read.
Bu sayfada(3)
Parametreler
Giriş alanları doğrudan istek satırında yer alır: bir değer girin, hazır URL'yi alın. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.
- stringsorgudaisteğe bağlı≤ 16 karakter
Catalogue language:
ru,enores. - stringsorgudaisteğe bağlı≤ 32 karakter
Voice gender:
maleorfemale. - stringsorgudaisteğe bağlı≤ 255 karakter
Search by voice name and description.
- stringsorgudaisteğe bağlı≤ 255 karakter
Exact voice
voice_id— look up the name and preview of a voice already chosen in a template without paging through the catalogue. A voice withdrawn from the catalogue is not returned: the list is empty. - integersorgudaisteğe bağlı≥ 1
Page number, starting at
1. - integersorgudaisteğe bağlı1..200
How many records to return per page. Pagination metadata sits next to
items:current_page,last_page,per_page,total.
Olası yanıtlar
200Success. The payload is in data.
Success. The payload is in data.
{
"success": true,
"message": "Success",
"data": {
"items": [
{
"id": 31,
"voice_id": "8ef4a238714b45718ce04243307c57a7",
"name": "Russian Narrator",
"description": "Calm male narrator.",
"language": "ru",
"languages": [
"ru"
],
"gender": "male",
"tags": [
"male",
"narration"
],
"author_name": "Fish",
"task_count": 120450,
"like_count": 380,
"preview_url": "https://s3.example.com/fishaudio/voice-previews/8ef4a238714b45718ce04243307c57a7.mp3?X-Amz-Expires=3600"
},
{
"id": 32,
"voice_id": "5c3a9e1b7d2f4086a1b4e0c9d8f72a63",
"name": "Warm Storyteller",
"description": null,
"language": "en",
"languages": [
"en",
"es"
],
"gender": "female",
"tags": [
"female"
],
"author_name": null,
"task_count": 8120,
"like_count": 54,
"preview_url": null
}
],
"current_page": 1,
"last_page": 1,
"per_page": 50,
"total": 2
}
}Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.
A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.
datazorunluThe response payload.
object
The response payload.
itemszorunluFish Audio catalogue voices on this page.
array<FishAudioVoice>FishAudioVoice
Fish Audio catalogue voices on this page.
Internal id of the catalogue entry. Not needed for narration — voice_id goes into the template.
The Fish Audio voice id (a 32-character hex string, not a UUID) — the value for tts_settings.voice_id of a template with service_key: fishaudio.
Voice name.
Voice description from Fish Audio, or null.
Catalogue language the voice was imported under (ru, en, es), or null.
All languages of the voice according to Fish Audio.
Voice gender: male, female, or null.
How many times the voice has been used at Fish Audio — a popularity measure; the catalogue is sorted by it.
Number of likes of the voice at Fish Audio.
A temporary link (60 minutes) to an MP3 sample of the voice, or null while the preview has not been downloaded yet.
Current page number, starting from one.
Number of the last page.
Page size the server applied.
Total number of records matching the filter.
401The key is missing, unknown, disabled or expired.
The key is missing, unknown, disabled or expired.
{
"success": false,
"message": "API key is missing. Provide it in the X-API-KEY header.",
"data": null
}Always false in error responses.
Error text in the key's language (set through the X-Locale header).
Always null when the request is rejected before processing.
403The key lacks the voices.read permission.
The key lacks the voices.read permission.
{
"success": false,
"message": "This API key does not have permission to perform this action."
}Always false in error responses.
Error text in the key's language (set through the X-Locale header).
404The Fish Audio service is closed to the key owner (reason: service_not_found).
The Fish Audio service is closed to the key owner (reason: service_not_found).
{
"success": false,
"message": "Service not found.",
"reason": "service_not_found",
"error_code": "service_not_found"
}Always false in error responses.
The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.
Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, not on the message text.
The same machine-readable code as in reason — a second name for the field. The values always match.
422Validation error, for example per_page above 200. Offending fields are listed in errors.
Validation error, for example per_page above 200. Offending fields are listed in errors.
{
"message": "string",
"errors": {}
}Errors overview.
errorszorunluA detailed description of each field that failed validation.
object
A detailed description of each field that failed validation.
İlgili içerik
Nesneler
Komşu işlemler
Daha fazla
Bu sayfayı yapay zekâya verin
spesifikasyon 0.0.1