> 核心功能: 本技能提供中文交互、化工作流场景等能力。

音频流上传免费版

概述

音频流上传免费版是一款面向个人创作者的轻量级音频上传工具。通过简洁的三步API流程（创建 → 上传 → 完成），帮助用户将本地音频文件快速上传至流媒体平台，并获取HLS流媒体播放链接。无需复杂配置，开箱即用。

核心能力

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
- 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
- 执行此能力时使用output_format参数,支持导出/保存/转换操作
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：快速上传音频至流、媒体平台、支持基础创建、上传与完成三步流、流媒体链接、音频流上传免费版、面向个人创作者的、轻量级音频上传工、通过三步、API、调用完成音频上传、创建对象、上传文件、完成处理、支持默认快速上传、自动计算文件、哈希值、确保上传完整性校、流媒体播放链接、兼容主流音频格式等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：播客节目上传

个人播客创作者需要将录制好的MP3文件上传至流媒体平台，获取播放链接分享给听众。

<!-- Code block removed for WAF compatibility -->

<!-- Code block removed for WAF compatibility -->

<!-- Code block removed for WAF compatibility -->

场景二：语音内容分发

语音教程或有声书创作者上传音频内容，获取流媒体链接嵌入到个人网站或博客。

<!-- Code block removed for WAF compatibility -->

场景三：音乐作品发布

独立音乐人上传原创音乐作品，获取HLS链接用于在线试听和分享。

<!-- Code block removed for WAF compatibility -->

不适用场景

以下场景音频流上传免费版不适合处理：

• 版权受保护的媒体内容处理
• 实时直播推流
• 专业影视后期

触发条件

需要视频处理、音频编辑、媒体转换、配音生成时使用。不适用于非本工具能力范围的需求。

快速开始

1. 获取API密钥

在使用本工具前，需要准备以下凭证：

• stream-public-key：流媒体平台的公钥
• stream-secret-key：流媒体平台的密钥

2. 执行三步上传

<!-- Code block removed for WAF compatibility -->

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

基础配置

<!-- Code block removed for WAF compatibility -->

Content-Range 格式说明

优选实践

1. 文件大小控制：免费版建议单个音频文件不超过500MB，超大文件建议使用分片上传
2. 网络稳定性：上传前确保网络连接稳定，避免上传中断导致需要重新上传
3. 哈希校验：始终使用MD5哈希进行完整性校验，确保文件传输无误
4. 标题规范：使用清晰有意义的标题，便于后续管理和查找
5. 格式选择：推荐使用MP3格式上传，兼容性优质且文件体积适中

常见问题

Q1：上传失败提示401错误怎么办？

401错误表示API密钥无效。请检查 stream-public-key 和 stream-secret-key 是否正确，确认密钥未过期。

Q2：上传完成后为什么获取不到播放链接？

音频上传完成后需要经过转码处理。如果返回状态为 transcoding，请等待几分钟后再次查询。

Q3：Content-Range头部格式错误怎么办？

确保格式为 bytes {起始位置}-{结束位置}/{总大小}。单文件上传时，起始位置为0，结束位置为文件大小减1。

Q4：支持哪些音频格式？

支持MP3、WAV、AAC、FLAC、OGG等主流音频格式。建议使用MP3格式以获得优选兼容性。

已知限制

免费版建议单个文件不超过500MB。如需上传更大文件，建议升级至PRO版本使用分片上传功能。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8及以上（使用Python脚本时）
• 命令行工具: curl、md5sum（或md5命令）

依赖详情

API Key 配置

• stream-public-key：流媒体平台公钥，通过HTTP头发送
• stream-secret-key：流媒体平台密钥，通过HTTP头发送
• 所有API调用均需在HTTP头中携带以上两个密钥

可用性分类

• 分类: MD+EXEC（纯Markdown指令，核心功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行音频上传任务。核心三步流程通过curl命令执行，也可通过Python脚本封装调用。
• API Key通过环境变量配置: export API_KEY=your_key

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比