Obtener proyecto de Studio

GET

/v1/studio/projects/:project_id

GET

/v1/studio/projects/:project_id

curl https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM

{
  "project_id": "aw1NgEzBg83R7vgmiJt6",
  "name": "My Project",
  "create_date_unix": 1714204800,
  "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx",
  "default_title_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_paragraph_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_model_id": "eleven_multilingual_v2",
  "can_be_downloaded": true,
  "volume_normalization": true,
  "state": "default",
  "access_level": "viewer",
  "quality_preset": "standard",
  "chapters": [
    {
      "chapter_id": "aw1NgEzBg83R7vgmiJt6",
      "name": "Chapter 1",
      "can_be_downloaded": true,
      "state": "converting",
      "last_conversion_date_unix": 1714204800,
      "conversion_progress": 0.5,
      "statistics": {
        "characters_unconverted": 1000,
        "characters_converted": 500,
        "paragraphs_converted": 20,
        "paragraphs_unconverted": 10,
        "credits_needed_to_convert": 1000,
        "voice_statistics": [
          {
            "project_voice_ref_id": "voice123",
            "characters_unconverted": 600,
            "characters_converted": 300,
            "voice_id": "voice123"
          },
          {
            "project_voice_ref_id": "voice456",
            "characters_unconverted": 400,
            "characters_converted": 200,
            "voice_id": "voice456"
          }
        ]
      },
      "last_conversion_error": "Error message"
    }
  ],
  "pronunciation_dictionary_versions": [],
  "pronunciation_dictionary_locators": [],
  "apply_text_normalization": "auto",
  "assets": [],
  "voices": [],
  "quality_check_on": false,
  "quality_check_on_when_bulk_convert": false,
  "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
  "last_conversion_date_unix": 1714204800,
  "title": "My Project",
  "author": "John Doe",
  "description": "This is a description of my project.",
  "genres": [
    "Novel",
    "Short Story"
  ],
  "cover_image_url": "https://example.com/cover.jpg",
  "target_audience": "young adult",
  "language": "en",
  "content_type": "Novel",
  "original_publication_date": "2025-01-01",
  "mature_content": false,
  "isbn_number": "978-90-274-3964-2",
  "fiction": "fiction",
  "creation_meta": {
    "creation_progress": 0.5,
    "status": "pending",
    "type": "blank"
  },
  "public_share_id": "abc123def456789",
  "experimental": {},
  "base_voices": []
}

Devuelve información sobre un proyecto específico de Studio. Esta ruta de API devuelve información más detallada sobre un proyecto que GET /v1/studio.

Parámetros de ruta

project_idstringRequerido

El ID del proyecto que se usará. Puedes usar la ruta List projects para enumerar todos los proyectos disponibles.

Parámetros de consulta

share_idstring or nullOpcional

El ID para compartir el proyecto

Respuesta

Respuesta correcta.

project_idstring

El ID del proyecto.

namestring

El nombre del proyecto.

create_date_unixinteger

La fecha de creación del proyecto.

created_by_user_idstring or null

El ID de usuario que creó el proyecto.

default_title_voice_ref_idstring

El ID de referencia de voz de proyecto predeterminado para títulos.

default_paragraph_voice_ref_idstring

El ID de referencia de voz de proyecto predeterminado para párrafos.

default_model_idstring

El ID del modelo predeterminado.

can_be_downloadedboolean

Indica si el proyecto se puede descargar.

volume_normalizationboolean

Indica si el proyecto usa normalización de volumen.

stateenum

El estado del proyecto.

Valores permitidos:

access_levelenum

El nivel de acceso del proyecto.

Valores permitidos:

quality_presetenum

El nivel de preajuste de calidad del proyecto.

Valores permitidos:

chapterslist of objects

Lista de capítulos del proyecto y sus metadatos.

pronunciation_dictionary_versionslist of objects

Lista de versiones de diccionarios de pronunciación del proyecto y sus metadatos.

pronunciation_dictionary_locatorslist of objects

Lista de localizadores de diccionarios de pronunciación.

apply_text_normalizationenum

Indica si se aplica la normalización de texto al proyecto.

Valores permitidos:

assetslist of objects

Lista de recursos subidos, p. ej., vídeos y audios.

voiceslist of objects

Lista de voces configuradas para el proyecto.

quality_check_onbooleanDeprecated

Indica si el control de calidad está activado para este proyecto.

quality_check_on_when_bulk_convertbooleanDeprecated

Indica si el control de calidad está activado en el proyecto al convertir en bloque.

default_title_voice_idstringSolo lecturaDeprecated

El ID de voz predeterminado para títulos.

default_paragraph_voice_idstringSolo lecturaDeprecated

El ID de voz predeterminado para párrafos.

last_conversion_date_unixinteger or nullOpcional

La fecha de la última conversión del proyecto.

titlestring or nullOpcional

El título del proyecto.

authorstring or nullOpcional

El autor del proyecto.

descriptionstring or nullOpcional

La descripción del proyecto.

genreslist of strings or nullOpcional

Lista de géneros del proyecto.

cover_image_urlstring or nullOpcional

La URL de la imagen de portada del proyecto.

target_audienceenum or nullOpcional

El público objetivo del proyecto.

Valores permitidos:

languagestring or nullOpcional

Código de idioma de dos letras (ISO 639-1) del idioma del proyecto.

content_typestring or nullOpcional

El tipo de contenido del proyecto; por ejemplo, ‘Novel’ o ‘Short Story’

original_publication_datestring or nullOpcional

La fecha de publicación original del proyecto.

mature_contentboolean or nullOpcional

Indica si el proyecto contiene contenido para adultos.

isbn_numberstring or nullOpcional

El número ISBN del proyecto.

fictionenum or nullOpcional

Indica si el proyecto es ficción.

Valores permitidos:

creation_metaobject or nullOpcional

Los metadatos de creación del proyecto.

source_typeenum or nullOpcional

El tipo de origen del proyecto.

chapters_enabledboolean or nullOpcionalValor predeterminado: true

Indica si los capítulos están activados para el proyecto.

captions_enabledboolean or nullOpcionalValor predeterminado: true

Indica si los subtítulos están activados para el proyecto.

caption_styleobject or nullOpcional

Estilo global que se aplicará a todos los subtítulos.

caption_style_template_overridesmap from strings to objects or nullOpcional

Cambios de estilo realizados en las plantillas proporcionadas.

public_share_idstring or nullOpcional

El ID público para compartir el proyecto.

aspect_ratioenum or nullOpcional

La relación de aspecto del proyecto.

Valores permitidos:

agent_settingsobject or nullOpcional

Ajustes del proyecto relacionados con el agente

experimentalmap from strings to anyOpcional

Funciones experimentales del proyecto.

base_voiceslist of objects or nullOpcional

Lista de voces utilizadas por el proyecto.

publishing_readobject or nullOpcional

Los datos de ElevenReader si se publicó el libro.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Respuesta

Errores