API 接口文档
使用授权码调用解析接口,系统自动识别链接平台并返回视频、图片地址。仅订阅用户可用。
我的 API Key
登录后即可查看您的 API Key
立即登录复制后在 url= 后面拼接待解析链接(中文链接需 URL 编码)。
在线测试
点击上方按钮开始测试...
基础信息
| Base URL | https://onccg.com/api/v1 |
|---|---|
| 请求方式 | GET |
| 认证方式 | URL 参数 key(授权码) |
| 响应格式 | JSON |
API 仅对有效订阅用户开放,配额按订阅计划计算,与网站解析规则一致。
支持平台
API 与网站解析能力一致,共支持 500+ 平台。只需传入作品链接,系统会按域名自动选择解析线路,无需手动指定平台。
自动识别规则
| 链接特征 | 解析线路 | 说明 |
|---|---|---|
instagram.com | Instagram 专线 | 帖子、Reels、Stories、IGTV、图集 |
youtube.com / youtu.be | YouTube 专线 | 普通视频、Shorts、多清晰度 |
| 其他平台链接 | 通用解析线路 | 覆盖下方列出的主流平台及更多站点 |
国内平台
快手小红书微博哔哩哔哩西瓜视频皮皮虾微视最右全民K歌好看视频梨视频美拍秒拍火山小视频开眼小咖秀Vue Vlog陌陌比心
海外社交 / 短视频
TikTokX (Twitter)FacebookThreadsSnapchatPinterestRedditTumblrLinkedInLikeeKwaiTriller
海外视频 / 直播
VimeoTwitchDailymotionAfreecaTVNiconicoRumbleStreamableVidyard
AI 创作 / 其他
豆包 AI即梦 AI视频号更多站点…
以上为常用平台示例,实际支持范围更广。若某个链接暂时无法解析,可能是平台规则变更或作品权限限制,可稍后重试或更换链接测试。
1. 解析接口
GET
/api/v1/parse请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 授权码(API Key) |
url | 是 | 待解析的作品链接,需 URL 编码 |
平台识别
无需在请求中指定平台,系统会根据链接域名自动分流。完整支持列表见上方「支持平台」章节。
请求示例
curl "https://onccg.com/api/v1/parse?key=你的授权码&url=https%3A%2F%2Fv.douyin.com%2Fxxxxx%2F"
成功响应
{
"code": 200,
"message": "success",
"data": {
"platform": "general",
"title": "视频标题",
"type": "video",
"cover": "https://...",
"videoUrl": "https://...",
"videos": [
{
"video": "https://...",
"quality": "HD"
}
],
"images": []
}
}
videoUrl 为上游返回的主视频地址;videos 对应上游 videodata,保留清晰度等字段。type 可能为 video、images、mixed。
2. 配额查询
GET
/api/v1/quota请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 授权码(API Key) |
请求示例
curl "https://onccg.com/api/v1/quota?key=你的授权码"
成功响应(订阅用户示例)
{
"code": 200,
"message": "success",
"data": {
"type": "subscription",
"plan_type": "monthly",
"remaining_quota": 1000,
"daily_limit": 100,
"today_usage": 3,
"daily_remaining": 97,
"expires_at": "2026-08-01 12:00:00"
}
}
错误码
| code | 说明 |
|---|---|
| 200 | 成功 |
| 40001 | API Key 无效或缺失 |
| 40002 | URL 参数缺失或格式无效 |
| 40301 | 订阅配额不足或今日次数已达上限 |
| 40302 | 非订阅用户或订阅已失效 |
| 42901 | 请求过于频繁 |
| 50001 | 解析失败 |
| 50002 | 上游解析服务异常 |
使用说明
- API 仅支持有效订阅用户,免费用户无法调用。
- 解析成功与失败均会计入订阅配额,与网站解析规则相同。
- 请妥善保管授权码,泄露后可在本页重置。
- 链接请勿包含中文或空格,建议使用 URL 编码后的完整地址。