Crear una voz nueva a partir de una vista previa de voz

POST

/v1/text-to-voice

POST

/v1/text-to-voice

curl -X POST https://api.elevenlabs.io/v1/text-to-voice \
     -H "Content-Type: application/json" \
     -d '{
  "voice_name": "Sassy squeaky mouse",
  "voice_description": "A sassy squeaky mouse",
  "generated_voice_id": "37HceQefKmEi3bGovXjL"
}'

{
  "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
}

Crea una voz a partir de una vista previa de voz generada previamente. Debes llamar a esta ruta de API después de obtener un generated_voice_id mediante POST /v1/text-to-voice/design o POST /v1/text-to-voice/:voice_id/remix.

Solicitud

This endpoint expects an object.

voice_namestringRequerido

Nombre que se utilizará para la voz creada.

voice_descriptionstringRequerido20-1000 characters

Descripción que se utilizará para la voz creada.

generated_voice_idstringRequerido

El generated_voice_id que se va a crear; შეგიძლues obtenerlo mediante POST /v1/text-to-voice/design, POST /v1/text-to-voice/:voice_id/remix o las cabeceras de respuesta al generar vistas previas.

labelsmap from strings to strings or nullOpcional

Metadatos opcionales para añadir a la voz creada. El valor predeterminado es None.

played_not_selected_voice_idslist of strings or nullOpcional

Lista de ID de voces que el usuario ha reproducido, pero no seleccionado. Se utiliza para RLHF.

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

409

Conflict Error

422

Unprocessable Entity Error

Encabezados

Solicitud

Respuesta

Errores