⚡ Cloudflare Workers API 文档

共 14 个 Worker，分为核心研究管道、YouTube 音频转录、代理工具、早期测试四类。

核心研究管道架构
📸 截图 / URL
输入
→
🔍 image-recognize
识别类型
→
▶️ YouTube → 写入 Wiki
🐙 GitHub → Gemini分析 → Wiki
核心研究管道
🔍 image-recognize
image-recognize.hb67egcim4.workers.dev
通用识别入口。支持截图URL、平台链接、上传图片，识别 YouTube / GitHub 返回结构化数据。
🔬 research-workflow
research-workflow.hb67egcim4.workers.dev
完整研究工作流。识别后自动深度分析并写入 GitHub Wiki，异步执行返回 workflow_id。
▶️ youtube-content-parse
youtube-content-parse.hb67egcim4.workers.dev
YouTube 专用解析器。支持链接、截图、上传图片，返回视频元数据。
🚀 youtube-auto-research
youtube-auto-research.hb67egcim4.workers.dev
youtube-content-parse 的统一入口封装，未来扩展更多研究阶段。
YouTube 音频转录管道
🎵 youtube-audio
youtube-audio.hb67egcim4.workers.dev
下载 YouTube 视频音频，存入 R2，返回音频流（audio/mpeg）。
📝 youtube-transcript
youtube-transcript.hb67egcim4.workers.dev
获取 YouTube 视频字幕/转录文本。
🎙️ youtube-whisper
youtube-whisper.hb67egcim4.workers.dev
调用容器服务用 Whisper 模型对 YouTube 音频做语音转文字。
📦 fragrant-darkness-d8b4
fragrant-darkness-d8b4.hb67egcim4.workers.dev
R2 文件上传 Worker，支持 JSON base64 或 multipart 上传。

🔍 image-recognize

POSThttps://image-recognize.hb67egcim4.workers.dev

通用内容识别 Worker。支持三种输入，自动判断 YouTube 或 GitHub，返回结构化数据。可通过 Service Binding 被其他 Worker 内部调用（research-workflow 正在使用）。

支持的输入方式（三选一）
方式字段说明
平台链接urlYouTube 或 GitHub 链接，直接解析，不经过 Gemini
截图 URLscreenshot_url截图的公开 URL，下载后用 Gemini 识别
上传图片file (multipart)直接上传图片文件，用 Gemini 识别
curl 示例
传入 YouTube 链接
curl -X POST https://image-recognize.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'
传入 GitHub 仓库链接
curl -X POST https://image-recognize.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/owner/repo"}'
传入截图 URL
curl -X POST https://image-recognize.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"screenshot_url": "https://example.com/screenshot.png"}'
上传图片文件
curl -X POST https://image-recognize.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/screenshot.png"
返回示例
YouTube 识别结果
{
  "success": true,
  "type": "youtube",
  "data": {
    "video_id": "Ahfe-BW1cFc",
    "title": "视频标题",
    "author": "频道名称",
    "published_at": "2024-01-01T00:00:00Z",
    "url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc",
    "thumbnail": "https://i.ytimg.com/vi/xxx/hqdefault.jpg"
  }
}
GitHub 识别结果
{
  "success": true,
  "type": "github",
  "data": {
    "repo": "owner/repo",
    "description": "项目描述",
    "stars": 1234,
    "forks": 56,
    "language": "TypeScript",
    "topics": ["ai", "cloudflare"],
    "url": "https://github.com/owner/repo"
  }
}

🔬 research-workflow

POSThttps://research-workflow.hb67egcim4.workers.dev

完整研究工作流。调用 image-recognize 识别内容后，YouTube 写入 Wiki，GitHub 则经 Gemini 深度分析后写入 Wiki。使用 Cloudflare Workflow 异步执行，不受 30s 限制。

执行流程
HTTP 请求
→
image-recognize
Step 1
→
YouTube → 写入 youtube-video-research-wiki
GitHub → Gemini 分析 → 写入 llm-wiki-obsidian-blink
⚡ 请求立即返回 workflow_id，实际在后台异步执行。YouTube 约 10s，GitHub 深度分析约 2-5 分钟。
curl 示例
YouTube 链接 → 写入 Wiki
curl -X POST https://research-workflow.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'
GitHub 仓库 → Gemini 分析 → Wiki
curl -X POST https://research-workflow.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/owner/repo"}'
截图 URL → 自动识别 → 研究
curl -X POST https://research-workflow.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"screenshot_url": "https://example.com/screenshot.png"}'
上传截图 → 自动识别 → 研究
curl -X POST https://research-workflow.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/screenshot.png"
返回示例
成功响应（立即返回）
{
  "success": true,
  "workflow_id": "7eef219a-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "message": "任务已启动，正在异步执行"
}
所需 Secrets
变量名用途
UPLOAD_TOKENAPI 鉴权 Token
GEMINI_API_KEYVertex AI / Gemini API Key（图片识别 + GitHub 分析）
GITHUB_TOKEN写入 YouTube Wiki 仓库（youtube-video-research-wiki）
GITHUB_WIKI_TOKEN写入 GitHub 研究 Wiki 仓库（llm-wiki-obsidian-blink）

▶️ youtube-content-parse

POSThttps://youtube-content-parse.hb67egcim4.workers.dev

YouTube 专用解析器。支持直接传链接或上传截图，返回视频完整元数据。被 youtube-auto-research 通过 Service Binding 调用。

curl 示例
传入 YouTube 链接
curl -X POST https://youtube-content-parse.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'
上传截图图片
curl -X POST https://youtube-content-parse.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/screenshot.png"
传入截图 URL
curl -X POST https://youtube-content-parse.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"screenshot_url": "https://example.com/screenshot.png"}'

🚀 youtube-auto-research

POSThttps://youtube-auto-research.hb67egcim4.workers.dev

youtube-content-parse 的统一入口封装。通过 Service Binding 内部调用，无网络开销。目前仅 Stage 1（内容解析），未来会扩展更多研究阶段。

💡 入参和返回格式与 youtube-content-parse 完全相同。
curl 示例
传入 YouTube 链接
curl -X POST https://youtube-auto-research.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'
上传截图图片
curl -X POST https://youtube-auto-research.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/screenshot.png"

🎵 youtube-audio

POSThttps://youtube-audio.hb67egcim4.workers.dev

下载 YouTube 视频音频，存入 R2 存储，返回音频流（audio/mpeg）。通过容器服务（Container Binding）执行下载任务。

curl 示例
下载 YouTube 音频
curl -X POST https://youtube-audio.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'

📝 youtube-transcript

POSThttps://youtube-transcript.hb67egcim4.workers.dev

获取 YouTube 视频字幕或自动生成的转录文本。

curl 示例
获取视频字幕
curl -X POST https://youtube-transcript.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'

🎙️ youtube-whisper

POSThttps://youtube-whisper.hb67egcim4.workers.dev

调用容器服务（Container Binding）对 YouTube 音频运行 Whisper 模型进行语音转文字，生成高质量转录文本。

curl 示例
Whisper 语音转文字
curl -X POST https://youtube-whisper.hb67egcim4.workers.dev \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Ahfe-BW1cFc"}'

🔀 rapid-mode-f8c5

GEThttps://rapid-mode-f8c5.hb67egcim4.workers.dev
自定义域名https://git.chxyka.ccwu.cc→ github.com
自定义域名https://assets.chxyka.ccwu.cc→ github.githubassets.com

GitHub 反向代理。将自定义域名流量代理到 GitHub，并移除 CSP 限制，解决国内访问问题。

通过自定义域名访问，像正常访问 GitHub 一样使用即可。

🌐 restless-breeze-a220

ALLhttps://restless-breeze-a220.hb67egcim4.workers.dev
路由规则cdn.vyibc.com/*

CDN 透明代理。收到请求后将 hostname 替换为 cdn.chxyka.ccwu.cc 再转发，对调用方完全透明。用于对外暴露统一的 CDN 域名，隐藏真实存储来源。

路由配置说明
项目值
触发路由cdn.vyibc.com/*（所有路径）
代理目标cdn.chxyka.ccwu.cc（真实 R2/CDN 域名）
请求方式透传，method / headers / body 完全不变
使用场景访问 cdn.vyibc.com/xxx.jpg → 实际从 cdn.chxyka.ccwu.cc/xxx.jpg 取文件
该 Worker 通过路由规则触发，无需手动调用。访问 cdn.vyibc.com 下任意路径即可自动生效。

📦 fragrant-darkness-d8b4

推荐入口https://upload-r2.vyibc.com
自定义域名https://upload-r2.chxyka.ccwu.cc
自定义域名https://parse.chxyka.ccwu.cc
POSThttps://fragrant-darkness-d8b4.hb67egcim4.workers.dev

图片上传 Worker。上传图片到 Cloudflare R2，自动生成公开 CDN 链接，并可选触发 Dify AI 工作流处理图片。

完整处理流程
POST 图片
multipart / base64
→
鉴权校验
UPLOAD_TOKEN
→
写入 R2
生成唯一文件名
→
触发 Dify
可选，传入图片URL
→
返回结果
image_url + ai_result
支持的输入格式
格式Content-Type字段说明
表单上传multipart/form-datafile直接上传图片文件，推荐方式
Base64 JSONapplication/jsonfile, type, name支持 data:image/png;base64,... 或纯 base64 字符串
支持的图片格式
image/png · image/jpeg · image/webp · image/gif其他格式返回 400
curl 示例
multipart 上传（推荐）
curl -X POST https://upload-r2.vyibc.com \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/image.jpg"
JSON base64 上传
curl -X POST https://upload-r2.vyibc.com \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "data:image/jpeg;base64,/9j/4AAQ...",
    "name": "screenshot.jpg"
  }'
返回示例
成功响应
{
  "success": true,
  "image_url": "https://cdn.vyibc.com/uploads/2026-05-16/uuid.jpg",
  "object_key": "uploads/2026-05-16/uuid.jpg",
  "ai_result": { ... }
}
所需 Secrets / 绑定
名称类型说明
UPLOAD_TOKENSecretAPI 鉴权 Token
MY_BUCKETR2 Binding存储图片的 R2 桶
PUBLIC_CDN_URLSecretR2 公开访问域名，用于拼接返回 URL
DIFY_API_KEYSecretDify 工作流 API Key（可选）
DIFY_WORKFLOW_URLSecretDify 工作流触发地址（可选）

🗂️ auto-research（旧版）

POSThttps://auto-research.hb67egcim4.workers.dev
自定义域名https://auto-research.chxyka.ccwu.cc
路由规则auto-research.vyibc.com/*

早期版本的研究 Worker，调用 Dify Webhook 触发工作流。已被 research-workflow 取代，建议使用新版。

⚠️ 该 Worker 为旧版，依赖 Dify 平台，当前架构已不再使用。推荐使用 research-workflow。

🧪 workflows-starter-template

-workflows-starter-template.hb67egcim4.workers.dev

Cloudflare Workflow 官方入门模板。包含 MyWorkflow 类和 Durable Object 状态追踪，用于学习和测试 Workflow 机制。

这是学习用模板，不是生产 API。

🤖 wandering-firefly-e01a

GEThttps://wandering-firefly-e01a.hb67egcim4.workers.dev

Cloudflare Workers AI 测试 Worker。使用 @cf/meta/llama-3-8b-instruct 模型，演示 prompt 和 chat 两种调用方式。

这是 AI 绑定测试，不是生产 API。

👋 hello-worker

GEThttps://hello-worker.hb67egcim4.workers.dev

最简单的测试 Worker，返回 "Hello from Cloudflare Worker! 🚀"，用于验证 Worker 部署是否正常。

测试请求
curl https://hello-worker.hb67egcim4.workers.dev