Partner Program · Usage Policy & Access Key · v1

声湃合作伙伴接入计划与使用规范

WavPub Partner Access Program, Origin Streaming Policy & Compliance Guidelines

标准客户端回源播放
无需申请 · 免密钥 · 永不拦截
认证凭证名称
合作方访问密钥(Access Key · wpak_*)
默认初始配额
10 次/秒(QPS)· 2,000 次/日(北京时间)
鉴权作用范围
仅音频文件域名(通常是 tk.wavpub.com)
RSS 订阅规范
RSS Feed 地址(如 proxy.wavpub.com)保持开放
合作、申诉与授权备案
[email protected] / [email protected]

一、为什么设立音频分发访问风控与合作伙伴机制

声湃(WavPub)同时服务两类播客内容分发链路:一类是由创作者直接托管在声湃的节目,另一类是通过声湃 RSS 代理服务加速与统计、音频文件指向各上游托管源站的节目。长期运行中,我们持续面对大量无标识脚本、云机房并发下载器与分布式代理池对音频文件域名(通常是 tk.wavpub.com)进行全库扫荡式抓取,这会带来三个直接后果:

  1. 1.1污染创作者的收听统计:播客行业以 IAB 口径统计真实听众下载与播放量,创作者依赖这份数据评估节目走势与商业合作价值。未标识的自动化脚本混在匿名流量里,会直接扭曲节目的真实收听数据。
  2. 1.2冲击托管带宽与上游源站稳定性:单期播客音频常在几十至数百 MB,恶意批量并发拉取会挤占正常听众的播放带宽,并对回源模式下的第三方源站造成异常流量压力,甚至引发上游源站限流。
  3. 1.3不同源站具有不同风控偏好:声湃对托管节目与各个回源源站实行差异化风控策略,同时为正当的播客生态工具(如语音转写研究、节目索引、行业分析、合规 AI 助手)提供实名可追溯、配额可控的合作伙伴通道,让合法调用与恶意爬虫彻底分层。

二、鼓励回源播放:为什么普通客户端不需要申请

播客生态建立在开放的 RSS 协议之上。声湃坚定鼓励并默认放行标准播客客户端的直接回源播放:

  1. 2.1什么是回源播放:听众使用 Apple Podcasts、小宇宙、Pocket Casts、Castro、Overcast、Antennapod、浏览器音频播放器或各类播客 App 收听时,由听众终端直接向 RSS Feed 中声明的音频文件域名(通常是 tk.wavpub.com)发起播放请求并按 302 跳转拉取媒体流。
  2. 2.2无需申请、无需密钥、不会拦截:遵循标准 RSS 协议的客户端与个人正常收听行为,不需要申请合作伙伴资格,也不需要在播放器里携带任何合作方访问密钥(Access Key)。声湃对真实终端的回源播放实行免打扰放行策略,并完整保留创作者的收听数据回流。
  3. 2.3RSS Feed 地址保持开放:RSS Feed 地址(通常是 proxy.wavpub.com 或节目专属订阅域名)承担全网订阅更新职责,声湃暂不对 RSS 订阅地址实施阻断拦截;风控仅作用于音频与视频文件分发域名上的异常批量抓取流量。
开发播客播放器时的建议:请不要把合作方访问密钥硬编码进 iOS / Android / 桌面客户端或前端网页中。客户端应直接让用户终端回源播放;一旦密钥被反编译提取并从成百上千个终端 IP 并发调用,系统会自动触发密钥泄露预警并暂停该密钥。

三、什么情况下需要申请合作伙伴

如果你的业务属于以下服务端批量访问场景,且你的服务器从云机房或集中出口 IP 周期性拉取音频文件,则可能触发匿名反爬风控,建议申请成为声湃合作伙伴并使用合作方访问密钥(Access Key):

  1. 3.1离线语音转写与内容分析:需要服务端自动拉取公开单集音频,进行语音识别(ASR)、章节切分、主题摘要、关键词索引或播客商业洞察分析,且不向外部用户提供基于本地缓存副本的播放服务。
  2. 3.2学术研究、舆情与媒体监测:高校实验室、研究机构或合规监测服务需要按固定节奏拉取公开音频样本进行数据建模与统计研究。
  3. 3.3已获双重书面授权的聚合分发或特定硬件接入:确因业务形态需要中转、缓存或为特定终端提供托管播放服务的机构,在取得创作者与源 RSS 平台双重书面授权并向声湃备案后,可申请对应的合作伙伴通道。

四、使用规范与版权合规红线(核心条款)

获得合作方访问密钥(Access Key)仅代表声湃在技术分发层面对你的服务端抓取流量予以放行与配额管理,绝不构成声湃向你授予任何播客内容版权或上游平台接口授权。合作方必须严格区分以下两种本地缓存行为:

允许申请:本地拉取用于内部分析处理

从音频文件域名拉取文件到你的内部受控环境,用于语音转写、向量检索、主题提取、质量分析等后台处理工作,处理完毕后按最小必要原则清理或仅内部留存,不以本地缓存文件对外提供播放或下载服务。若涉及面向终端用户的播放入口,须引导听众回源播放原 RSS 音频地址。

严格受限:本地缓存并对外提供「播放服务」

将拉取下来的音频文件缓存在你自己的服务器/CDN 上,并以此缓存副本向终端用户提供在线播放、转码分发或音频下载服务,不仅会切断创作者的收听统计,更直接构成版权侵权与违约风险——因为内容版权归属于创作者,而源 RSS 接口的管理权归属于源托管平台。

  1. 4.1双重书面授权原则:若你确需将音频文件本地缓存并对外提供播放服务,你必须同时取得「创作者」与「源 RSS 平台」的双重书面授权。例如,若该节目的源 RSS 来自小宇宙,你必须同时取得小宇宙平台与该节目创作者双方的书面同意,并将授权证明抄送至 [email protected] 备案,方可开展对外缓存播放业务。
  2. 4.2禁止将密钥嵌入终端或二次转售:合作方访问密钥仅限申请方自有服务端使用,严禁打包进手机 App / 浏览器前端,严禁共享、出租、转售或作为代理中转池提供给未授权第三方。
  3. 4.3禁止绕过风控与规避配额:严禁通过注册多个马甲账号叠加配额、切换住宅代理池规避限流或伪造正常播客客户端请求头绕过检测。
  4. 4.4违规处置与法律责任:一旦发现未获双重授权而对外提供缓存播放服务、密钥泄露滥用或恶意规避风控,声湃有权立即暂停或永久吊销合作方访问密钥,并保留向相关权利人披露违规线索及依法追究法律责任的权利。

五、默认配额与统计隔离机制

  1. 5.1默认初始配额:审核通过后的默认调用配额为 10 次/秒(QPS) 与 2,000 次/日(按北京时间 00:00 自动重置)。若你的合规业务需要更高配额,可在申请问卷中写明预期量级,或在开通后联系 [email protected] 申请提额。
  2. 5.2超限返回规范(HTTP 429):触发每秒速率限制时返回 429 Too Many Requests 与 Retry-After,且不会扣减你的当日剩余次数;触发每日限额时 Retry-After 会精确告知距离次日北京时间 00:00 的剩余秒数。
  3. 5.3创作者统计隔离:携带有效合作方访问密钥发起的请求默认不计入创作者的 IAB 收听量报表,确保你的批量抓取与分析作业不会污染创作者的真实听众数据。
  4. 5.4双密钥无缝轮换:每个合作伙伴账号最多同时启用 2 把合作方访问密钥(Access Key),便于在不停服的前提下完成定期密钥轮换。

六、合作方访问密钥(Access Key)接入方式

访问密钥统一采用前缀 wpak_,仅允许通过 HTTP 请求头传递,系统严格禁止通过 URL 查询参数(如 ?access_key= 或 ?api_key=)传递——以免密钥被记录在代理日志、Referer 或浏览器历史中造成泄露。

cURL 请求示例(推荐 Authorization Bearer,兼容 X-WavPub-Access-Key)
# 推荐:使用标准 Authorization Bearer 请求头携带合作方访问密钥(Access Key)
curl -i -L \
  -H "Authorization: Bearer wpak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://tk.wavpub.com/WPTK_xxxxxxxxxxxxxxxx.mp3"

# 备用请求头(当网关或播放器框架占用 Authorization 时)
curl -i -L \
  -H "X-WavPub-Access-Key: wpak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://tk.wavpub.com/WPTK_xxxxxxxxxxxxxxxx.mp3"
Python(requests)示例:只向音频文件域名发密钥,跳转后干净下载
import requests

url = "https://tk.wavpub.com/WPTK_xxxxxxxxxxxxxxxx.mp3"
headers = {
    "Authorization": "Bearer wpak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx",
    "User-Agent": "YourService/1.0 (+https://your-domain.example/bot)",
}

# 允许跟随 302 跳转,建议只对音频文件域名发送访问密钥,避免透传给第三方源站
resp = requests.get(url, headers=headers, allow_redirects=False, timeout=15)
if resp.status_code == 302:
    media_url = resp.headers["Location"]
    # 再用不带访问密钥的会话下载实际音频文件
    media_resp = requests.get(media_url, stream=True, timeout=60)
Go(net/http)示例
req, _ := http.NewRequestWithContext(ctx, http.MethodGet,
    "https://tk.wavpub.com/WPTK_xxxxxxxxxxxxxxxx.mp3", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("WAVPUB_ACCESS_KEY"))
req.Header.Set("User-Agent", "YourService/1.0 (+https://your-domain.example/bot)")

// 关闭自动跟随重定向,拿到 302 Location 后由干净的请求拉取媒体文件
client := &http.Client{
    CheckRedirect: func(*http.Request, []*http.Request) error {
        return http.ErrUseLastResponse
    },
}
resp, err := client.Do(req)

响应头说明

X-RateLimit-Limit-QPS302 / 429当前合作方账号生效的每秒请求上限(默认 10)。
X-RateLimit-Limit-Day302 / 429当前合作方账号生效的北京时间每日调用上限(默认 2,000)。
X-RateLimit-Remaining-Day302 / 429当日剩余可用次数(触发 QPS 限流时不扣减)。
X-WavPub-Risk-Ref403 / 429单次拦截或限流的唯一诊断参考号,联系我们排查时请附带此编号。

七、申请资质、审核流程与联系通道

为保障播客内容生态安全,所有合作伙伴申请均实行实名核验与人工审核制度,审核通过后立即开放合作伙伴后台并生效默认配额:

  1. 7.1个人开发者 / 研究者:须先完成声湃账号手机号绑定与个人实名认证,如实填写联系电话、接入产品与用途问卷,并确认遵守本使用规范。
  2. 7.2企业 / 机构:须提供企业全称、统一社会信用代码、加盖公章或清晰可读的营业执照原件/扫描件(JPG / PNG / PDF,10 MB 以内,加密存私有存储),并完成法定代表人二要素实名核验及联系电话与用途问卷填写。
  3. 7.3人工审核与通知:管理员审核通常在 1–3 个工作日内完成,结果将通过站内消息与联系邮箱同步通知。通过后即可进入 合作伙伴后台 创建和管理访问密钥。
确认符合服务端批量调用需求?

如果你只是开发常规播客播放器或听众客户端,直接遵循标准 RSS 协议回源播放即可,无需提交申请。