创建播客

创建并自动转换播客项目。目前,LLM 费用由我们承担,但仍会收取音频生成费用。未来将同时收取 LLM 和音频生成费用。

请求头

xi-api-keystring可选
safety-identifierstring or null可选

用于审核。工作区必须已加入许可名单才能使用此功能。

请求

This endpoint expects an object.
model_idstring必需

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

modeobject必需

要生成的播客类型。可以是“conversation”(两个音色之间的互动),或“bulletin”(独白)。

sourceobject or list of objects必需

播客的源内容。

quality_presetenum or null可选

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

允许的值:
duration_scaleenum可选默认为 default

生成播客的时长。必须为以下之一: short - 生成短于 3 分钟的播客。 default - 生成时长约为 3 至 7 分钟的播客。 long - 生成长于 7 分钟的播客。

允许的值:
languagestring or null可选=2 characters

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

introstring or null可选<=1500 characters

始终添加到播客开头的介绍文本。

outrostring or null可选<=1500 characters

将始终添加到播客结尾的片尾文本。

instructions_promptstring or null可选<=3000 characters

用于调整播客风格和语气的额外生成提示词。

highlightslist of strings or null可选

Studio 项目内容的简要摘要或亮点,提供关键要点或主题。长度应为 10 到 70 个字符。

callback_urlstring or null可选

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

apply_text_normalizationenum or null可选

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

允许的值:

响应

成功响应

projectobject

与创建的播客关联的项目。

错误

422
Unprocessable Entity Error