Obtener voz

GET

/v1/voices/:voice_id

GET

/v1/voices/:voice_id

curl https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM

{
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "name": "Rachel",
  "category": "professional",
  "fine_tuning": {
    "is_allowed_to_fine_tune": true,
    "state": {
      "eleven_multilingual_v2": "fine_tuned"
    },
    "verification_failures": [],
    "verification_attempts_count": 2,
    "manual_verification_requested": false
  },
  "labels": {
    "accent": "American",
    "age": "middle-aged",
    "description": "expressive",
    "gender": "female",
    "use_case": "social media"
  },
  "description": "A warm, expressive voice with a touch of humor.",
  "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
  "available_for_tiers": [
    "creator",
    "enterprise"
  ],
  "settings": {
    "stability": 1,
    "use_speaker_boost": true,
    "similarity_boost": 1,
    "style": 0,
    "speed": 1
  },
  "sharing": {
    "status": "enabled",
    "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "date_unix": 1714204800,
    "whitelisted_emails": [
      "example@example.com"
    ],
    "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "financial_rewards_enabled": true,
    "free_users_allowed": true,
    "live_moderation_enabled": true,
    "rate": 0.05,
    "notice_period": 30,
    "disable_at_unix": 1714204800,
    "voice_mixing_allowed": false,
    "featured": true,
    "category": "professional",
    "reader_app_enabled": true,
    "liked_by_count": 100,
    "cloned_by_count": 50,
    "name": "Rachel",
    "description": "A female voice with a soft and friendly tone.",
    "labels": {
      "accent": "American",
      "gender": "female"
    },
    "review_status": "allowed",
    "enabled_in_library": true,
    "moderation_check": {
      "date_checked_unix": 1714204800,
      "name_value": "Rachel",
      "name_check": true,
      "description_value": "A female voice with a soft and friendly tone.",
      "description_check": true,
      "sample_ids": [
        "sample1",
        "sample2"
      ],
      "sample_checks": [
        0.95,
        0.98
      ],
      "captcha_ids": [
        "captcha1",
        "captcha2"
      ],
      "captcha_checks": [
        0.95,
        0.98
      ]
    },
    "reader_restricted_on": [
      {
        "resource_type": "read",
        "resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
      }
    ]
  },
  "high_quality_base_model_ids": [
    "eleven_v2_flash",
    "eleven_flash_v2",
    "eleven_turbo_v2_5",
    "eleven_multilingual_v2",
    "eleven_v2_5_flash",
    "eleven_flash_v2_5",
    "eleven_turbo_v2"
  ],
  "verified_languages": [
    {
      "language": "en",
      "model_id": "eleven_multilingual_v2",
      "accent": "american",
      "locale": "en-US",
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3"
    }
  ],
  "voice_verification": {
    "requires_verification": false,
    "is_verified": true,
    "verification_failures": [],
    "verification_attempts_count": 0,
    "language": "en",
    "verification_attempts": [
      {
        "text": "Hello, how are you?",
        "date_unix": 1714204800,
        "accepted": true,
        "similarity": 0.95,
        "levenshtein_distance": 2,
        "recording": {
          "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
          "mime_type": "audio/mpeg",
          "size_bytes": 1000000,
          "upload_date_unix": 1714204800,
          "transcription": "Hello, how are you?"
        }
      }
    ]
  },
  "is_owner": false,
  "is_legacy": false,
  "is_mixed": false
}

Devuelve metadatos sobre una voz específica.

Parámetros de ruta

voice_idstringRequerido

ID de la voz que se utilizará. Puedes usar la ruta de API Obtener voces para mostrar todas las voces disponibles.

Parámetros de consulta

with_settingsbooleanOpcionalValor predeterminado: trueDeprecated

Este parámetro está obsoleto. Se ignora y se eliminará en una versión futura.

Respuesta

Respuesta correcta.

voice_idstring

El ID de la voz.

namestringOpcional

El nombre de la voz.

sampleslist of objects or nullOpcional

Lista de muestras asociadas a la voz.

categoryenumOpcional

La categoría de la voz.

fine_tuningobject or nullOpcional

Información de Finetune de la voz.

labelsmap from strings to stringsOpcional

Etiquetas asociadas a la voz.

descriptionstring or nullOpcional

La descripción de la voz.

preview_urlstring or nullOpcional

La URL de vista previa de la voz.

available_for_tierslist of stringsOpcional

Los niveles para los que está disponible la voz.

settingsobject or nullOpcional

La configuración de la voz.

high_quality_base_model_idslist of stringsOpcional

Los ID de los modelos base para voces de alta calidad.

verified_languageslist of objects or nullOpcional

Los idiomas verificados de la voz.

collection_idslist of strings or nullOpcional

Los ID de las colecciones a las que pertenece esta voz.

safety_controlenum or nullOpcional

Los controles de seguridad de la voz.

Valores permitidos:

voice_verificationobject or nullOpcional

La verificación de voz de la voz.

permission_on_resourcestring or nullOpcional

El permiso sobre el recurso de la voz.

is_ownerboolean or nullOpcional

Indica si la voz pertenece al usuario.

is_legacybooleanOpcionalValor predeterminado: false

Indica si la voz es heredada.

is_mixedbooleanOpcionalValor predeterminado: false

Indica si la voz está mezclada.

favorited_at_unixinteger or nullOpcional

Marca de tiempo Unix en la que la voz se marcó como favorita.

created_at_unixinteger or nullOpcional

La hora de creación de la voz en tiempo Unix.

is_bookmarkedboolean or nullOpcional

Indica si el usuario actual ha guardado la voz como favorita. Solo es relevante para voces de la comunidad (copiadas de la biblioteca).

recording_qualityenum or nullOpcional

La calidad de grabación de la voz según lo determine el proceso de revisión.

Valores permitidos:

labelling_statusenum or nullOpcional

El estado del proceso de revisión de la voz.

Valores permitidos:

recording_quality_reasonstring or nullOpcional

El motivo de la evaluación de calidad de la grabación, según lo determine el proceso de revisión.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Respuesta

Errores