Listar voces

POST/v1/get_voice

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.

Listar voces

curl https://api.hop-base.com/v1/get_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning"
  }'

200application/json

{
  "system_voice": null,
  "voice_cloning": [
    {
      "voice_id": "MyNarrator01",
      "description": [],
      "created_time": "2026-09-25"
    }
  ],
  "voice_generation": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Encabezados

Authorization:obligatoriostring

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

Parámetros del cuerpoJSON

voice_type:obligatoriostring

Categoría de voces a listar

Valoressystemvoice_cloningvoice_generationall

Respuesta

200Lista de voces

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:opcionalobject

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

400voice_type must be one of system, voice_cloning, voice_generation, all, o campos desconocidos

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)

Encabezados

Parámetros del cuerpoJSON

Respuesta

Errores

Páginas relacionadas