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

Restituisce informazioni su uno specifico progetto Studio. Questo endpoint restituisce informazioni più dettagliate su un progetto rispetto a GET /v1/studio.

Parametri di percorso

project_idstringObbligatorio

L'ID del progetto da usare. Puoi usare l'endpoint Elenca i progetti per elencare tutti i progetti disponibili.

Parametri di query

share_idstring or nullOpzionale

L'ID di condivisione del progetto

Risposta

Risposta riuscita

project_idstring

L'ID del progetto.

namestring

Il nome del progetto.

create_date_unixinteger

La data di creazione del progetto.

created_by_user_idstring or null

L'ID utente di chi ha creato il progetto.

default_title_voice_ref_idstring

L'ID di riferimento vocale predefinito del progetto per i titoli.

default_paragraph_voice_ref_idstring

L'ID di riferimento vocale predefinito del progetto per i paragrafi.

default_model_idstring

L'ID del modello predefinito.

can_be_downloadedboolean

Se il progetto può essere scaricato.

volume_normalizationboolean

Se il progetto usa la normalizzazione del volume.

stateenum

Lo stato del progetto.

Valori consentiti:

access_levelenum

Il livello di accesso del progetto.

Valori consentiti:

quality_presetenum

Il livello del preset di qualità del progetto.

Valori consentiti:

chapterslist of objects

Elenco dei capitoli del progetto e dei relativi metadati.

pronunciation_dictionary_versionslist of objects

Elenco delle versioni dei dizionari di pronuncia del progetto e dei relativi metadati.

pronunciation_dictionary_locatorslist of objects

Elenco dei locator dei dizionari di pronuncia.

apply_text_normalizationenum

Se la normalizzazione del testo viene applicata al progetto.

Valori consentiti:

assetslist of objects

Elenco delle risorse caricate, ad esempio video e audio.

voiceslist of objects

Elenco delle voci configurate per il progetto.

quality_check_onbooleanDeprecated

Se il controllo qualità è abilitato per questo progetto.

quality_check_on_when_bulk_convertbooleanDeprecated

Se il controllo qualità è abilitato nel progetto durante la conversione in blocco.

default_title_voice_idstringSola letturaDeprecated

L'ID della voce predefinita per i titoli.

default_paragraph_voice_idstringSola letturaDeprecated

L'ID della voce predefinita per i paragrafi.

last_conversion_date_unixinteger or nullOpzionale

La data dell'ultima conversione del progetto.

titlestring or nullOpzionale

Il titolo del progetto.

authorstring or nullOpzionale

L'autore del progetto.

descriptionstring or nullOpzionale

La descrizione del progetto.

genreslist of strings or nullOpzionale

Elenco dei generi del progetto.

cover_image_urlstring or nullOpzionale

L'URL dell'immagine di copertina del progetto.

target_audienceenum or nullOpzionale

Il pubblico di destinazione del progetto.

Valori consentiti:

languagestring or nullOpzionale

Codice lingua di due lettere (ISO 639-1) della lingua del progetto.

content_typestring or nullOpzionale

Il tipo di contenuto del progetto, ad esempio 'Novel' o 'Short Story'

original_publication_datestring or nullOpzionale

La data di pubblicazione originale del progetto.

mature_contentboolean or nullOpzionale

Se il progetto contiene contenuti per adulti.

isbn_numberstring or nullOpzionale

Il numero ISBN del progetto.

fictionenum or nullOpzionale

Se il progetto è di narrativa.

Valori consentiti:

creation_metaobject or nullOpzionale

I metadati di creazione del progetto.

source_typeenum or nullOpzionale

Il tipo di sorgente del progetto.

chapters_enabledboolean or nullOpzionalePredefinito a true

Se i capitoli sono abilitati per il progetto.

captions_enabledboolean or nullOpzionalePredefinito a true

Se i sottotitoli sono abilitati per il progetto.

caption_styleobject or nullOpzionale

Stile globale da applicare a tutti i sottotitoli

caption_style_template_overridesmap from strings to objects or nullOpzionale

Modifiche di stile apportate ai template forniti

public_share_idstring or nullOpzionale

L'ID pubblico di condivisione del progetto.

aspect_ratioenum or nullOpzionale

Le proporzioni del progetto.

Valori consentiti:

agent_settingsobject or nullOpzionale

Impostazioni relative all'agente per il progetto

experimentalmap from strings to anyOpzionale

Funzionalità sperimentali per il progetto.

base_voiceslist of objects or nullOpzionale

Elenco delle voci utilizzate dal progetto.

publishing_readobject or nullOpzionale

I dati di ElevenReader, se il libro è stato pubblicato.

Errori

422

Unprocessable Entity Error

Parametri di percorso

Header

Parametri di query

Risposta

Errori