# 极数本源 — LLM 完整知识库
> 一个 Key，连接所有可能。
本文件是 极数本源 平台 **全部 82 个公开 API 的完整文档**，
针对 LLM 一次性 fetch / RAG 嵌入而优化。每个接口都包含：完整参数表、响应字段、
错误码、变更日志、以及 5 种主流语言（cURL / Python / JavaScript / Go / PHP）的可运行示例。
- 平台入口：https://apizero.cn
- 接口网关：https://v1.apizero.cn
- 申请 API Key：https://apizero.cn/account/keys
- 接口索引（简版）：https://apizero.cn/aidocs/llms.txt
- OpenAPI 规范：https://apizero.cn/openapi.json
- 人工友好商城：https://apizero.cn/marketplace
## 平台说明
极数本源 是面向开发者的「API 聚合调用平台」。开发者**只需一个 API Key**，
即可调用本文档列出的全部接口（IP 查询、天气、翻译、AI 生图、内容审核、身份核验、
手机号归属地、视频解析等）。平台统一负责：
- **统一鉴权**：所有接口共用同一个 `X-Api-Key` 头或 `?key=` 参数
- **统一计费**：点数（积分）制，自动从账户余额扣减；不需要为每家上游单独充值
- **统一限流**：基于 QPS 与每日额度，触发限流时返回 `code: 4029` / `4030`
- **统一错误码**：见每个接口的「错误码」表，跨接口语义一致
- **多上游容灾**：核心接口默认配置主源 + 备用源，主源不可用时自动切换
- **免费额度**：未登录每 IP 每天默认有少量免费额度；登录账号每接口每日 5-50 次免费
**与直连官方 API 的核心差异**：免去逐个上游对接、维护多个 Key、各家计费方式不同、
各家限流策略不同、统计跨接口调用量等运维成本。
## 接口分类
- **生活服务** (`life`) — 23 个接口；天气、节假日、快递
- **金融数据** (`finance`) — 5 个接口；汇率、股票、加密币
- **AI 能力** (`ai`) — 6 个接口；对话、图像、识别
- **地理位置** (`geo`) — 3 个接口；IP、行政区、距离
- **身份核验** (`kyc`) — 5 个接口；实名、银行卡、企业
- **内容娱乐** (`content`) — 17 个接口；图片、音乐、一言
- **开发工具** (`dev`) — 23 个接口；二维码、短链、IP
## 全部接口文档
> 以下每一段都是一个独立的、可直接喂给 LLM 的完整接口说明。
---
## 1. 全平台视频元数据解析服务 `video-parse`
> ```
全平台视频元数据解析服务 — 专业、合规、稳定
## 服务概述
本服务通过 RESTful API 形式，将用户已能合法访问的视频/图集分享链接，
解析为结构化的元数据信息（标题、封面、作者、原始 URL 等），
便于开发者集成到内容审核、个人备份、学术研究、数据迁移等场景。
## 核心能力
- **覆盖广**：国内主流平台全覆盖（抖音、小红书、哔哩哔哩、快手、微博、
皮皮虾、最右、贴吧、即梦、可灵 AI 等），海外平台 5 站智能路由
（YouTube、Vimeo、Twitter 等通过 yt-dlp 兜底）
- **响应快**：智能缓存 + 多通道竞速，平均响应 1.3 秒，QPS 可达 15
- **稳定性**：99.7% 月度可用性（含失败重试与自动降级）
- **合规优先**：
· 强制在每个响应中返回 source 来源标注字段
· 不存储任何原始视频/图片内容
· 完善的 DMCA 侵权处理通道（24 小时响应）
· 90 天日志保留期，超期自动清理
## 适用场景
✅ 个人内容备份（用户备份自己发布或合法授权的内容）
✅ MCN 机构内容审核（对委托发布的内容进行合规审查）
✅ 学术研究（高校研究机构的传播规律分析）
✅ 合法范围内的市场数据聚合分析
✅ 用户在自有多账号间的内容迁移
## 严禁用途（违反者立即终止服务且不予退款）
❌ 公开传播、二次发布他人受版权保护的内容
❌ 集成到视频下载站、聚合下载工具等以下载为主功能的产品
❌ 大规模爬取、自动化抓取
❌ 用于侵犯他人著作权、肖像权、隐私权的任何用途
❌ 二次商业转售本服务的解析结果
## 调用即同意《用户协议与免责声明》
完整协议：如下免责申明
侵权投诉：1790643379@qq.com
```
- **接口地址**: `https://v1.apizero.cn/api/video-parse`
- **请求方法**: `GET`
- **分类**: content
- **计费**: 按次付费 · 月套餐 · 单次 0 积分
- **QPS**: 3 / s
- **每日免费额度**: 20 次（登录用户）· 5 次（匿名）
- **文档链接**: https://apizero.cn/aidocs/video-parse · 完整 Markdown: https://apizero.cn/aidocs/video-parse/raw.md
**认证**: 匿名每日 5次、QPS 1；登录用户每日 20次、QPS 3（全部免费）。命中 5 分钟缓存不计入配额。
### 请求参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `url` | `string` | 是 | 待解析的视频/图文链接。支持完整 URL 或分享短链（如 v.douyin.com/xxx、vm.tiktok.com/xxx）。最大 2048 字符 | `https://www.bilibili.com/video/BV1gY411A7y7` |
### 调用示例
**cURL**:
```bash
curl "https://v1.apizero.cn/api/video-parse?url=https%3A%2F%2Fwww.bilibili.com%2Fvideo%2FBV1gY411A7y7&key=YOUR_API_KEY"
```
**Python**:
```python
import requests
resp = requests.get(
"https://v1.apizero.cn/api/video-parse",
params={
"url": "https://www.bilibili.com/video/BV1gY411A7y7",
"key": "YOUR_API_KEY",
},
timeout=15,
)
resp.raise_for_status()
print(resp.json())
```
**JavaScript (Node.js)**:
```javascript
// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
"url": "https://www.bilibili.com/video/BV1gY411A7y7",
"key": "YOUR_API_KEY",
});
const res = await fetch(`https://v1.apizero.cn/api/video-parse?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
```
**Go**:
```go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/video-parse", nil)
q := req.URL.Query()
q.Set("url", "https://www.bilibili.com/video/BV1gY411A7y7")
q.Set("key", "YOUR_API_KEY")
req.URL.RawQuery = q.Encode()
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
```
**PHP**:
```php
"https://www.bilibili.com/video/BV1gY411A7y7",
"key" => "YOUR_API_KEY",
]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data);
```
### 响应字段
| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `code` | `number` | 上游业务状态码（200=成功；400/500=解析失败，详见 message） | — |
| `platform` | `string` | 识别到的平台标识（如 douyin / kuaishou / tiktok / youtube / bilibili ...） | — |
| `type` | `string` | 内容类型（视频 / 图集） | — |
| `message` | `string` | 错误说明（仅失败时有；已对敏感信息脱敏） | — |
| `data.title` | `string` | 视频/笔记标题 | — |
| `data.video_url` | `string` | 默认清晰度视频直链（可直接用于