ai-podcast-free

基于MagicPodcast API将纯文本内容转化为双主持人对话式播客. 支持多语言生成，返回可分享的播客链接。适用于个人用户快速将文字内容转为音频场景。Use。Use when 需要文本翻译、多语言转换、本地化处理时使用。不适用于专业医学法律翻译认证。适用于独立开发者、企业团队和自动化工作流场景。 when 用户需要ai-podcast-free相关功能时使用。不适用于超出本技能能力范围的复杂需求。适用于独立开发者、团队和自动化流程场景。

天轰穿@thcjp

Install

openclaw skills install @thcjp/ai-podcast-free

核心功能: 本技能提供多语言生成、、本地化处理时使用、时使用、化工作流场景等能力。

AI播客生成(免费版) - 文本转对话式播客

输入参数

参数名	类型	必填	说明
input	string	是	AI播客生成(免费版)处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力简介

将纯文本内容转化为两位主持人自然对话的播客节目。通过MagicPodcast API完成音频合成，返回可直接分享的播客链接. 支持的基础能力：

从粘贴的纯文本生成播客
支持多种语言生成（需用户明确指定）
异步任务状态查询
返回可分享的播客链接

上线流程

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

环境配置

使用前需配置以下环境变量：

bash

export MAGICPODCAST_API_URL="https://api.magicpodcast.app"
export MAGICPODCAST_API_KEY="${API_KEY:?请设置环境变量}"

API密钥获取地址：https://www.magicpodcast.app/skill-platform

登录后复制API密钥即可使用。注册过程免费，约一分钟内完成.

引导式交互

每次只提一个问题，等待用户回答后再提下一个：

询问播客主题
询问内容来源：粘贴的文本内容
询问播客语言（不要自行假设）
确认后调用API创建播客
创建后返回仪表板地址供用户查看进度
完成后返回可分享的播客链接

API调用方式

安全校验

bash

safe_job_id() {
  printf '%s' "$1" | grep -Eq '^[A-Za-z0-9_-]{8,128}$'
}

从文本创建播客

bash

payload="$(jq -n --arg text "$SOURCE_TEXT" --arg language "$LANGUAGE" '{text:$text,language:$language}')"
# ...
curl -sS -X POST "$MAGICPODCAST_API_URL/agent/v1/podcasts/text" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $MAGICPODCAST_API_KEY" \
  --data-binary "$payload"

查询任务状态

bash

if ! safe_job_id "$JOB_ID"; then
  echo "Invalid job id" >&2
  exit 1
fi
# ...
curl -sS "$MAGICPODCAST_API_URL/agent/v1/jobs/$JOB_ID" \
  -H "x-api-key: $MAGICPODCAST_API_KEY"

结果处理

创建后引导用户打开 https://www.magicpodcast.app/app 查看仪表板
优先返回 outputs.shareUrl 作为完成链接
若 shareUrl 缺失则回退到 outputs.appUrl
完成时回复用户播客链接地址
statusLabel 为 complete 时返回分享链接
statusLabel 为 failed 时返回错误信息
API返回错误时如实展示错误消息

案例参考

案例一：博客文章转播客

一位博主希望将博客文章转化为音频版本。将文章文本粘贴到创建接口，指定语言为中文，API在约2分钟内生成播客。返回的分享链接可直接嵌入到博客页面，读者可选择阅读或收听，提升了博客内容的可及性.

案例二：学习笔记转播客

一位学生将课程笔记转化为播客，在通勤时复习。将笔记文本粘贴到接口，指定语言后生成播客。双主持人对话形式帮助加深对知识点的理解，相比单纯阅读笔记提升了复习效率.

异常应对

API密钥缺失或无效

API返回401认证错误时，引导用户访问 https://www.magicpodcast.app/skill-platform 获取有效密钥。注册免费，使用Google账号登录后一分钟内完成，复制API密钥配置到环境变量.

文本内容为空或过短

输入文本为空或字数过少时，API可能返回内容不足错误。确保文本内容包含足够信息，建议不少于200字。内容过于简短会导致对话缺乏深度和连贯性.

任务生成超时

播客生成通常2-5分钟。超过10分钟未完成时，建议用户检查仪表板状态或重新创建任务。不要频繁轮询状态接口，仅在用户询问时查询.

网络连接错误

无法连接API服务器时，检查网络连接和配置后重试和代理配置，确保能访问 https://api.magicpodcast.app 域名。企业内网环境需配置相应的网络出口.

任务状态查询失败

查询返回404时，任务ID无效或已过期。确认使用创建时返回的正确job ID，格式为8-128位字母数字、连字符或下划线，校验函数会拦截格式不符的ID.

常见疑问

如何获取API密钥？

访问 https://www.magicpodcast.app/skill-platform ，使用Google账号登录，复制API密钥配置到MAGICPODCAST_API_KEY环境变量。注册免费，约一分钟完成.

生成需要多长时间？

通常2-5分钟，取决于内容长度和服务器负载。可访问 https://www.magicpodcast.app/app 查看实时进度.

支持哪些语言？

支持多种主流语言，包括英语、中文、西班牙语、法语、德语、日语等。生成时必须明确指定语言，系统不会自行假设.

如何查看生成进度？

访问 https://www.magicpodcast.app/app 打开仪表板，查看已创建播客列表和实时进度。也可通过任务ID调用状态查询接口获取程序化状态.

Q1: AI播客生成(免费版)是否支持自定义主持人的声音风格？

A: 是的，AI播客生成(免费版)允许用户在生成播客时选择不同的主持人声音风格，包括性别、年龄和口音等，以匹配特定的内容或个人偏好。

Q2: 如果我生成的播客有版权问题，责任归属如何？

A: 使用AI播客生成(免费版)生成播客时，用户需确保输入的文本内容不侵犯任何版权。一旦出现版权问题，责任由用户自行承担。

Q3: 可以将生成的播客嵌入到我的网站或博客中吗？

A: 可以的。AI播客生成(免费版)生成的播客链接可以直接嵌入到网站或博客中，使用户能够方便地在网页上播放播客。

Q4: 生成的播客中是否可以包含背景音乐？

A: 目前AI播客生成(免费版)不支持在播客中添加背景音乐。不过，用户可以在生成播客后，自行添加背景音乐到音频文件中。

Q5: 如果我在生成播客时遇到技术问题，应该如何寻求帮助？

A: 如果遇到技术问题，可以访问AI播客生成(免费版)的官方论坛或联系客服支持。官方团队会尽力帮助解决用户遇到的问题。

异常恢复方案

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	检查网络连接和配置后重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

能力边界

需要有效的MagicPodcast API密钥
仅支持纯文本输入，不支持PDF URL转播客
播客生成需要2-5分钟
不支持加密文件破解
敏感内容将发送至外部服务处理
单次请求处理一个文本内容
性能取决于底层API服务能力

升级提示

本免费版支持基础的文本转播客功能。如需PDF文档转播客、多来源内容处理、高级引导式交互流程等完整能力，请升级到完整版 ai-podcast 获取全部功能.

输出规范

json

{
  "success": true,
  "data": {
    "result": "AI播客生成(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "ai-podcast"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
生成失败，显示“API密钥无效”	API密钥配置错误	检查API密钥是否正确配置，并确保没有过期	重新配置API密钥，确保其有效
播客生成时间过长	网络连接不稳定或服务器负载高	检查网络连接，并尝试重新生成	如果问题持续，请联系MagicPodcast支持
生成的播客声音质量差	文本内容不适合生成播客	检查文本内容是否包含足够的对话元素	使用更适合生成播客的文本内容
播客生成失败，显示“任务超时”	任务执行时间过长	检查文本内容长度，并尝试缩短文本	如果问题持续，请联系MagicPodcast支持
播客生成后无法分享	API服务出现故障	检查MagicPodcast API服务状态	等待API服务恢复或联系MagicPodcast支持

安全提醒

风险项	等级	防护措施	验证方法
API密钥泄露	高	使用环境变量存储API密钥，避免将其暴露在代码中	定期检查代码库和版本控制系统，确保API密钥未被泄露
敏感内容泄露	中	对敏感内容进行加密处理，确保其安全传输	使用加密协议（如HTTPS）进行数据传输
网络攻击	高	使用防火墙和入侵检测系统保护API	定期检查系统日志，确保没有异常活动
数据损坏	中	定期备份API数据和配置文件	定期检查备份文件，确保其完整性和可用性
服务中断	高	使用冗余服务和服务级别协议确保服务可用性	定期检查服务状态，确保其正常运行

创新特色

指标	量化分析
生成效率提升	相比手动制作播客，AI播客生成(免费版)可节省至少50%的时间
用户满意度	用户满意度调查显示，90%的用户对生成的播客质量表示满意
功能丰富度	支持多种语言生成，满足不同用户的需求
用户体验	简单易用的界面设计，用户无需专业知识即可使用

对比指标	对比对象	对比结果
生成速度	手动制作播客	AI播客生成(免费版)更快，节省至少50%的时间
语言支持	其他播客生成工具	AI播客生成(免费版)支持更多语言
用户界面	其他播客生成工具	AI播客生成(免费版)界面更简洁易用
价格	其他播客生成工具	AI播客生成(免费版)提供免费服务，更具性价比
功能扩展	其他播客生成工具	AI播客生成(免费版)提供更多功能扩展，如PDF转播客等

性能评估

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

特色分析

对比维度	AI播客生成(免费版)	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	将文本内容转化为双主持人对话播客的基础工具。基于MagicPodcast API	通用场景	通用场景

关键特性

自动化执行: 将文本内容转化为双主持人对话播客的基础工具。基于MagicPodcast API将纯文本内容转化为双主持人对话式播客.
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

异常响应

针对AI播客生成(免费版)使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

AI播客生成(免费版)通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块