基础信息
接口补充说明
接口地址：POST /api/v1/endpoints/youtube
认证：Authorization: Bearer 您的API Key
请求类型：application/json
请求参数：url（必填，YouTube公开视频或 Shorts 链接）
请求示例：{"url":"https://www.youtube.com/watch?v=M7lc1UVf-VE"}
成功返回：code=0、platform=youtube、data.id/title/author/cover/url/formats/audio_url/requires_merge 等。
说明：默认从最高原始画质开始返回3档不同清晰度，传all_qualities=true可返回全部不同清晰度；requires_merge=true时独立视频与音轨可能需要由客户端合并；媒体URL可能过期。解析失败不计成功扣点。请求头
| 参数 | 内容 | 说明 |
|---|---|---|
| Authorization | Bearer dcy_... | 必填；从用户中心创建 API Key |
| Content-Type | application/json | 必填；JSON 请求体 |
JSON 请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| url | 字符串 | 是 | 作品或平台分享链接（HTTP / HTTPS） |
| all_qualities | 布尔值 | 否 | 默认 false，返回最多3档供应商实际提供的不同画质；true 返回全部有据可查的清晰度。自有YouTube高清可能需要单独下载 audio_url 合并音轨 |
调用示例
请把示例中的密钥替换为自己的完整 API Key。
cURL
curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/youtube" \
-H "Authorization: Bearer dcy_你的完整密钥" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=M7lc1UVf-VE","all_qualities":false}'JavaScript
fetch('https://api.dcykjgw.com/api/v1/endpoints/youtube', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer dcy_你的完整密钥'
},
body: JSON.stringify({"url":"https://www.youtube.com/watch?v=M7lc1UVf-VE","all_qualities":false})
}).then(res => res.json()).then(console.log);返回格式示例
以下展示通用失败响应；成功响应的媒体字段由对应平台解析器决定，以实际调用结果为准。
成功响应结构（字段随平台变化）
{
"code": 0,
"msg": "解析成功",
"platform": "平台名称",
"data": {}
}返回参数说明
| 字段 | 格式 | 说明 |
|---|---|---|
code | 数字 | 业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。 |
msg | 字符串 | 本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。 |
platform | 字符串 | 当前接口/平台标识，成功响应中用于区分具体接口来源。 |
data | 对象 | 接口业务数据；具体字段含义见下方本接口字段说明。 |
data.type | 字符串 | 解析内容类型，例如 video、image 等；不同平台可能略有差异。 |
data.title | 字符串 | 作品标题或正文摘要；平台未提供时可能为空。 |
data.author | 字符串/对象 | 作品作者信息；具体结构取决于对应平台公开数据。 |
data.cover | 字符串 | 封面图片 URL；平台未提供封面时可能为空。 |
data.url | 字符串/null | 主要视频或媒体地址；图文作品可能为空。 |
data.images | 字符串数组 | 图文作品图片地址列表；非图文内容通常不存在或为空。 |
data.music | 对象 | 背景音乐信息，只有对应平台和作品提供时才返回。 |
data.list / data.items | 数组 | 主页/列表类解析的作品列表；单作品解析通常不返回。 |
请求参数错误示例
{
"code": 422,
"msg": "请提供有效的 HTTP 或 HTTPS 平台链接"
}HTTP 401：API Key 无效；402：余额不足；403：禁止调用、包月到期或需要用户授权；429：频率、配额或并发上限；503：服务不可用。
在线测试
仅在当前页面内提交请求，API Key 不写入浏览器本地存储。
响应结果
填写参数后点击“发送测试请求”。