Karadeo — Agent 与 AI 集成指南

Karadeo 是一个卡拉 OK 与歌词工具平台。本文档描述了所有可用的 API、工具及 Agent 集成接口。

认证

所有 API 端点均需使用来自 https://karadeo.com/dashboard 的 Bearer API 密钥。

Authorization: Bearer kd_

MCP Server

Karadeo 提供完整的 MCP（Model Context Protocol）Server，供 AI Agent 调用工具使用。

端点： POST https://karadeo.com/api/mcp
传输协议： 可流式传输的 HTTP（JSON-RPC 2.0）
服务发现： https://karadeo.com/.well-known/mcp/server-card.json

初始化

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

列出工具

{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

调用工具

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "transcribe",
    "arguments": {
      "audio_url": "https://example.com/song.mp3",
      "format": "lrc"
    }
  }
}

REST API

转录（Transcribe）

将音频或视频转换为时间同步的歌词或字幕文件。

端点： POST https://karadeo.com/api/transcribe
文档： https://karadeo.com/resources/karadeo-lyrics-api
OpenAPI： https://karadeo.com/api/doc

请求体（JSON）：

示例：

curl -X POST https://karadeo.com/api/transcribe 
  -H "Authorization: Bearer kd_your_key" 
  -H "Content-Type: application/json" 
  -d '{"fileUrl":"https://example.com/song.mp3","format":"lrc"}'

响应： 带有合适 Content-Type 头的纯文本字幕文件。

WebMCP（浏览器端）

Karadeo 在每次页面加载时通过 navigator.modelContext.registerTool() 向浏览器注册工具。

当前可用工具包括：

• list-karaoke-tools — 列出所有 Karadeo 工具及其 URL
• navigate-to-tool — 跳转至指定工具页面
• list-karaoke-templates — 列出可用的卡拉 OK 视频模板

发现端点（Discovery Endpoints）

内容策略（Content Policy）

Content-Signal: ai-train=no, search=yes, ai-input=no

AI Agent 可读取本网站以调用工具；但禁止基于网站内容进行模型训练。