Obter projeto do Estúdio

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": []
}

Retorna informações sobre um projeto específico do Estúdio. Este endpoint retorna informações mais detalhadas sobre um projeto do que GET /v1/studio.

Parâmetros de caminho

project_idstringObrigatório

O ID do projeto a ser usado. Você pode usar o endpoint Listar projetos para listar todos os projetos disponíveis.

Parâmetros de consulta

share_idstring or nullOpcional

O ID de compartilhamento do projeto

Resposta

Resposta bem-sucedida

project_idstring

O ID do projeto.

namestring

O nome do projeto.

create_date_unixinteger

A data de criação do projeto.

created_by_user_idstring or null

O ID de usuário de quem criou o projeto.

default_title_voice_ref_idstring

O ID de referência de voz padrão para títulos do projeto.

default_paragraph_voice_ref_idstring

O ID de referência de voz padrão para parágrafos do projeto.

default_model_idstring

O ID do modelo padrão.

can_be_downloadedboolean

Se o projeto pode ser baixado.

volume_normalizationboolean

Se o projeto usa normalização de volume.

stateenum

O estado do projeto.

Valores permitidos:

access_levelenum

O nível de acesso do projeto.

Valores permitidos:

quality_presetenum

O nível predefinido de qualidade do projeto.

Valores permitidos:

chapterslist of objects

Lista de capítulos do projeto e seus metadados.

pronunciation_dictionary_versionslist of objects

Lista de versões de dicionários de pronúncia do projeto e seus metadados.

pronunciation_dictionary_locatorslist of objects

Lista de localizadores de dicionários de pronúncia.

apply_text_normalizationenum

Se a normalização de texto é aplicada ao projeto.

Valores permitidos:

assetslist of objects

Lista de recursos enviados, como vídeos e áudios.

voiceslist of objects

Lista de vozes configuradas no projeto.

quality_check_onbooleanDeprecated

Se a verificação de qualidade está ativada para este projeto.

quality_check_on_when_bulk_convertbooleanDeprecated

Se a verificação de qualidade está ativada no projeto durante a conversão em massa.

default_title_voice_idstringSomente leituraDeprecated

O ID da voz padrão para títulos.

default_paragraph_voice_idstringSomente leituraDeprecated

O ID da voz padrão para parágrafos.

last_conversion_date_unixinteger or nullOpcional

A data da última conversão do projeto.

titlestring or nullOpcional

O título do projeto.

authorstring or nullOpcional

O autor do projeto.

descriptionstring or nullOpcional

A descrição do projeto.

genreslist of strings or nullOpcional

Lista de gêneros do projeto.

cover_image_urlstring or nullOpcional

A URL da imagem de capa do projeto.

target_audienceenum or nullOpcional

O público-alvo do projeto.

Valores permitidos:

languagestring or nullOpcional

Código de idioma de duas letras (ISO 639-1) do idioma do projeto.

content_typestring or nullOpcional

O tipo de conteúdo do projeto, por exemplo, ‘Novel’ ou ‘Short Story’

original_publication_datestring or nullOpcional

A data original de publicação do projeto.

mature_contentboolean or nullOpcional

Se o projeto contém conteúdo adulto.

isbn_numberstring or nullOpcional

O número ISBN do projeto.

fictionenum or nullOpcional

Se o projeto é uma obra de ficção.

Valores permitidos:

creation_metaobject or nullOpcional

Os metadados de criação do projeto.

source_typeenum or nullOpcional

O tipo de origem do projeto.

chapters_enabledboolean or nullOpcionalPadrão é true

Se os capítulos estão ativados para o projeto.

captions_enabledboolean or nullOpcionalPadrão é true

Se as legendas estão ativadas para o projeto.

caption_styleobject or nullOpcional

Estilo global a ser aplicado a todas as legendas

caption_style_template_overridesmap from strings to objects or nullOpcional

Alterações de estilo feitas nos modelos fornecidos

public_share_idstring or nullOpcional

O ID de compartilhamento público do projeto.

aspect_ratioenum or nullOpcional

A proporção do projeto.

Valores permitidos:

agent_settingsobject or nullOpcional

Configurações relacionadas ao agente para o projeto

experimentalmap from strings to anyOpcional

Recursos experimentais para o projeto.

base_voiceslist of objects or nullOpcional

Lista de vozes usadas pelo projeto.

publishing_readobject or nullOpcional

Os dados do ElevenReader, caso o livro tenha sido publicado.

Erros

422

Unprocessable Entity Error

Parâmetros de caminho

Cabeçalhos

Parâmetros de consulta

Resposta

Erros