AI播客生成工具 - 免费版

概述

AI播客生成免费版是一款面向个人用户的文档转播客工具。通过 MagicPodcast 引擎,将 PDF、文本、笔记或链接转化为自然的双人对话播客,几分钟即可获得可收听可分享的音频内容。

本版本适合内容创作者、学习者及多渠道内容分发者,通过分步引导式交互,快速将图文内容转化为音频形式。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：链接转为双人对话、适合个人创作者快、速制作音频内容、播客生成免费版、面向个人用户的文、档转播客工具等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:文章转播客

内容创作者希望将一篇博客文章转为播客,方便通勤族收听。

# 配置 API
export MAGICPODCAST_API_URL="https://api.magicpodcast.app"
export MAGICPODCAST_API_KEY="your_api_key"

# 从文本创建播客
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"

场景二:PDF 报告转播客

用户希望将一份 PDF 报告转为播客,方便听觉学习。

# 从 PDF URL 创建播客
PDF_URL="https://example.com/report.pdf"
LANGUAGE="zh"

# 验证 URL 有效性
if ! printf '%s' "$PDF_URL" | grep -Eq '^https?://[^[:space:]]+$'; then
  echo "Invalid PDF URL" >&2
  exit 1
fi

payload="$(jq -n --arg pdfUrl "$PDF_URL" --arg language "$LANGUAGE" '{pdfUrl:$pdfUrl,language:$language}')"

curl -sS -X POST "$MAGICPODCAST_API_URL/agent/v1/podcasts/pdf" 
  -H "Content-Type: application/json" 
  -H "x-api-key: $MAGICPODCAST_API_KEY" 
  --data-binary "$payload"

场景三:学习笔记转播客

学生希望将学习笔记转为播客,通勤时复习。

流程:
1. 系统询问播客主题
2. 询问内容来源(粘贴文本)
3. 询问播客语言
4. 确认后创建播客
5. 返回分享链接

用户: 把我的机器学习笔记转成播客
系统: 请粘贴你的笔记文本
用户: [粘贴文本]
系统: 播客用什么语言?
用户: 中文
系统: 确认创建中文播客?
用户: 是
系统: 已创建,链接: https://www.magicpodcast.app/...

不适用场景

以下场景AI播客生成-免费版不适合处理：

• 加密文件破解
• 损坏文件修复
• 物理介质数据恢复

触发条件

需要文件处理、文档转换、格式互转、内容提取时使用。不适用于非本工具能力范围的需求。

快速开始

第一步:配置 API Key

export MAGICPODCAST_API_URL="https://api.magicpodcast.app"
export MAGICPODCAST_API_KEY="your_api_key"

获取地址:https://www.magicpodcast.app/skill-platform

第二步:分步交互创建

系统会依次询问:主题→来源→语言→确认,然后创建播客。

第三步:查看结果

创建后访问 https://www.magicpodcast.app/app 查看播客仪表盘,生成完成后返回分享链接。

示例

基础配置项说明:

# 环境变量
MAGICPODCAST_API_URL=https://api.magicpodcast.app
MAGICPODCAST_API_KEY=your_key

# 安全命令模板
safe_job_id() {
  printf '%s' "$1" | grep -Eq '^[A-Za-z0-9_-]{8,128}$'
}

safe_http_url() {
  printf '%s' "$1" | grep -Eq '^https?://[^[:space:]]+$'
}

# 查询任务状态
curl -sS "$MAGICPODCAST_API_URL/agent/v1/jobs/$JOB_ID" 
  -H "x-api-key: $MAGICPODCAST_API_KEY"

最佳实践

1. 内容质量决定效果:输入文本结构清晰、信息丰富,生成的播客质量更高
2. 语言明确指定:不要假设语言,明确指定(如"中文"、"English")避免异常
3. PDF 需可访问:PDF URL 必须是公开可访问的直链,本地文件需先上传
4. 生成需等待:播客生成通常需要 2-5 分钟,可在仪表盘查看进度
5. 敏感内容谨慎:不要发送敏感文档,除非确认可接受外部处理
6. 分享链接优先:完成后默认返回 outputs.shareUrl,缺失时回退到 outputs.appUrl

常见问题

Q1:API Key 如何获取?

A:访问 https://www.magicpodcast.app/skill-platform,用 Google 账号登录,复制 API Key。免费注册,一分钟内完成。

Q2:本地 PDF 文件怎么处理?

A:需先将本地 PDF 上传到可访问的 URL(如网盘公开链接),再使用 PDF URL 方式创建。

Q3:生成失败怎么办?

A:检查 API Key 是否有效;确认 PDF URL 可公开访问;查看返回的错误信息;稍后重试。

已知限制

A:登录用户可免费生成播客,但有配额限制。如需批量生成或高级功能,请使用 PRO 版。

Q5:生成的播客可以下载吗?

A:免费版仅提供在线分享链接。如需下载音频文件,请使用 PRO 版的音频下载功能。

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 运行时: Bash shell + curl + jq

依赖详情

API Key 配置

• 环境变量名: MAGICPODCAST_API_KEY
• 附加变量: MAGICPODCAST_API_URL(有默认值)
• 获取方式: 访问 https://www.magicpodcast.app/skill-platform 注册
• 存储建议: 写入 .env 文件或系统环境变量,避免硬编码到脚本

可用性分类

• 分类: MD+EXEC(纯 Markdown 指令,核心功能需要 exec 命令行执行能力)
• 说明: 基于Markdown的AI Skill,通过分步对话与 curl 调用驱动播客生成流程

错误处理