스튜디오 프로젝트 가져오기

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

특정 Studio 프로젝트의 정보를 반환합니다. 이 엔드포인트는 GET /v1/studio보다 프로젝트에 대한 자세한 정보를 반환합니다.

경로 매개변수

project_idstring필수

사용할 프로젝트의 ID입니다. 사용 가능한 모든 프로젝트는 프로젝트 나열 엔드포인트에서 확인할 수 있습니다.

쿼리 매개변수

share_idstring or null선택 사항

프로젝트의 공유 ID

응답

성공 응답

project_idstring

프로젝트의 ID입니다.

namestring

프로젝트 이름입니다.

create_date_unixinteger

프로젝트 생성 날짜입니다.

created_by_user_idstring or null

프로젝트를 생성한 사용자의 ID입니다.

default_title_voice_ref_idstring

기본 제목 프로젝트 음성 참조 ID입니다.

default_paragraph_voice_ref_idstring

기본 문단 프로젝트 음성 참조 ID입니다.

default_model_idstring

기본 모델 ID입니다.

can_be_downloadedboolean

프로젝트를 다운로드할 수 있는지 여부입니다.

volume_normalizationboolean

프로젝트가 볼륨 정규화를 사용하는지 여부입니다.

stateenum

프로젝트의 상태입니다.

허용된 값:

access_levelenum

프로젝트의 액세스 수준입니다.

허용된 값:

quality_presetenum

프로젝트의 품질 프리셋 수준입니다.

허용된 값:

chapterslist of objects

프로젝트 챕터 및 해당 메타데이터 목록입니다.

pronunciation_dictionary_versionslist of objects

프로젝트의 발음 사전 버전 및 해당 메타데이터 목록입니다.

pronunciation_dictionary_locatorslist of objects

발음 사전 로케이터 목록입니다.

apply_text_normalizationenum

프로젝트에 텍스트 정규화가 적용되는지 여부입니다.

허용된 값:

assetslist of objects

업로드된 에셋(예: 비디오, 오디오) 목록입니다.

voiceslist of objects

구성된 프로젝트 음성 목록입니다.

quality_check_onbooleanDeprecated

이 프로젝트에 품질 검사가 활성화되어 있는지 여부입니다.

quality_check_on_when_bulk_convertbooleanDeprecated

일괄 변환 시 프로젝트에 품질 검사가 활성화되어 있는지 여부입니다.

default_title_voice_idstring읽기 전용Deprecated

기본 제목 음성 ID입니다.

default_paragraph_voice_idstring읽기 전용Deprecated

기본 문단 음성 ID입니다.

last_conversion_date_unixinteger or null선택 사항

프로젝트의 마지막 변환 날짜입니다.

titlestring or null선택 사항

프로젝트 제목입니다.

authorstring or null선택 사항

프로젝트의 작성자입니다.

descriptionstring or null선택 사항

프로젝트 설명입니다.

genreslist of strings or null선택 사항

프로젝트 장르 목록입니다.

cover_image_urlstring or null선택 사항

프로젝트의 표지 이미지 URL입니다.

target_audienceenum or null선택 사항

프로젝트의 대상 고객입니다.

허용된 값:

languagestring or null선택 사항

프로젝트 언어의 두 글자 언어 코드(ISO 639-1)입니다.

content_typestring or null선택 사항

프로젝트의 콘텐츠 유형입니다. 예: ‘Novel’ 또는 ‘Short Story’

original_publication_datestring or null선택 사항

프로젝트의 최초 게시 날짜입니다.

mature_contentboolean or null선택 사항

프로젝트에 성인 콘텐츠가 포함되어 있는지 여부입니다.

isbn_numberstring or null선택 사항

프로젝트의 ISBN 번호입니다.

fictionenum or null선택 사항

프로젝트가 소설인지 여부입니다.

허용된 값:

creation_metaobject or null선택 사항

프로젝트의 생성 메타데이터입니다.

source_typeenum or null선택 사항

프로젝트의 원본 유형입니다.

chapters_enabledboolean or null선택 사항기본값 true

프로젝트에서 챕터가 활성화되어 있는지 여부입니다.

captions_enabledboolean or null선택 사항기본값 true

프로젝트에서 캡션이 활성화되어 있는지 여부입니다.

caption_styleobject or null선택 사항

모든 캡션에 적용할 전역 스타일

caption_style_template_overridesmap from strings to objects or null선택 사항

제공된 템플릿에 적용된 스타일 변경 사항

public_share_idstring or null선택 사항

프로젝트의 공개 공유 ID입니다.

aspect_ratioenum or null선택 사항

프로젝트의 가로세로 비율입니다.

허용된 값:

agent_settingsobject or null선택 사항

프로젝트의 에이전트 관련 설정

experimentalmap from strings to any선택 사항

프로젝트의 실험적 기능입니다.

base_voiceslist of objects or null선택 사항

프로젝트에서 사용한 음성 목록입니다.

publishing_readobject or null선택 사항

책이 게시된 경우의 ElevenReader 데이터입니다.

오류

422

Unprocessable Entity Error

경로 매개변수

헤더

쿼리 매개변수

응답

오류