Referência APIGerenciamento de voz
Clonagem de voz
Carregue o áudio de referência e crie uma voz personalizada.
Clonagem de voz
POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-dataURL completo:
https://fishaudio.org/api/open/v1/voicesA criação de voz usa áudio de referência e o fluxo de criação FishAudio. A rota Open API ignora substituições de provedor, portanto, você não precisa enviar um campo provider.
Campos de solicitação
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | corda | Sim | Nome de voz |
audioFiles | arquivo[] | Sim | Um ou mais arquivos de áudio de referência |
description | corda | Não | Descrição da voz |
referenceText | corda | Não | Transcrição do áudio de referência |
visibility | corda | Não | private ou public. Padrão: private |
languages | corda | Não | Matriz de string JSON, como '["zh","en"]' |
Extensões de arquivo suportadas: aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav e webm. Cada arquivo pode ter até 10MB.
Não defina o limite multipartes manualmente. Ao usar curl -F, navegador FormData ou SDK, deixe o cliente gerar Content-Type.
Exemplo curl
curl -X POST "https://fishaudio.org/api/open/v1/voices" \
-H "Authorization: Bearer FISHAUDIO_API_KEY" \
-F "name=My cloned voice" \
-F "description=Chinese narration voice" \
-F "visibility=private" \
-F 'languages=["zh"]' \
-F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
-F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"Resposta
{
"voiceId": "voice_abc123",
"title": "My cloned voice",
"description": "Chinese narration voice",
"createdAt": "2026-07-09T00:00:00.000Z"
}Armazene o voiceId retornado e passe-o diretamente ao gerar a fala.
Erros
| Estado | Significado |
|---|---|
400 | Campos ausentes, tipo de arquivo não suportado ou arquivo grande |
401 | A chave API está ausente ou é inválida |
403 | A conta não pode criar vozes |
429 | Solicitações de criação de voz são muito frequentes |
500 | Falha na criação de voz no servidor |
A criação de uma voz registra o uso do Open API e está sujeita à cota Open API da conta corrente e à alocação do provedor.