Elevenlabs
  1. 项目
Elevenlabs
  • 文字转语音
    • 减少延迟
    • 文字转语音
      POST
    • Streaming
      POST
  • 历史
    • 获取生成的物品
      GET
    • 通过 id 获取历史记录
      GET
    • 删除历史记录项
      DELETE
    • 从历史项目中获取音频
      GET
    • 下载历史项目
      POST
  • 样品
    • 删除样本
      DELETE
    • 从样本中获取音频
      GET
  • 用户
    • 获取用户订阅信息
      GET
    • 获取用户信息
      GET
  • 声音
    • 获取声音
    • 获取默认语音设置
    • 获取语​​音设置
    • 获取语​​音
    • 删除语音
    • 编辑语音设置
    • 添加语音
    • 编辑声音
  • 语音库
    • 查询库
    • 添加共享语音
  • 项目
    • 获取项目
      GET
    • 通过 id 获取项目
      GET
    • 添加项目
      POST
    • 删除项目
      DELETE
    • 转换项目
      POST
    • 获取项目快照
      GET
    • 流式传输项目音频
      POST
    • 获取章节
      GET
    • 通过 id 获取章节
      GET
    • 删除章节
      DELETE
    • 转换章节
      POST
    • 获取章节快照
      GET
    • 流式传输章节音频
      POST
    • 更新发音词典
      POST
  • 发音词典
    • 从文件添加
  • 模型
    • 获取模型
  • 音频原生
    • 创建启用音频的项目
  1. 项目

添加项目

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v1/projects/add
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v1/projects/add' \
--header 'xi-api-key;' \
--form 'acx_volume_normalization="true"' \
--form 'author="<string>"' \
--form 'default_model_id="<string>"' \
--form 'default_paragraph_voice_id="<string>"' \
--form 'default_title_voice_id="<string>"' \
--form 'from_document="<string>"' \
--form 'from_url="<string>"' \
--form 'isbn_number="<string>"' \
--form 'name="<string>"' \
--form 'pronunciation_dictionary_locators="[
  \"<string>\"
]"' \
--form 'quality_preset="<string>"' \
--form 'title="<string>"' \
--form 'volume_normalization="true"'
响应示例响应示例
200 - 成功示例
{
  "project": {
    "author": "<string>",
    "can_be_downloaded": true,
    "create_date_unix": 123,
    "default_model_id": "<string>",
    "default_paragraph_voice_id": "<string>",
    "default_title_voice_id": "<string>",
    "isbn_number": "<string>",
    "last_conversion_date_unix": 123,
    "name": "<string>",
    "project_id": "<string>",
    "state": "default",
    "title": "<string>",
    "volume_normalization": true
  }
}

请求参数

Header 参数
xi-api-key
string 
可选
您的 API 密钥。这是大多数端点以编程方式访问我们的 API 所必需的。您可以使用网站上的“个人资料”选项卡查看您的 xi-api-key。
Body 参数multipart/form-data
acx_volume_normalization
string 
可选
[已弃用] 下载项目时,返回的音频是否应该进行后处理,以使其符合有声读物标准化音量要求
示例值:
true
author
string 
可选
项目作者的可选名称,这将作为元数据添加到项目/章节下载的 mp3 文件中。
示例值:
<string>
default_model_id
string 
必需
本项目要使用的模型的model_id,可以查询GET https://api.elevenlabs.io/v1/models 来列出所有可用的模型。
示例值:
<string>
default_paragraph_voice_id
string 
必需
对应于新段落使用的默认语音的 voice_id。
示例值:
<string>
default_title_voice_id
string 
必需
与新标题使用的默认语音相对应的 voice_id。
示例值:
<string>
from_document
string 
可选
可以提供可选的 .epub、.pdf、.txt 或类似文件。如果提供,我们将使用其内容初始化项目。如果设置了此项,“from_url”必须为空。如果未提供“from_url”或“from_document”,我们会将项目初始化为空白。
示例值:
<string>
from_url
string 
可选
一个可选的 URL,我们将从中提取内容以初始化项目。如果设置了此项,“from_url”必须为空。如果未提供“from_url”或“from_document”,我们会将项目初始化为空白。
示例值:
<string>
isbn_number
string 
可选
您要创建的项目的可选 ISBN 编号,这将作为元数据添加到项目/章节下载的 mp3 文件中。
示例值:
<string>
name
string 
必需
项目名称,仅用于标识。
示例值:
<string>
pronunciation_dictionary_locators
string 
必需
发音词典定位器(id、version_id)列表,编码为 JSON 字符串列表,以便发音词典应用于文本。需要 json 编码字符串列表,因为添加项目可能是通过 formData 而不是 jsonBody 进行的
示例值:
[ "<string>" ]
quality_preset
string 
可选
生成的音频的输出质量。必须是以下之一:标准 - 标准输出格式,128kbps,44.1kHz 采样率。高 - 高品质输出格式,192kbps 和 44.1kHz 采样率,以及我们方面的重大改进。使用此设置会使角色成本增加 20%。ultra - 超品质输出格式,192kbps,44.1kHz 采样率,是我们方面的最高改进。使用此设置会使角色成本增加 50%。
示例值:
<string>
title
string 
可选
项目作者的可选名称,这将作为元数据添加到项目/章节下载的 mp3 文件中。
示例值:
<string>
volume_normalization
string 
可选
下载项目时,返回的音频是否应该进行后处理,以使其符合有声读物标准化音量要求
示例值:
true

返回响应

🟢200成功
application/json
Body
project
object 
必需
author
string 
必需
can_be_downloaded
boolean 
必需
create_date_unix
integer 
必需
default_model_id
string 
必需
default_paragraph_voice_id
string 
必需
default_title_voice_id
string 
必需
isbn_number
string 
必需
last_conversion_date_unix
integer 
必需
name
string 
必需
project_id
string 
必需
state
string 
必需
title
string 
必需
volume_normalization
boolean 
必需
🟠422参数错误
上一页
通过 id 获取项目
下一页
删除项目
Built with