为什么 CreaPilot 需要我自己的 YouTube API Key 而不直接帮我托管？

每个用户用自己的 Key，Google 那边的 quota 就计在你的账号下，互不影响。共享 Key 会导致所有用户挤一个限流，单点出问题整组人都受影响。这是 CreaPilot 目前的默认设计；如果未来开放托管选项会另行说明，不在本文承诺范围。

Key 配置后多久能看到第一条监听数据？

添加完频道之后 CreaPilot 会在后台异步拉取频道资料和最近视频。具体延迟取决于产品当前的同步节奏；如果几分钟后频道卡片还没刷新出来，去刷新一下页面或者重新进入 /sources 通常就能看到。

Key 泄露了怎么办？

回到 Google Cloud Console 的凭据页，撤销旧 Key 并生成新的，然后在 CreaPilot /settings 页粘贴新 Key 即可。已经添加的监听清单和频道数据不受影响——它们是存在 CreaPilot 里的，不是 Key 里。

我能不能用一个 Key 同时给多个工具用？

技术上可以，但不推荐。Google quota 是按 Key 累计的，多工具共享一个 Key 容易突然超额且不知道是谁吃掉的。每个工具单独申请一个 Key（同一个 Google Cloud 项目下创建多个 Key 也行）。

如何在 CreaPilot 中配置 YouTube API Key

难度: 入门需要的先决条件: 已有 Google 账号 · 已注册 CreaPilot 并登录

一句话理解这件事

YouTube Data API v3 是 Google 提供的官方接口，允许第三方应用读取 YouTube 频道和视频的公开元数据。CreaPilot 用它代表你的身份去拉数据——你提供 Key，Google 看到的是”你的”请求，quota 也归到你的 Google 账号下。Key 在你的 Google Cloud 项目里生成、由你撤销，不在 CreaPilot 这边。

整个过程约 10 分钟，全部免费。下面分四步走。

第一步：进入 Google Cloud Console 并创建项目

访问 console.cloud.google.com
用你的 Google 账号登录
在顶部的项目选择器里点 “新建项目” / “New Project”
项目名随便填一个能认出来的，例如 creapilot-youtube，其他字段保持默认
等 1-2 秒，新项目创建完成并自动切换过去

第一次进 Google Cloud 的人会看到一些”需要绑定结算账号”的提示——忽略它。YouTube Data API v3 的免费额度不需要绑卡，绑卡只是在你想用其他付费 API 时才必要。

第二步：启用 YouTube Data API v3

这是最关键的一步。Key 创建出来但 API 没启用，是新手最常踩的坑——Key 看起来正常，但所有请求都会返回 403。

左上角汉堡菜单 → “API 和服务” / “API & Services” → “库” / “Library”
搜索框输入 YouTube Data API v3
点击搜索结果里的官方条目（注意：v3 而不是别的版本）
在 API 详情页点击 “启用” / “Enable”
等 5-10 秒，状态变为”已启用” / “API enabled”

如果你后面看到 accessNotConfigured 错误，回到这一步再确认一遍。

第三步：创建 API 凭据

左侧菜单 → “API 和服务” → “凭据” / “Credentials”
顶部 ”+ 创建凭据” / “Create Credentials” → “API 密钥” / “API key”
弹窗会显示一串以 AIza... 开头的字符串，约 39 个字符——这就是你的 Key
立即点击 “编辑 API 密钥”：
- 在 “应用程序限制” / “Application restrictions” 里选 “无” 或按你的部署环境配置
- 在 “API 限制” / “API restrictions” 里改为 “限制密钥” / “Restrict key”，只勾选 YouTube Data API v3
- 保存

第 4 步不做也能用，但 Key 如果泄露，攻击者可以拿它调任何 Google API。限制到单个 API 是最低成本的防御。

第四步：在 CreaPilot 中粘贴 Key

登录 CreaPilot：/auth
进入设置页：/settings
在设置页中找到 YouTube API Key 字段，把上一步复制的 Key 粘贴进去
保存

CreaPilot 在保存时会做一次有效性校验（用 Key 去请求一个公开频道的资料），几秒内返回结果。如果失败，下一节有错误信息对照表。

不同版本的设置页 UI 措辞可能略有差别（“YouTube API Key”、“YouTube Data API Key”、或者放在”信息源 / Sources”小节内）。看到带 “YouTube” 字样的 API Key 输入框就是它。

验证 Key 是否真的在工作

最直接的验证方式：

去 /sources，添加一个稳定更新的英文频道，例如 Two Minute Papers
如果几秒内频道卡片加载出资料（订阅数、最近视频列表），说明 Key 已经在工作
如果加载失败，对照下面的错误信息表

错误	含义	怎么修
`API key not valid`	Key 字符串本身有问题	回 CreaPilot /settings 重新粘贴；注意首尾没有空格
`accessNotConfigured` 或 `disabled`	Data API v3 没启用	回第二步，确认 API 是”已启用”状态
`quotaExceeded`	当天 quota 用完了	等到 UTC 时间零点后再试；如果是首日就遇到，检查是不是有别的应用在共用 Key
`keyInvalid` 但 Key 看起来对	Key 限制（API restrictions）没把 YouTube Data API v3 勾上	回 Google Cloud Console 凭据页，编辑 Key，确认勾选

Quota 怎么算

YouTube Data API v3 的免费额度是每天 10,000 quota units（不是请求数）。常见操作的消耗（来自 Google 官方文档，可能随版本调整）：

操作	大致消耗
获取频道基本信息	1 单位
列出频道最新视频	1-5 单位
获取单个视频详情	1 单位
按关键词搜索	100 单位

10,000 单位日常监听完全用不完——监听 50 个频道、每天刷新若干次也只在几百单位量级。容易把 quota 烧光的是”按关键词搜索”模式，这是为什么 CreaPilot 默认走频道路径而不是搜索。

配置完之后

Key 在手，下一步是建你的第一份监听清单：如何创建你的第一份监听清单。完整工作流的全景见英文 YouTube 到中文公众号的工作流。