스튜디오 프로젝트 생성

POST

/v1/studio/projects

POST

/v1/studio/projects

curl -X POST https://api.elevenlabs.io/v1/studio/projects \
     -H "Content-Type: multipart/form-data" \
     -F from_document=@<file1> \
     -F name="Project 1"

{
  "project": {
    "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_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"
  }
}

새 Studio 프로젝트를 생성합니다. 빈 프로젝트, 문서 또는 URL에서 초기화할 수 있습니다.

요청

This endpoint expects a multipart form containing an optional file.

namestring필수

식별 용도로만 사용하는 Studio 프로젝트 이름입니다.

default_title_voice_idstring or null선택 사항

새 제목에 사용되는 기본 음성에 해당하는 voice_id입니다.

default_paragraph_voice_idstring or null선택 사항

새 문단에 사용되는 기본 음성에 해당하는 voice_id입니다.

default_model_idstring or null선택 사항

이 스튜디오 프로젝트에 사용할 모델의 ID입니다. GET /v1/models를 호출하여 사용 가능한 모든 모델을 나열할 수 있습니다.

from_urlstring or null선택 사항

Studio 프로젝트를 초기화하기 위해 콘텐츠를 추출할 선택적 URL입니다. 이 값이 설정되면 ‘from_url’과 ‘from_content’는 null이어야 합니다. ‘from_url’, ‘from_document’, ‘from_content’가 모두 제공되지 않으면 Studio 프로젝트를 빈 상태로 초기화합니다.

from_documentfile선택 사항

선택적으로 .epub, .pdf, .txt 또는 유사한 파일을 제공할 수 있습니다. 제공하면 해당 콘텐츠로 Studio 프로젝트를 초기화합니다. 이 값이 설정되면 ‘from_url’과 ‘from_content’는 null이어야 합니다. ‘from_url’, ‘from_document’, ‘from_content’가 모두 제공되지 않으면 Studio 프로젝트를 빈 상태로 초기화합니다.

선택적으로 .epub, .pdf, .txt 또는 유사한 파일을 제공할 수 있습니다. 제공하면 해당 콘텐츠로 Studio 프로젝트를 초기화합니다. 이 값이 설정되면 'from_url'과 'from_content'는 null이어야 합니다. 'from_url', 'from_document', 'from_content'가 모두 제공되지 않으면 Studio 프로젝트를 빈 상태로 초기화합니다.

from_content_jsonstring선택 사항

Studio 프로젝트를 초기화하는 데 사용할 선택적 콘텐츠입니다. 이 값이 설정되면 ‘from_url’과 ‘from_document’는 null이어야 합니다. ‘from_url’, ‘from_document’, ‘from_content’가 모두 제공되지 않으면 Studio 프로젝트를 빈 상태로 초기화합니다.

예시: [{“name”: “Chapter A”, “blocks”: [{“sub_type”: “p”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “A”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “B”, “type”: “tts_node”}]}, {“sub_type”: “h1”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “C”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “D”, “type”: “tts_node”}]}]}, {“name”: “Chapter B”, “blocks”: [{“sub_type”: “p”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “E”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “F”, “type”: “tts_node”}]}, {“sub_type”: “h2”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “G”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “H”, “type”: “tts_node”}]}]}]

Studio 프로젝트를 초기화하는 데 사용할 선택적 콘텐츠입니다. 이 값이 설정되면 'from_url'과 'from_document'는 null이어야 합니다. 'from_url', 'from_document', 'from_content'가 모두 제공되지 않으면 Studio 프로젝트를 빈 상태로 초기화합니다. 예시: [{"name": "Chapter A", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "A", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "B", "type": "tts_node"}]}, {"sub_type": "h1", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "C", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "D", "type": "tts_node"}]}]}, {"name": "Chapter B", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "E", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "F", "type": "tts_node"}]}, {"sub_type": "h2", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "G", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "H", "type": "tts_node"}]}]}]

quality_presetenum or null선택 사항

생성된 오디오의 출력 품질입니다. 다음 중 하나여야 합니다. ‘standard’ - 표준 출력 형식, 샘플링 레이트 44.1kHz에서 128kbps. ‘high’ - 고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 주요 개선 사항 적용. ‘ultra’ - 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. ‘ultra_lossless’ - 완전 무손실 형식의 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 705.6kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. 제공하지 않으면 가입한 요금제에서 사용할 수 있는 최고 품질 프리셋이 기본값으로 적용됩니다.

생성된 오디오의 출력 품질입니다. 다음 중 하나여야 합니다. 'standard' - 표준 출력 형식, 샘플링 레이트 44.1kHz에서 128kbps. 'high' - 고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 주요 개선 사항 적용. 'ultra' - 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. 'ultra_lossless' - 완전 무손실 형식의 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 705.6kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. 제공하지 않으면 가입한 요금제에서 사용할 수 있는 최고 품질 프리셋이 기본값으로 적용됩니다.

허용된 값:

titlestring or null선택 사항

Studio 프로젝트 저자의 선택적 이름입니다. Studio 프로젝트 또는 챕터를 다운로드할 때 MP3 파일에 메타데이터로 추가됩니다.

authorstring or null선택 사항

Studio 프로젝트 저자의 선택적 이름입니다. Studio 프로젝트 또는 챕터를 다운로드할 때 MP3 파일에 메타데이터로 추가됩니다.

descriptionstring or null선택 사항

Studio 프로젝트의 선택적 설명입니다.

genreslist of strings선택 사항

Studio 프로젝트와 연결된 선택적 장르 목록입니다.

target_audienceenum or null선택 사항

Studio 프로젝트의 선택적 대상 독자입니다.

허용된 값:

languagestring or null선택 사항=2 characters

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

content_typestring or null선택 사항

Studio 프로젝트의 선택적 콘텐츠 유형입니다.

original_publication_datestring or null선택 사항형식: "^\d{4}-\d{2}-\d{2}$|^\d{4}$"

YYYY-MM-DD 또는 YYYY 형식의 Studio 프로젝트 선택적 최초 출판일입니다.

mature_contentboolean or null선택 사항기본값 false

이 Studio 프로젝트에 성인 콘텐츠가 포함되어 있는지 여부에 대한 선택적 지정입니다.

isbn_numberstring or null선택 사항

생성할 Studio 프로젝트의 선택적 ISBN 번호입니다. Studio 프로젝트 또는 챕터를 다운로드할 때 MP3 파일에 메타데이터로 추가됩니다.

acx_volume_normalizationboolean선택 사항기본값 false

[지원 중단됨] Studio 프로젝트를 다운로드할 때 반환되는 오디오에 오디오북 정규화 볼륨 요구사항을 충족하도록 후처리를 적용할지 여부입니다.

volume_normalizationboolean선택 사항기본값 false

Studio 프로젝트를 다운로드할 때 반환되는 오디오에 오디오북 정규화 볼륨 요구 사항을 충족하도록 후처리를 적용할지 여부입니다.

pronunciation_dictionary_locatorslist of strings선택 사항

텍스트에 적용할 발음 사전의 발음 사전 로케이터(pronunciation_dictionary_id, version_id)를 JSON 문자열 목록으로 인코딩한 값입니다. 프로젝트 추가는 jsonBody가 아닌 formData를 통해 이루어질 수 있으므로 JSON으로 인코딩된 문자열 목록이 필요합니다. 여러 사전을 지정하려면 curl에서 여러 —form 줄을 사용하세요. 예: —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.

텍스트에 적용할 발음 사전의 발음 사전 로케이터(pronunciation_dictionary_id, version_id)를 JSON 문자열 목록으로 인코딩한 값입니다. 프로젝트 추가는 jsonBody가 아닌 formData를 통해 이루어질 수 있으므로 JSON으로 인코딩된 문자열 목록이 필요합니다. 여러 사전을 지정하려면 curl에서 여러 --form 줄을 사용하세요. 예: --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.

callback_urlstring or null선택 사항

Studio 프로젝트가 변환될 때 서비스에서 호출할 URL입니다. 요청에는 변환 상태가 포함된 JSON 블롭이 포함됩니다. 메시지:

프로젝트가 성공적으로 변환된 경우: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }
프로젝트 변환에 실패한 경우: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Error details if conversion failed” } }
챕터가 성공적으로 변환된 경우: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “success”, chapter_snapshot_id: “23m00Tcm4TlvDq8ikMAV”, error_details: None, } }
챕터 변환에 실패한 경우: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “error”, chapter_snapshot_id: None, error_details: “Error details if conversion failed” } }

Studio 프로젝트가 변환될 때 서비스에서 호출할 URL입니다. 요청에는 변환 상태가 포함된 JSON 블롭이 포함됩니다. 메시지: 1. 프로젝트가 성공적으로 변환된 경우: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "success", project_snapshot_id: "22m00Tcm4TlvDq8ikMAT", error_details: None, } } 2. 프로젝트 변환에 실패한 경우: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "error", project_snapshot_id: None, error_details: "Error details if conversion failed" } } 3. 챕터가 성공적으로 변환된 경우: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "success", chapter_snapshot_id: "23m00Tcm4TlvDq8ikMAV", error_details: None, } } 4. 챕터 변환에 실패한 경우: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "error", chapter_snapshot_id: None, error_details: "Error details if conversion failed" } }

fictionenum or null선택 사항

이 Studio 프로젝트의 콘텐츠가 소설인지 여부에 대한 선택적 지정입니다.

허용된 값:

apply_text_normalizationenum or null선택 사항

이 매개변수는 ‘auto’, ‘on’, ‘apply_english’, ‘off’의 네 가지 모드로 텍스트 정규화를 제어합니다. ‘auto’로 설정하면 시스템이 텍스트 정규화 적용 여부를 자동으로 결정합니다. (예: 숫자를 글자로 표기) ‘on’에서는 텍스트 정규화가 항상 적용되고, ‘off’에서는 건너뜁니다. ‘apply_english’는 ‘on’과 같지만 텍스트가 영어라고 가정합니다.

이 매개변수는 'auto', 'on', 'apply_english', 'off'의 네 가지 모드로 텍스트 정규화를 제어합니다. 'auto'로 설정하면 시스템이 텍스트 정규화 적용 여부를 자동으로 결정합니다. (예: 숫자를 글자로 표기) 'on'에서는 텍스트 정규화가 항상 적용되고, 'off'에서는 건너뜁니다. 'apply_english'는 'on'과 같지만 텍스트가 영어라고 가정합니다.

허용된 값:

auto_convertboolean선택 사항기본값 false

Studio 프로젝트를 오디오로 자동 변환할지 여부입니다.

auto_assign_voicesboolean or null선택 사항기본값 false

[알파 기능] 프로젝트 생성 시 문구에 음성을 자동으로 할당할지 여부입니다.

source_typeenum or null선택 사항

생성할 Studio 프로젝트 유형입니다.

voice_settingslist of strings선택 사항

JSON 문자열 목록으로 인코딩된 프로젝트의 선택적 음성 설정 재정의입니다.

예시: [”{“voice_id”: “21m00Tcm4TlvDq8ikWAM”, “stability”: 0.7, “similarity_boost”: 0.8, “style”: 0.5, “speed”: 1.0, “use_speaker_boost”: true}”]

create_publishing_readboolean or null선택 사항기본값 false

true이면 초안 상태에서 직접 게시할 수 있도록 해당 리드를 생성합니다.

응답

성공 응답

projectobject

오류

422

Unprocessable Entity Error

헤더

요청

응답

오류