HopBase DocsSubir audio para clonar
Paso 1 del flujo de clonación: suba una grabación o un fragmento de ejemplo y obtenga un `file_id` de un solo uso; gratis.
/v1/files/uploadSe envía como multipart/form-data y solo acepta los campos purpose y file; cualquier otro devuelve 400. voice_clone es la grabación a clonar y prompt_audio es un fragmento de ejemplo opcional. El formato y el tamaño se validan al subir; la duración (voice_clone de 10 segundos a 5 minutos, prompt_audio menos de 8 segundos) se valida al clonar.
Cada archivo se usa una sola vez: tras una clonación correcta, el audio fuente y el de ejemplo se eliminan automáticamente; si la clonación falla se conservan y puede reintentar con otros parámetros. Los archivos que no se usen en las 24 horas siguientes a la subida se eliminan automáticamente. El audio subido no se puede descargar. El grupo de la clave debe incluir los modelos de voz de MiniMax.
Clone solo su propia voz o una voz para la que tenga autorización expresa y por escrito de quien habla.
Encabezados
Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado
Parámetros del cuerpomultipart
voice_clone es la grabación a clonar; prompt_audio, el fragmento de ejemplo
Valoresvoice_cloneprompt_audio
Un solo archivo, con extensión .mp3 / .m4a / .wav, ≤20 MB
Respuesta
200Subida correcta
Archivo subido
ID de archivo; al clonar se pasa en file_id o clone_prompt.prompt_audio
Bytes del archivo
Hora de subida, en segundos Unix
Nombre del archivo
voice_clone o prompt_audio
Valoresvoice_cloneprompt_audio
Si tiene éxito, {"status_code": 0, "status_msg": "success"}; los errores no van aquí, sino con un código de estado distinto de 200 y un objeto error
0 si tiene éxito
success si tiene éxito
Errores
purpose no válido, archivo vacío, formato no admitido, o archivos o campos de másmissing_api_key / invalid_api_key / api_key_expired)model_not_found) o la ruta no pertenece a ese grupo (route_not_found)file exceeds the 20 MiB limit