Hämta Studio-projekt

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

Returnerar information om ett specifikt Studio-projekt. Denna slutpunkt returnerar mer detaljerad information om ett projekt än GET /v1/studio.

Sökvägsparametrar

project_idstringObligatorisk

ID:t för projektet som ska användas. Du kan använda slutpunkten List projects för att lista alla tillgängliga projekt.

Frågeparametrar

share_idstring or nullValfri

Projektets delnings-ID

Svar

Lyckat svar

project_idstring

ID:t för projektet.

namestring

Projektets namn.

create_date_unixinteger

Projektets skapandedatum.

created_by_user_idstring or null

Användar-ID:t för personen som skapade projektet.

default_title_voice_ref_idstring

Standardreferens-ID:t för projektrösten i titlar.

default_paragraph_voice_ref_idstring

Standardreferens-ID:t för projektrösten i stycken.

default_model_idstring

Standardmodellens ID.

can_be_downloadedboolean

Om projektet kan laddas ned.

volume_normalizationboolean

Om projektet använder volymnormalisering.

stateenum

Projektets tillstånd.

Tillåtna värden:

access_levelenum

Projektets åtkomstnivå.

Tillåtna värden:

quality_presetenum

Projektets nivå för kvalitetsförinställning.

Tillåtna värden:

chapterslist of objects

Lista över projektets kapitel och deras metadata.

pronunciation_dictionary_versionslist of objects

Lista över projektets versioner av uttalslexikon och deras metadata.

pronunciation_dictionary_locatorslist of objects

Lista över lokaliserare för uttalslexikon.

apply_text_normalizationenum

Om textnormalisering tillämpas på projektet.

Tillåtna värden:

assetslist of objects

Lista över uppladdade tillgångar, till exempel videor och ljudfiler.

voiceslist of objects

Lista över konfigurerade projektröster.

quality_check_onbooleanDeprecated

Om kvalitetskontroll är aktiverad för det här projektet.

quality_check_on_when_bulk_convertbooleanDeprecated

Om kvalitetskontroll är aktiverad för projektet vid masskonvertering.

default_title_voice_idstringSkrivskyddadDeprecated

Standardröst-ID:t för titlar.

default_paragraph_voice_idstringSkrivskyddadDeprecated

Standardröst-ID:t för stycken.

last_conversion_date_unixinteger or nullValfri

Datumet för den senaste konverteringen av projektet.

titlestring or nullValfri

Projektets titel.

authorstring or nullValfri

Projektets författare.

descriptionstring or nullValfri

Beskrivningen av projektet.

genreslist of strings or nullValfri

Lista över projektets genrer.

cover_image_urlstring or nullValfri

URL:en till projektets omslagsbild.

target_audienceenum or nullValfri

Projektets målgrupp.

Tillåtna värden:

languagestring or nullValfri

Tvåställig språkkod (ISO 639-1) för projektets språk.

content_typestring or nullValfri

Projektets innehållstyp, till exempel 'Novel' eller 'Short Story'

original_publication_datestring or nullValfri

Projektets ursprungliga publiceringsdatum.

mature_contentboolean or nullValfri

Om projektet innehåller vuxeninnehåll.

isbn_numberstring or nullValfri

Projektets ISBN-nummer.

fictionenum or nullValfri

Om projektet är fiktion.

Tillåtna värden:

creation_metaobject or nullValfri

Projektets metadata för skapande.

source_typeenum or nullValfri

Projektets källtyp.

chapters_enabledboolean or nullValfriStandard är true

Om kapitel är aktiverade för projektet.

captions_enabledboolean or nullValfriStandard är true

Om bildtexter är aktiverade för projektet.

caption_styleobject or nullValfri

Global formatering som ska tillämpas på alla undertexter

caption_style_template_overridesmap from strings to objects or nullValfri

Stiländringar som har gjorts i de angivna mallarna

public_share_idstring or nullValfri

Projektets offentliga delnings-ID.

aspect_ratioenum or nullValfri

Projektets bildförhållande.

Tillåtna värden:

agent_settingsobject or nullValfri

Agentrelaterade inställningar för projektet

experimentalmap from strings to anyValfri

Experimentella funktioner för projektet.

base_voiceslist of objects or nullValfri

Lista över röster som används av projektet.

publishing_readobject or nullValfri

ElevenReader-data om boken publicerades.

Fel

422

Unprocessable Entity Error

Sökvägsparametrar

Headers

Frågeparametrar

Svar

Fel