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

Renvoie des informations sur un projet Studio spécifique. Ce point de terminaison fournit des informations plus détaillées sur un projet que GET /v1/studio.

Paramètres de chemin

project_idstringRequis

L’ID du projet à utiliser. Vous pouvez utiliser le point de terminaison Lister les projets pour répertorier tous les projets disponibles.

Paramètres de requête

share_idstring or nullOptionnel

L'ID de partage du projet

Réponse

Réponse réussie

project_idstring

L’ID du projet.

namestring

Le nom du projet.

create_date_unixinteger

Date de création du projet.

created_by_user_idstring or null

L’ID utilisateur de la personne ayant créé le projet.

default_title_voice_ref_idstring

L’ID de référence vocale de projet par défaut pour les titres.

default_paragraph_voice_ref_idstring

L’ID de référence vocale de projet par défaut pour les paragraphes.

default_model_idstring

L’ID du modèle par défaut.

can_be_downloadedboolean

Indique si le projet peut être téléchargé.

volume_normalizationboolean

Indique si le projet utilise la normalisation du volume.

stateenum

L’état du projet.

Valeurs autorisées:

access_levelenum

Niveau d’accès du projet.

Valeurs autorisées:

quality_presetenum

Le niveau de préréglage de qualité du projet.

Valeurs autorisées:

chapterslist of objects

Liste des chapitres du projet et de leurs métadonnées.

pronunciation_dictionary_versionslist of objects

Liste des versions de dictionnaires de prononciation du projet et de leurs métadonnées.

pronunciation_dictionary_locatorslist of objects

Liste des localisateurs de dictionnaires de prononciation.

apply_text_normalizationenum

Indique si la normalisation du texte est appliquée au projet.

Valeurs autorisées:

assetslist of objects

Liste des ressources importées, par exemple des vidéos ou des fichiers audio.

voiceslist of objects

Liste des voix configurées pour le projet.

quality_check_onbooleanDeprecated

Indique si le contrôle qualité est activé pour ce projet.

quality_check_on_when_bulk_convertbooleanDeprecated

Indique si le contrôle qualité est activé pour le projet lors d’une conversion groupée.

default_title_voice_idstringLecture seuleDeprecated

L’ID de voix par défaut pour les titres.

default_paragraph_voice_idstringLecture seuleDeprecated

L’ID de voix par défaut pour les paragraphes.

last_conversion_date_unixinteger or nullOptionnel

La dernière date de conversion du projet.

titlestring or nullOptionnel

Le titre du projet.

authorstring or nullOptionnel

Auteur du projet.

descriptionstring or nullOptionnel

La description du projet.

genreslist of strings or nullOptionnel

Liste des genres du projet.

cover_image_urlstring or nullOptionnel

URL de l’image de couverture du projet.

target_audienceenum or nullOptionnel

Le public cible du projet.

Valeurs autorisées:

languagestring or nullOptionnel

Code de langue à deux lettres (ISO 639-1) de la langue du projet.

content_typestring or nullOptionnel

Type de contenu du projet, par exemple « Novel » ou « Short Story »

original_publication_datestring or nullOptionnel

La date de publication d’origine du projet.

mature_contentboolean or nullOptionnel

Indique si le projet contient du contenu pour adultes.

isbn_numberstring or nullOptionnel

Le numéro ISBN du projet.

fictionenum or nullOptionnel

Indique si le projet est une œuvre de fiction.

Valeurs autorisées:

creation_metaobject or nullOptionnel

Métadonnées de création du projet.

source_typeenum or nullOptionnel

Le type de source du projet.

chapters_enabledboolean or nullOptionnelPar défaut true

Indique si les chapitres sont activés pour le projet.

captions_enabledboolean or nullOptionnelPar défaut true

Indique si les légendes sont activées pour le projet.

caption_styleobject or nullOptionnel

Style global à appliquer à tous les sous-titres.

caption_style_template_overridesmap from strings to objects or nullOptionnel

Modifications de style apportées aux modèles fournis

public_share_idstring or nullOptionnel

L’ID de partage public du projet.

aspect_ratioenum or nullOptionnel

Format du projet.

Valeurs autorisées:

agent_settingsobject or nullOptionnel

Paramètres liés à l’agent pour le projet

experimentalmap from strings to anyOptionnel

Fonctionnalités expérimentales du projet.

base_voiceslist of objects or nullOptionnel

Liste des voix utilisées par le projet.

publishing_readobject or nullOptionnel

Les données ElevenReader si le livre a été publié.

Erreurs

422

Unprocessable Entity Error

Paramètres de chemin

En-têtes

Paramètres de requête

Réponse

Erreurs