Studio 프로젝트 업데이트

POST

/v1/studio/projects/:project_id

POST

/v1/studio/projects/:project_id

curl -X POST https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Project 1",
  "default_title_voice_id": "21m00Tcm4TlvDq8ikWAM",
  "default_paragraph_voice_id": "21m00Tcm4TlvDq8ikWAM"
}'

{
  "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"
  }
}

전달된 매개변수의 값을 설정하여 지정된 스튜디오 프로젝트를 업데이트합니다.

경로 매개변수

project_idstring필수

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

요청

This endpoint expects an object.

namestring필수

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

default_title_voice_idstring필수

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

default_paragraph_voice_idstring필수

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

titlestring or null선택 사항

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

authorstring or null선택 사항

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

isbn_numberstring or null선택 사항

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

volume_normalizationboolean선택 사항기본값 false

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

응답

성공 응답

projectobject

오류

422

Unprocessable Entity Error

경로 매개변수

헤더

요청

응답

오류