Studio-Projekt abrufen

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

Gibt Informationen zu einem bestimmten Studio-Projekt zurück. Dieser Endpunkt liefert detailliertere Informationen zu einem Projekt als GET /v1/studio.

Pfadparameter

project_idstringErforderlich

Die ID des zu verwendenden Projekts. Über den Endpunkt List projects können Sie alle verfügbaren Projekte auflisten.

Abfrageparameter

share_idstring or nullOptional

Die Freigabe-ID des Projekts

Antwort

Erfolgreiche Antwort

project_idstring

Die ID des Projekts.

namestring

Der Name des Projekts.

create_date_unixinteger

Das Erstellungsdatum des Projekts.

created_by_user_idstring or null

Die Nutzer-ID der Person, die das Projekt erstellt hat.

default_title_voice_ref_idstring

Die Standard-Referenz-ID der Projektstimme für Titel.

default_paragraph_voice_ref_idstring

Die Standard-Referenz-ID der Projektstimme für Absätze.

default_model_idstring

Die Standard-Modell-ID.

can_be_downloadedboolean

Gibt an, ob das Projekt heruntergeladen werden kann.

volume_normalizationboolean

Gibt an, ob das Projekt Lautstärkenormalisierung verwendet.

stateenum

Der Status des Projekts.

Erlaubte Werte:

access_levelenum

Die Zugriffsebene des Projekts.

Erlaubte Werte:

quality_presetenum

Die Qualitätsvoreinstellung des Projekts.

Erlaubte Werte:

chapterslist of objects

Liste der Kapitel des Projekts und ihrer Metadaten.

pronunciation_dictionary_versionslist of objects

Liste der Versionen der Aussprachewörterbücher des Projekts und ihrer Metadaten.

pronunciation_dictionary_locatorslist of objects

Liste der Locator für Aussprachewörterbücher.

apply_text_normalizationenum

Gibt an, ob Textnormalisierung auf das Projekt angewendet wird.

Erlaubte Werte:

assetslist of objects

Liste der hochgeladenen Assets, z. B. Videos und Audiodateien.

voiceslist of objects

Liste der konfigurierten Projektstimmen.

quality_check_onbooleanDeprecated

Gibt an, ob die Qualitätsprüfung für dieses Projekt aktiviert ist.

quality_check_on_when_bulk_convertbooleanDeprecated

Gibt an, ob die Qualitätsprüfung beim Projekt während der Massenkonvertierung aktiviert ist.

default_title_voice_idstringSchreibgeschütztDeprecated

Die Standard-Stimm-ID für Titel.

default_paragraph_voice_idstringSchreibgeschütztDeprecated

Die Standard-Stimm-ID für Absätze.

last_conversion_date_unixinteger or nullOptional

Das Datum der letzten Konvertierung des Projekts.

titlestring or nullOptional

Der Titel des Projekts.

authorstring or nullOptional

Der Autor des Projekts.

descriptionstring or nullOptional

Die Beschreibung des Projekts.

genreslist of strings or nullOptional

Liste der Genres des Projekts.

cover_image_urlstring or nullOptional

Die URL des Titelbilds des Projekts.

target_audienceenum or nullOptional

Die Zielgruppe des Projekts.

Erlaubte Werte:

languagestring or nullOptional

Zweibuchstabiger Sprachcode (ISO 639-1) der Projektsprache.

content_typestring or nullOptional

Der Inhaltstyp des Projekts, z. B. „Roman“ oder „Kurzgeschichte“

original_publication_datestring or nullOptional

Das ursprüngliche Veröffentlichungsdatum des Projekts.

mature_contentboolean or nullOptional

Gibt an, ob das Projekt Inhalte für Erwachsene enthält.

isbn_numberstring or nullOptional

Die ISBN-Nummer des Projekts.

fictionenum or nullOptional

Gibt an, ob das Projekt fiktional ist.

Erlaubte Werte:

creation_metaobject or nullOptional

Die Erstellungsmetadaten des Projekts.

source_typeenum or nullOptional

Der Quelltyp des Projekts.

chapters_enabledboolean or nullOptionalStandardwert ist true

Gibt an, ob Kapitel für das Projekt aktiviert sind.

captions_enabledboolean or nullOptionalStandardwert ist true

Gibt an, ob Untertitel für das Projekt aktiviert sind.

caption_styleobject or nullOptional

Globales Styling für alle Untertitel

caption_style_template_overridesmap from strings to objects or nullOptional

Stiländerungen an den bereitgestellten Vorlagen

public_share_idstring or nullOptional

Die öffentliche Freigabe-ID des Projekts.

aspect_ratioenum or nullOptional

Das Seitenverhältnis des Projekts.

Erlaubte Werte:

agent_settingsobject or nullOptional

Agent-bezogene Einstellungen für das Projekt

experimentalmap from strings to anyOptional

Experimentelle Funktionen für das Projekt.

base_voiceslist of objects or nullOptional

Liste der vom Projekt verwendeten Stimmen.

publishing_readobject or nullOptional

Die ElevenReader-Daten, falls das Buch veröffentlicht wurde.

Fehler

422

Unprocessable Entity Error

Pfadparameter

Header

Abfrageparameter

Antwort

Fehler