更新 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"
  }
}

通过设置传入参数的值来更新指定 Studio 项目。

路径参数

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

路径参数

请求头

请求

响应

错误