API ReferenciaGestión de voz
Clonación de voz
Sube audio de referencia y crea una voz personalizada.
Clonación de voz
POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-dataURL completa:
https://fishaudio.org/api/open/v1/voicesLa creación de voz utiliza audio de referencia y el flujo de creación de FishAudio. La ruta Open API ignora las anulaciones del proveedor, por lo que no es necesario enviar un campo provider.
Campos de solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
name | cadena | Sí | Nombre de la voz |
audioFiles | archivo[] | Sí | Uno o más archivos de audio de referencia |
description | cadena | No | Descripción de voz |
referenceText | cadena | No | Transcripción del audio de referencia |
visibility | cadena | No | private o public. Valor predeterminado: private |
languages | cadena | No | Matriz de cadenas JSON, como '["zh","en"]' |
Extensiones de archivo compatibles: aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav y webm. Cada archivo puede tener hasta 10MB.
No establezca el límite multiparte manualmente. Cuando utilice curl -F, el navegador FormData o un SDK, deje que el cliente genere Content-Type.
Ejemplo 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"Respuesta
{
"voiceId": "voice_abc123",
"title": "My cloned voice",
"description": "Chinese narration voice",
"createdAt": "2026-07-09T00:00:00.000Z"
}Almacene el voiceId devuelto y luego páselo directamente al generar voz.
Errores
| Estado | Significado |
|---|---|
400 | Campos faltantes, tipo de archivo no admitido o archivo de gran tamaño |
401 | Falta la clave API o no es válida |
403 | La cuenta no puede crear voces |
429 | Las solicitudes de creación de voz son demasiado frecuentes |
500 | La creación de voz falló en el servidor |
La creación de una voz registra el uso de Open API y está sujeta a la cuota de Open API de la cuenta actual y a la asignación del proveedor.