Saltar al contenido

Listar voces

Lista las voces del sistema, sus voces clonadas de MiniMax o sus voces clonadas de Doubao; gratis.

POST/v1/get_voice

MiniMax y Doubao comparten esta ruta; elija una serie abajo para ver su cuerpo de solicitud y su respuesta.

MiniMax Speech 2.8: Con voice_type igual a voice_cloning se listan sus voces clonadas; con system, las voces del sistema; con all, todas; voice_generation siempre está vacío. Las categorías no solicitadas son null en la respuesta. Solo se listan las voces clonadas con éxito en su cuenta que no se hayan eliminado ni caducado. Las voces del sistema también se pueden ver directamente en Voces del sistema.

Clonación de voz de Doubao 2.0: el cuerpo debe incluir "model": "seed-icl-2.0". Sin voice_id, la respuesta trae un arreglo voices con todas sus voces clonadas; con él, la respuesta es solo el objeto de esa voz, y una voz que no existe o no es de su cuenta devuelve 400 unknown_voice.

Encabezados

Authorization:obligatoriostring

Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado

Parámetros del cuerpoJSON

Familia
Documentación del modelo
voice_type:obligatoriostring

Categoría de voces a listar

Valoressystemvoice_cloningvoice_generationall

Respuesta

200Lista de voces

Familia
system_voice:opcionalarray of object o null

Voces del sistema; null si no se solicitaron

voice_cloning:opcionalarray of object o null

Sus voces clonadas; null si no se solicitaron

voice_generation:opcionalarray of object o null

Siempre un array vacío; null si no se solicitó

base_resp:obligatorioobject

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

Errores

400MiniMax: voice_type must be one of system, voice_cloning, voice_generation, all, o hay un campo desconocido. Doubao: falta model, hay un campo desconocido, o unknown_voice (el voice_id no existe)
401Falta la clave, la clave no es válida o ha caducado (missing_api_key / invalid_api_key / api_key_expired)
413Cuerpo de la solicitud mayor de 64 KiB: request body is too large
503El registro de voces o archivos no está disponible temporalmente; reintente más tarde (p. ej. voice registry is temporarily unavailable; please retry)

Páginas relacionadas