创建 Studio 项目

Studio 项目名称，仅用于识别。

新标题默认音色对应的 voice_id。

新段落默认音色对应的 voice_id。

此 Studio 项目使用的模型 ID。可通过 GET /v1/models 查询所有可用模型。

可选 URL，将从中提取内容以初始化 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 项目将初始化为空白项目。

用于初始化 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”}]}]}]

生成音频的输出质量。必须为以下之一： ‘standard’ - 标准输出格式，采样率为 44.1kHz、比特率为 128kbps。 ‘high’ - 高质量输出格式，采样率为 44.1kHz、比特率为 192kbps，并采用我们显著改进的处理。 ‘ultra’ - 超高质量输出格式，采样率为 44.1kHz、比特率为 192kbps，并采用我们最高级别的处理。 ‘ultra_lossless’ - 超高质量输出格式，采样率为 44.1kHz、比特率为 705.6kbps，以完全无损格式采用我们最高级别的处理。 未提供时，默认使用当前订阅版本可用的最高质量预设。

Studio 项目作者的可选名称。下载 Studio 项目或章节时，该名称会作为元数据添加到 mp3 文件中。

Studio 项目作者的可选名称。下载 Studio 项目或章节时，该名称会作为元数据添加到 mp3 文件中。

可选的 Studio 项目描述。

与 Studio 项目关联的可选流派列表。

Studio 项目的可选目标受众。

可选的 Studio 项目语言。双字母语言代码（ISO 639-1）。

可选的 Studio 项目内容类型。

Studio 项目的可选原始出版日期，格式为 YYYY-MM-DD 或 YYYY。

可选指定此 Studio 项目是否包含成人内容。

要创建的 Studio 项目的可选 ISBN 编号。下载 Studio 项目或章节时，该编号会作为元数据添加到 mp3 文件中。

[Deprecated] 下载 Studio 项目时，是否应对返回的音频进行后处理，以符合有声书响度标准化要求。

下载 Studio 项目时，是否应对返回的音频进行后处理，以符合有声书标准化音量要求

以 JSON 字符串列表编码的发音词典定位符（pronunciation_dictionary_id、version_id）列表，用于指定要应用于文本的发音词典。由于添加项目时可能通过 formData 而非 jsonBody，因此必须提供 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”}”’。

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” } }

可选指定此 Studio 项目内容是否为虚构作品。

此参数通过 4 种模式控制文本规范化：‘auto’、‘on’、‘apply_english’ 和 ‘off’。 设为 ‘auto’ 时，系统会自动决定是否应用文本规范化 （例如将数字拼写出来）。设为 ‘on’ 时，始终应用文本规范化；设为 ‘off’ 时则跳过。‘apply_english’ 与 ‘on’ 相同，但会假定文本为英语。

是否自动将 Studio 项目转换为音频。

[Alpha Feature] 是否在创建项目时自动为短语分配音色。

要创建的 Studio 项目类型。

项目的可选音色设置覆盖项，以 JSON 字符串列表编码。

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

如果为 true，将创建对应的阅读内容，以草稿状态直接发布。