# 极数本源

> 一个 Key，连接所有可能。

极数本源 是聚合多个公开 API 的统一调用平台。开发者通过单一 API Key 即可调用 71+ 个接口，统一鉴权、计费、限流。

## API 接入文档

每个 API 都有独立的完整文档页，AI 可读：

- 索引：https://apizero.cn/aidocs
- 单接口 HTML：https://apizero.cn/aidocs/{api_id}
- 单接口 Markdown：https://apizero.cn/aidocs/{api_id}/raw.md

## 全部接口

- [商品条码查询(GS1中国)](https://apizero.cn/aidocs/barcode-gs1/raw.md): `GET` — 官方权威的商品条码查询接口，数据直通中国物品编码中心(GS1 China)官方注册数据库。

【数据源升级 · 2026-05】当前以中国编码官方 APP (ancc.org.cn) 为主源，多源兜底（chinatrace / gds-bff / cnaidc），三级缓存设计（Redis 24h → MySQL 永久库 → 上游 API），高频查询的条码自动周期性回源刷新，数据时效性进一步优化。

与 `barcode-lookup` 定位不同：
- 本接口**官方权威**：返回厂商注册名称、产品登记信息、上市日期、官方商品图等可追溯的官方数据
- 本接口**仅覆盖国内注册条码**(6/690 开头)，进口商品或非注册条码会返回 found=false
- 适合合规核验、溯源、上架审核等对数据权威性要求高的场景

支持输入格式：8 / 12 / 13 / 14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14。

返回数据包含：产品名称、品牌、通用名、分类（含分类编号）、规格、净含量、上市日期、厂商企业名、官方商品图、条码激活日期、产品创建日期、企业注册日期、已用天数等核心字段，部分情况下额外提供生产国、企业地址、参考售价、厂商识别代码等扩展字段。
- [聚合短视频解析PRO](https://apizero.cn/aidocs/video-parse/raw.md): `GET` — 聚合短视频解析，一个接口覆盖国内外主流视频平台，自动去水印、返回直链 + 多清晰度。

• **国内平台**：抖音 / 快手 / 小红书 / B 站 / 微博 / 皮皮虾 / 西瓜视频 / 好看视频 / 最右 / 全民 K 歌 等
• **海外平台**：TikTok / YouTube（含 Shorts）/ Instagram（Reel/Post）/ Twitter(X) / Facebook
• **智能路由**：海外 5 站自动走海外节点，国内域名走国内节点，无需用户关心
• **完整直链**：返回原画 / 1080P / 720P / 480P / 360P 等多档直链，前端可自由选择
• **元数据齐全**：作者 / 头像 / 点赞 / 评论 / 播放量 / 发布时间等
• **图集支持**：小红书图集 / Instagram 多图 Reel 返回 imagelist 数组
• **5 分钟短缓存**：视频 CDN URL 带过期时间戳，短缓存兼顾去重和链接鲜度
- [百度热搜榜](https://apizero.cn/aidocs/hot-baidu/raw.md): `GET` — 聚合百度搜索热榜数据，实时返回 4 大榜单的 Top 30~50 条热门内容。零成本调用，适合做内容聚合 / 热点追踪 / 资讯类产品。

【支持榜单】
- realtime（实时热搜）· 默认值，约 30~50 条
- novel（小说）· 约 30 条，含作者
- movie（电影）· 约 10 条，含类型
- tv（电视剧）· 约 10 条，含演员

【返回字段】
- rank · 榜单排名
- title · 标题
- desc · 简短描述
- hot_index · 热度指数（数字）
- link · 详情链接（百度搜索）
- image · 配图 URL（直接可用，无防盗链限制）
- tag · 标签（如「热」「新」「沸」「爆」）
- author / category / actors · 小说 / 电影 / 电视剧专属字段

【典型场景】
- 资讯类 App 的"今日热点"模块
- AI 写作助手的"实时热点选题"参考
- 数据看板 / 大屏展示
- 微信公众号选题辅助
- 热搜监控 / 舆情分析

【调用示例】
GET /api/hot-baidu                  · 默认实时热搜
GET /api/hot-baidu?tab=realtime
GET /api/hot-baidu?tab=novel
GET /api/hot-baidu?tab=movie
GET /api/hot-baidu?tab=tv

【性能与缓存】
- 平均响应 200ms（缓存命中时 < 50ms）
- 后端 60 秒缓存（百度榜单本身分钟级更新，短缓存合理且节省调用方资源）

【⚠️ 数据来源说明】
本接口数据来源于百度搜索热榜公开页面（top.baidu.com），仅用于个人开发测试与小规模商业场景；如需大规模商业使用建议自建抓取或采购官方 API。
- [IP 地址查询（街道级）](https://apizero.cn/aidocs/ip-pro/raw.md): `GET` — 提供 IP 地址的街道级归属查询，精度可达乡镇街道一级。

相比普通国家/城市级 IP 库，本接口返回 25+ 个字段：省市区街道四级行政 + 多备选街道、经纬度、海拔、邮编、区号、行政区划代码、ISP 运营商、气象站编码、IANA 时区，以及完整的代理/风险评分（是否代理、代理概率、代理类型、真实用户率、移动流量率、风险等级、风险评分、风险标签）。

典型场景：反欺诈与风控、精准营销与广告投放、门店 LBS 分布分析、物流与配送区域匹配、区域合规访问控制、日志 BI 地理回填。

支持 IPv4 与 IPv6。边缘缓存 12 小时，命中时延迟 <10ms；未命中时约 200–500ms。
- [王者战力查询](https://apizero.cn/aidocs/wzry/raw.md): `GET` — 王者荣耀全国战力查询，一接口聚合「英雄列表 + 区服战力分布」2 大功能。

• action=heroes — 返回 130+ 个英雄完整目录（中文名 / ename / 称号 / 头像 URL），优先腾讯官方源 https://pvp.qq.com/web201605/js/herolist.json，失败自动降级 yxsaoma.com

• action=query — 查询某英雄在某区服的全国战力分布数据，返回 90 条左右的省市区战力榜（含同地区相近排名）

支持 4 大区服：
  · aqq = Android QQ
  · awx = Android 微信
  · iqq = iOS QQ
  · iwx = iOS 微信

查询类型：
  · all = 完整 heroList（按 level 混合排列，约 90 项）
  · min = 各级（省/市/区）最低战力 + 相近排名（rank ≤ +100）
  · max = 各级（省/市/区）最高战力 + 相近排名

上游签名（warzoneSignKey20240515 + MD5 + timestamp）已在网关侧自动处理，调用方无需关心。英雄列表缓存 24 小时，战力数据缓存 1 小时。
- [聚合翻译](https://apizero.cn/aidocs/aggregate-translate/raw.md): `POST` — 聚合 DeepL / 腾讯 / 有道三大引擎的多语言翻译，可指定单一引擎或自动选优；支持 platform=all 模式同时返回所有引擎结果用于对比。三个 action：translate（翻译，默认）/ engines（引擎列表）/ languages（语言列表）。支持 12 种语言互译。
- [商品条码查询](https://apizero.cn/aidocs/barcode-lookup/raw.md): `GET` — 通过商品条形码（EAN-13 / UPC-A / UPC-E / EAN-8）一键查询商品信息，覆盖国内日常消费品超千万 SKU，包括食品饮料、日用百货、个护美妆、酒水烟草、母婴用品等。

【核心字段】
- name 商品名称
- brand 品牌
- manufacturer 生产厂商 / 经销商
- spec 规格（如 550ml / 250g / 6 听装）
- price 参考价（人民币元，仅作参考非实时市场价）
- image 商品图片 URL（自有 CDN 代理，跨域友好）

【典型场景】
- 电商 / 零售 ERP：扫码录入商品自动补全字段
- 个人记账 App：扫码识物展示购物明细
- 物流仓储：条码核销 + 商品图展示
- 自动售货机：条码识别后获取商品名称
- 营销活动：用户扫码核销福利时验证商品

【调用示例】
GET /api/barcode-lookup?barcode=6921168509256

【特别说明】
- 平均响应 100ms（不含图片下载）
- 国内主流商品（农夫山泉、可口可乐、康师傅、伊利等）覆盖率 > 95%
- 个别冷门 / 新上市 SKU 可能未收录，此时 found=false
- price 字段仅作参考，非各电商平台实时价格
- image 字段始终返回有效 URL（接图片 onError 即可降级到默认图标）

【⚠️ 注意】
图片资源为公开懒加载代理，不计入接口调用次数；商品文本数据为按次计费。
- [DNS 劫持检测](https://apizero.cn/aidocs/dns-check/raw.md): `GET` — 通过 4 家公共 DoH（DNS over HTTPS）服务器并发查询同一域名，对比解析结果检测 DNS 是否被运营商劫持、终端 hosts 篡改或遭遇异常 GeoDNS 分流。

服务器列表：
  • AliDNS（阿里云 - 中国）
  • DNSPod（腾讯 - 中国）
  • 360 安全 DNS（中国）
  • Cloudflare（美国 - 在中国大陆服务器侧可能超时，会被标记为 timeout）

特性：
  • A + AAAA 记录同时查询（IPv4 / IPv6）
  • 提取 CNAME 链路（CDN 跳转可见）
  • TTL 信息汇总（缓存提示）
  • 智能风险分级算法：safe / safe_with_geodns / suspicious / hijack_likely / unknown
  • 支持各类输入：domain / https://domain / domain:port / domain/path（自动剥离）
- [中文地址解析](https://apizero.cn/aidocs/address-parse/raw.md): `POST` — 一行 API 从中文地址字符串中提取「省市区街道 + 详细地址 + 姓名 + 手机号 + 邮编」。

适用场景：电商收货地址自动拆分、快递下单页智能填充、CRM 客户资料清洗、办公地址结构化入库。

特点：纯本地正则算法，无任何上游依赖，毫秒级响应；支持 34 个省级行政区及其简称识别（如「北京」→「北京市」、「新疆」→「新疆维吾尔自治区」）；支持快递场景下「张三 138xxxxxxxx 上海市浦东新区xx路xx号 200000」这类混合输入的自动拆分。
- [哈希加密计算](https://apizero.cn/aidocs/hash/raw.md): `GET` — 哈希加密计算，支持 12 种主流算法，可一次性返回全部，也可指定单个算法。支持 HMAC 签名模式与 hex / base64 双输出编码，毫秒级返回。

• 通用摘要：MD5、SHA-1、SHA-256、SHA-384、SHA-512

• 现代抗碰撞：SHA3-256、SHA3-512、RIPEMD-160、Whirlpool

• 校验和：CRC32、CRC32B、Adler-32

• HMAC 签名：传入 hmac_key 自动切换为 HMAC 模式（用于 API 签名 / 防篡改场景）

• 输出编码：hex（默认，更可读）/ base64（节省 25% 字节，适合 URL 传输）

纯本地计算，零外部上游依赖，毫秒级响应。HMAC 密钥仅参与计算，不写日志、不缓存、不回显。
- [邮箱地址检测](https://apizero.cn/aidocs/email-check/raw.md): `GET` — 综合性邮箱质量评估接口，一次请求完成 6 项检测：
  ① RFC 5322 格式校验
  ② 临时/一次性邮箱检测（基于 72,345 条开源域名库，3 个数据源合并去重）
  ③ MX 记录验证（用 AliDNS DoH，避开 PHP getmxrr 不稳定）
  ④ 拼写纠正（gmial.com → 提示 gmail.com）
  ⑤ 服务商识别（QQ邮箱/Gmail/网易/Outlook 等 40+ 主流邮箱）
  ⑥ 综合风险评分 0-100，附详细原因清单

典型用例：用户注册时的反垃圾邮箱过滤、邮件营销列表清洗、KYC 风控辅助。
- [疯狂星期四文案](https://apizero.cn/aidocs/crazy-thursday/raw.md): `GET` — 随机返回一段脑洞大开的 KFC「疯狂星期四」文学。内置 52 条精选文案，覆盖情感/搞笑/职场/文艺/学术/古风/悬疑/科幻/鸡汤/日常 10 个分类。支持随机、批量、分类列表与疯四倒计时。
- [内容审核](https://apizero.cn/aidocs/content-moderation/raw.md): `POST` — 基于「敏感词库 + 正则规则 + AI 特征评分」三重策略检测文本中的色情 / 政治 / 广告 / 联系方式 / 引流 / 谩骂 6 大类敏感内容。识别变体绕过（谐音、拼音、符号替换），输出 safe/low/medium/high 风险等级，可选自动脱敏。
- [增值税发票识别](https://apizero.cn/aidocs/invoice/raw.md): `POST` — 增值税发票 OCR 识别，支持增值税专用发票、普通发票、电子普票，输出 22+ 个结构化字段。

• 双输入模式：
  - input_type=url：传入公网可访问的图片 URL（http/https）
  - input_type=base64：传入 base64 编码字符串（≤6MB，自动剥离 data:image/...;base64, 前缀）

• 完整识别字段：
  - 发票基本：发票名称、代码、号码、开票日期、校验码、机器编号
  - 金额：价税合计、税额、不含税金额、大写金额
  - 购销方：名称、纳税人识别号、地址电话、开户行账号
  - 经办人：收款人、复核人、开票人
  - 商品明细：items 数组，含品名/规格/数量/单价/金额/税率/税额
  - 备注与盖章信息

• OCR 结果缓存 1 小时（同图同结果），减少重复调用消耗。
- [TTS 语音合成](https://apizero.cn/aidocs/tts/raw.md): `POST` — 对接 alapi.cn 文本转语音（TTS）服务，输入文本返回 base64 编码的 MP3 音频。

• **5 种音色**：女声主播 / 男声主播 / 男声说唱 / 女声四川话 / 男声低沉
• **500 字以内**：单次请求最多 500 字符（中英文均按 1 字符计）
• **MP3 格式**：上游返回 audio/mpeg 编码，前端可直接 `<audio src="data:audio/mpeg;base64,...">` 播放
• **便利字段**：返回 audio_data_url（拼好的 data URL）+ audio_size_bytes（解码后字节数）+ audio_format / audio_mime
• **典型场景**：新闻播报 / 短视频配音 / 有声书 / 语音通知 / 客服 IVR
• **不缓存**：500 字音频约 1MB，重复合成概率低，避免 Redis 内存膨胀
- [CDN 优选 IP](https://apizero.cn/aidocs/cdn-ips/raw.md): `GET` — 获取主流 CDN 服务商的官方公网 IP 段（CIDR）列表。当前支持 CloudFlare、AWS CloudFront、Gcore 三家，覆盖 IPv4 与 IPv6。常用于 CDN 优选、反向代理、流量分流、防火墙白名单等运维场景。
- [ICP 备案查询](https://apizero.cn/aidocs/icp/raw.md): `GET` — 通过域名查询工信部 ICP 备案信息，返回备案号、网站名称、主办单位、单位性质（企业/个人/事业单位等）和审核通过时间。

• 自动域名清洗：自动剥离 https?:// 协议、/path 路径、:port 端口、www. 前缀，无论传入 https://www.baidu.com/abc 还是 baidu.com 都正确识别

• 已备案 → is_filed=true，返回完整 6 字段；未备案/境外/已注销 → is_filed=false，返回空字段（非错误，便于前端 if 判断）

• 缓存策略：已备案 24 小时缓存（变更频率低），未备案 1 小时缓存（避免新备案被长期误判）
- [彩云天气](https://apizero.cn/aidocs/weather/raw.md): `GET` — 基于彩云天气 v2.6 的全功能天气接口，覆盖：
  • 实时天气（温度/湿度/风/能见度/AQI/PM2.5）
  • 分钟级降水预报（未来 2 小时）
  • 小时预报（最长 360 小时 = 15 天）
  • 天预报（最长 15 天，含日出日落、温度极值、生活指数）
  • 综合数据（一次返回全部 + 气象预警）

特色：
  • 支持城市名直接查询（内置 ~140 个常用中国城市表 + Open-Meteo 兜底，无需高德/百度 Key）
  • 自动中文化：skycon 转中文、风向转 16 方位、风速转蒲福风级、AQI 转等级颜色
  • 预警标准化：从原始 title 提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重）
  • 顶层 summary 字段提供"一眼看懂"的实时摘要
- [本草纲目·中药查询](https://apizero.cn/aidocs/bencao/raw.md): `GET` — 传统中药材知识查询接口，覆盖《本草纲目》及常见中药材数据。输入药材名称（如「人参」「丁香」「甘草」「枸杞」），返回该药材的释名、气味、主治、附方等详细记载。

【典型场景】
- 中医养生 / 食疗 App 的药材百科
- 中药知识科普类小程序
- AI 中医问诊辅助参考
- 古籍数字化项目
- 国学 / 中医文化教学

【调用示例】
GET /api/bencao?msg=人参
GET /api/bencao?msg=丁香
GET /api/bencao?msg=甘草

【模糊匹配】
- 精确名称查得到 → 直接返回详情（matched=exact）
- 找不到时返回 4040 + suggestions 数组（最多 10 个相关建议）
- 比如查「人参枸杞」会建议「人参、枸杞」等单味药

【⚠️ 数据来源说明】
本接口数据整理自《本草纲目》及网络公开整理资料，仅供学习参考；中医药疗用请遵医嘱。
- [代码美化图片](https://apizero.cn/aidocs/code-beautify/raw.md): `POST` — 将代码片段渲染为精美的SVG/PNG卡片图片。支持16种编程语言语法高亮、8套设计主题，适合社交分享和技术文档配图。
- [文本翻译](https://apizero.cn/aidocs/translate/raw.md): `POST` — 对接腾讯云 TMT（机器翻译）通用版，支持 18 种语言互译，自动检测源语言。

• **18 种语言**：中文 / 繁体中文 / 英文 / 日语 / 韩语 / 法语 / 西语 / 意语 / 德语 / 土语 / 俄语 / 葡语 / 越南语 / 印尼语 / 泰语 / 马来语 / 阿拉伯语 / 印地语
• **多种参数形式**：from/to 同时支持中文名（「英文」）和语言代码（「en」），auto / 自动检测 / 自动 / 空字符串均视为自动
• **检测增强**：auto 模式下额外返回 detected_language（如 fr）+ detected_name（如 法语），便于前端展示「检测到法语」
• **缓存命中提速**：相同文本+方向 24h 缓存（按 sha256 哈希），命中只需 ~150ms 不计入上游配额
• **错误码细分**：上游 InvalidParameter / TextTooLong / 不支持语种 等映射为 4000 客户端错误，便于前端区分提示
- [基金估值跟踪](https://apizero.cn/aidocs/fund/raw.md): `GET` — 基金估值跟踪，一接口聚合「基金实时估值 / 指数行情 / 基金详情 / 全部常用指数批量」4 大功能，覆盖国内基金 + A 股核心指数。

基于天天基金、新浪财经、东方财富三路上游，无需注册即可调用：

• action=estimate — 基金实时估值（盘中每分钟更新，含单位净值、估算净值、估算涨跌幅、上次净值日期）

• action=index — 单个指数行情（新浪主、东方财富备双通道容灾，含当前点位、涨跌点、涨跌幅）

• action=info — 基金详细信息（名称、净值、累计净值、近 1 月/3 月/6 月/1 年/3 年/成立来收益、基金类型、风险等级、规模、基金经理、成立日、管理人）

• action=indices — 6 个常用指数批量（上证、深证成指、创业板、上证 50、沪深 300、中证 500）

本接口已修复源码中「新浪通道缺 sh/sz 前缀」的 bug，并优化了 HTML 爬虫的容错。
- [黄金价格查询](https://apizero.cn/aidocs/gold/raw.md): `GET` — 实时黄金价格聚合查询，一次返回三大维度的金价数据：

• 国际黄金报价（4 项）：国际金价、国际铂金、国际银价、国际钯金，含最新价 / 涨跌额 / 涨跌幅 / 最高价 / 最低价 / 报价时间

• 国内黄金报价（7 项）：国内金价、国内银价、投资金条、黄金回收价格、铂金回收价格、18K 金回收价格、钯金回收价格

• 十大品牌金店金价（17 家）：内地周大福、周生生、六福珠宝、老凤祥、老庙黄金、中国黄金、周六福、菜百、明牌珠宝、潮宏基等十大品牌的当日黄金 / 铂金 / 金条价格（元/克）

通过参数 type 可只取某一类（all=全部，brand=品牌金店，international=国际，domestic=国内）。

基于 huangjinjiage.cn 数据源，已修复源码 GBK 编码乱码 bug，内建 10 分钟缓存。
- [DNS 记录查询](https://apizero.cn/aidocs/dns-query/raw.md): `GET` — 查询域名的各类 DNS 记录，支持 A / AAAA / NS / CNAME / MX / TXT / CAA / SOA 共 8 种标准类型，以及 ANY（一次返回所有类型）。

✨ 特色：
  • 不依赖第三方工具站，完全自建 — 3 家国内 DoH 并发（AliDNS / DNSPod / 360）
  • 所有记录结构化解析：MX 拆 priority/exchange、CAA 拆 flags/tag/value、SOA 拆 mname/serial/...
  • 多家结果合并去重 + 各记录标注来自哪些 DoH（sources 字段）
  • 兼容数字 qtype（如 1=A / 15=MX / 257=CAA），不破坏旧调用方式
  • ANY 模式：单次请求拿到域名的全部 DNS 配置，免去多次查询
- [今日油价](https://apizero.cn/aidocs/oil-price-forecast/raw.md): `GET` — 提供 32 省份基准油价（92/95/98 号汽油 + 0 号柴油），并基于新浪财经国际原油（WTI、布伦特）实时走势，预测下一次国内调价方向（涨/跌/搁浅）和幅度。附带 2025-2026 年完整调价窗口日历。
- [实时汇率查询](https://apizero.cn/aidocs/exchange-rate/raw.md): `GET` — 实时汇率查询，支持 26 种主流货币（CNY/USD/EUR/GBP/JPY 等）一键互转。数据 1 分钟级更新，毫秒响应，免费且无需注册即可调用。

基于 ALAPI 汇率源，覆盖人民币、美元、欧元、英镑、日元、港币、韩元、澳元、加元、新加坡元、瑞士法郎、新台币、泰铢、马来西亚林吉特、俄罗斯卢布、印度卢比、巴西雷亚尔、南非兰特、新西兰元、瑞典/挪威/丹麦克朗、菲律宾比索、印尼盾、越南盾、阿联酋迪拉姆等。

支持「同币种快路径」（from=to 时本地直接返回，0 上游消耗），以及「货币列表查询」action=currencies 子命令（返回支持的全部 26 种货币代码与中文名）。
- [随机壁纸](https://apizero.cn/aidocs/wallpaper/raw.md): `GET` — 对接 360 公开壁纸库，16 个分类 × 7 种分辨率（含 1920×1080 原图）随机壁纸。

• **16 个分类**：美女 / 风景 / 游戏 / 影视 / 时尚 / 明星 / 汽车 / 萌宠 / 清新 / 体育 / 萌娃 / 军事 / 动漫 / 日历 / 爱情 / 格言
• **7 种分辨率**：1920×1080（原图）/ 1600×900 / 1440×900 / 1366×768 / 1280×800 / 1280×1024 / 1024×768
• **修复源码 BUG**：源码注释默认 1920×1080 但代码默认 1600×900 且 resMap 缺 1920×1080 → 现已用上游 url 字段返回真正 1920×1080 原图
• **修复源码 BUG**：源码 tag 字段返回内部标记（如 `_category_海洋天堂_`）不可读 → 现已拆分 utag 输出为 tags 数组（如 `['海洋天堂','日出东方','松树','海岛']`）
• **修复源码 BUG**：上游图片 URL 是 http:// → 现已强制改写为 https://，避免 HTTPS 站点混合内容警告
• **缓存优化**：上游响应按 (cid, start_bucket) 缓存 1h，shuffle 在本地做，**节省 80% 上游请求同时保证随机性**
• **典型场景**：登录页背景 / 桌面壁纸应用 / 文章封面图 / 小程序首页轮播
- [一言（简版）](https://apizero.cn/aidocs/yiyan/raw.md): `GET` — hitokoto 的精简版：纯文本随机一句，不带分类/出处。同时支持 format=text 直接返回纯文本（适合站点页脚、小程序欢迎语等装饰场景）。
- [文本相似度](https://apizero.cn/aidocs/text-similarity/raw.md): `POST` — 纯本地计算的文本相似度比对，输入两段文本（每段 ≤ 5000 字）输出 4 种相似度指标 + 加权综合评分 + 5 级评级。

• **零延迟零成本**：纯 PHP 本地计算，无外部上游依赖，平均响应 < 100ms
• **4 种指标**：余弦相似度（35%）+ Jaccard 系数（25%）+ 编辑距离归一化（20%）+ LCS 比率（20%）
• **5 级评级**：几乎相同 / 高度相似 / 中度相似 / 轻度相似 / 差异较大
• **修复源码 bug**：自实现 mb_levenshtein 字符级编辑距离，杜绝 PHP 内置 levenshtein 按字节计算导致的 85 汉字崩溃问题
• **超长保护**：超过 500 字符自动截取并按比例还原，5000×5000 字符比对约 60-80ms
• **典型场景**：评论查重、AI 生成内容检测、多语言翻译质量评估、客服话术匹配
- [快递物流查询](https://apizero.cn/aidocs/express/raw.md): `GET` — 快递物流查询，支持顺丰、圆通、中通、申通、韵达、极兔、京东、EMS 等 100+ 主流快递公司，自动识别单号所属公司，返回完整物流轨迹。

基于 ALAPI 物流源，覆盖国内全部主流快递。支持「自动识别」（不传 com 参数即可）和「手动指定公司编码」两种模式。顺丰、中通因隐私保护需求，必须传手机号后 4 位（参数 phone）。

返回字段包含：单号、快递公司编码、公司中文名、状态码（0=未查到, 1=已揽收, 2=在途, 3=签收, 4=问题件）、状态描述、完整物流轨迹（按时间倒序，包含每条轨迹的时间和文字描述）。

建议前端轮询频率不超过每分钟 1 次，本接口已内建 5 分钟缓存以节省调用次数。
- [手机号归属地](https://apizero.cn/aidocs/mobile/raw.md): `GET` — 通过 11 位中国大陆手机号查询归属省份/城市与运营商，支持移动/联通/电信主流号段及虚拟运营商号段（170/171/174 等）。

• 严格 11 位手机号校验：`^1[3-9]\d{9}$`，非法号码直接返回 4000
• 双形态响应：查询成功 → is_found=true 含 province/carrier；号段未收录 → is_found=false 字段为空（非错误，前端可直接 if 判断）
• 缓存策略：成功结果 7 天（号段分配静态稳定）；未查询到 1 小时（避免长期误判新放号段）
• 隐私保护：错误日志中手机号自动脱敏（138****0000）
- [SSL 证书检测](https://apizero.cn/aidocs/ssl/raw.md): `GET` — 通过域名远程探测其 HTTPS/SSL 证书信息：颁发者、颁发机构、签名算法、覆盖域名、有效期、是否过期、距过期天数、SHA-1 指纹、远端 IP 等。

• 智能预处理：自动剥离 http(s):// 前缀、路径、查询串、端口、www. 子域
• 严格域名校验：合法域名格式（最长 253 字符 + RFC 1123 标签规则）才打上游
• 三态响应：有 SSL（is_ssl=true）→ 完整信息；无 SSL/连接失败 → is_ssl=false 其余字段 null；上游异常 → 502
• 字段标准化：上游 null 字段透传 null 不补 0；自动转 int/string 类型；is_expire 重命名 is_expired
• 缓存策略：成功 6h（证书短期不变）；无证书 30min（避免错误域名反复打上游）
- [Whois 域名查询](https://apizero.cn/aidocs/whois/raw.md): `GET` — 对接 whoiscx.com 上游，查询域名注册信息（注册商 / 注册主体 / 创建时间 / 到期时间 / DNS 服务器 / 域名状态 / DNSSEC 等）。

• **支持所有主流 TLD**：.com / .cn / .net / .org / .io / .me / .top / .xyz 等几乎所有 ICANN 认证后缀
• **自动归一化**：传入 `https://www.baidu.com/abc` 会自动剥离为 `baidu.com`
• **域名可用性检测**：未注册域名返回 is_available=true，可用于域名抢注前查询
• **到期告警**：30 天内到期返回 expiring_soon=true，便于前端高亮提示
• **域龄展示**：creation_age_text 返回「N 年 M 月」人类可读字符串
• **国内 .cn 主体中文**：whoiscx 上游对国内域名返回中文注册主体名（如「极数本源（福州）科技有限公司」）
• **缓存 24h**：whois 数据年级变化，全天同一域名查询只调 1 次上游
• **修复源码 BUG**：错误响应字段是 `error` 不是 `message`，源码取错丢失了上游真实错误
- [文本审核](https://apizero.cn/aidocs/text-censor/raw.md): `POST` — 对文本进行多维度违规内容审核，覆盖政治敏感、谩骂、色情、违规广告、暴恐、低俗等类别，返回审核结论 + 命中违规词详情列表。

• 5000 字以内（中英文均按 1 字符计），单次请求审核
• 三态结论：合规（is_compliant=true）/ 不合规（is_compliant=false）/ 疑似（is_suspected=true，需人工复核）
• 详细命中信息：每条违规含 category（类别）/ word（触发词）/ level（等级）/ msg（说明）
• 衍生字段：violations（去重违规词数组）/ violation_categories（命中类别去重）/ violation_count（违规条数），前端可直接展示「触发 X 项违规：政治、谩骂…」
• 隐私保护：缓存 key 用 sha256 哈希，原文不进入 key；错误日志不记录文本内容
- [OCR 文字识别](https://apizero.cn/aidocs/ocr-text/raw.md): `POST` — 通用 OCR 文字识别，从图片中提取任意文字内容（中文/英文/数字/符号/手写体等），返回逐行文本列表 + 完整拼接文本。

• 双输入模式：
  - input_type=url：传入公网可访问的图片 URL（http/https）
  - input_type=base64：传入 base64 编码字符串（≤6MB，自动剥离 data:image/...;base64, 前缀）

• 三路输出：
  - text_list：按原图顺序的逐行文本数组
  - full_text：用换行符 \n 拼接的完整文本字符串
  - text_count：识别到的文本行数

• 适用场景：截图转文字、表格识别、身份证/名片文字提取、字幕识别、笔记 OCR 等通用场景。专用发票识别请用 /api/invoice。

• OCR 结果缓存 1 小时（同图同结果），重复调用不消耗上游配额。
- [限行天气联动](https://apizero.cn/aidocs/traffic-weather-alert/raw.md): `GET` — 输入国内城市拼音（兼容中文），返回当天的限行尾号。如遇暴雨/台风等恶劣天气，附加居家办公建议。覆盖北京、天津、成都、杭州、贵阳、长春 6 个限行城市，天气支持所有国内主要城市。
- [企业工商信息查询](https://apizero.cn/aidocs/company-search/raw.md): `GET` — 通过企业名称关键词查询工商信息，返回前 5 条最匹配结果（按上游评分排序）。覆盖企业全称、法人、注册资本、统一社会信用代码、经营范围、注册地、联系方式等核心字段。数据来自天眼查权威工商数据库，6 小时缓存。
- [QQ 信息](https://apizero.cn/aidocs/qq/raw.md): `GET` — 通过 QQ 号查询昵称、QQ 邮箱、QQ 空间链接，并生成 4 种尺寸的头像直链 URL（s40/s100/s140/s640）。

• 严格 5-11 位数字校验（防上游字符串截断引起的号码错位）
• 安全增强：上游返回的 QQ key 必须与请求严格一致，否则视为未查询到
• 错误兼容：自动识别上游错误响应（_Callback({error:...})）和正常响应（portraitCallBack(...)）
• 编码兜底：腾讯接口历史输出 GBK 含中文昵称时自动转 UTF-8
• 多尺寸头像：avatars 对象内含 s40/s100/s140/s640 四种尺寸 URL，前端 `<img src={data.avatars.s640}>` 直接用
- [八字起名](https://apizero.cn/aidocs/baby-naming/raw.md): `POST` — 输入父母姓氏与出生时间，基于「八字五行 + 五格数理 + 三才配置」综合评分生成高分名字候选，附寓意标签与全国重名预估。三个 action：naming（智能起名）/ duplicate（重名查询）/ bazi（八字查询）。内置 396 姓氏笔画 + 175 起名字 + 88 姓人口。
- [AI 图片变清晰](https://apizero.cn/aidocs/image-enhance/raw.md): `POST` — 基于先进 AI 超分辨率算法的图片高清化服务。输入一张模糊 / 低分辨率图片 URL，约 4 秒内返回 4 倍超分辨率的高清版本（如 300×300 → 1200×1200），支持 JPEG / PNG / WebP / BMP 等主流格式。

【核心能力】
- 4 倍超分辨率（最大边自动放大约 4 倍）
- 自动去噪 / 去糊 / 锐化细节
- 保留原图色彩与构图
- 适合老照片修复、缩略图放大、低质截图增强、网络图片优化
- 输出 JPEG 高质量（HD 模式）

【典型场景】
- 电商：商品低清图自动高清化
- 自媒体：老照片 / 截图修复用于配图
- 设计：素材尺寸不够时快速放大
- 视频缩略图、社交头像高清化
- 旧扫描件 / 截屏文字增强

【调用示例】
POST /api/image-enhance
Content-Type: application/x-www-form-urlencoded

img=https://example.com/your-blurry-image.jpg

【⚠️ 输入限制】
- 必须是 **公网可访问** 的 http/https URL（私有 OSS 链接需先签名）
- 文件大小 ≤ 10 MB
- 支持格式：JPEG / PNG / WebP / BMP

【⚠️ 输出说明】
- 返回的 enhanced_url 为平台代理 URL（自有域名，跨域友好）
- 实际图片在 6 小时内有效，请尽快下载保存
- 平均响应 4~6 秒，复杂图片可能需要 10~30 秒

【计费说明】
登录用户每日 10 次免费体验，超出按点数扣费（详见控制台）。
- [豆包图片生成](https://apizero.cn/aidocs/doubao-image/raw.md): `POST` — 基于字节跳动豆包 Seedream 3.0 大模型的高质量文生图服务，支持中英文混合提示词，平均 3~4 秒出图。

【核心能力】
- 影视级画质：擅长摄影、插画、电影感构图与中文场景理解
- 多种尺寸：方形 1024×1024、宽屏 1792×1024、竖屏 1024×1792 等 6 种主流分辨率
- 中文友好：原生理解中文语意，无需翻译为英文也能精准生成

【适用场景】
- 内容创作：插图、海报、Banner、社交媒体图片
- 营销素材：广告图、商品概念图、宣传背景
- 设计辅助：灵感参考、构图草稿、风格化展示
- 应用集成：聊天机器人配图、自媒体配图、AI 应用接入

【提示词建议】
- 推荐结构：主体 + 风格 + 构图 + 光线 + 氛围
- 示例：「一只赛博朋克猫在雨夜的霓虹街头，低角度，电影感，Wong Kar-Wai 风格」
- 越具体描述效果越好，可以指定材质、镜头、色调、画家风格等
- 建议 prompt 长度控制在 50~300 字符之间

【⚠️ 重要提示】
返回的图片 URL 是字节云 TOS 临时直链，**24 小时后失效**。请务必在有效期内：
- 下载保存到本地
- 或转存到自己的对象存储（阿里 OSS / 腾讯 COS 等）
- 不要长期引用此直链

【计费说明】
- 方形 1024×1024：约 4096 tokens
- 宽屏 1792×1024 / 1080p：约 7168 tokens
- 实际点数扣费请参考下方定价
- [CSDN 博主信息](https://apizero.cn/aidocs/csdn-profile/raw.md): `GET` — 通过 CSDN 用户名查询博主公开档案：昵称、头像、码龄、博客等级、原创数、粉丝数、博客排名、IP 属地、原力等级、勋章列表与成就明细。
- [九宫格切图](https://apizero.cn/aidocs/nine-grid-cutter/raw.md): `POST` — 上传一张图片（multipart 文件 / base64 / URL 三选一），自动居中裁切为正方形后均分为 N×N 宫格小图，按朋友圈发图顺序返回（左到右、上到下编号 1..N²）。支持 2×2 / 3×3 / 4×4，可设置切片间留白，输出 base64 数组或直接下载 zip。
- [一言 · 经典语录](https://apizero.cn/aidocs/hitokoto/raw.md): `GET` — 从 370+ 条经典语录库（动漫/漫画/游戏/文学/影视/诗词/哲学/网络等 12 类）随机返回一条，含原文、出处、作者、分类、字数。支持按分类与长度筛选。
- [浏览器指纹风控](https://apizero.cn/aidocs/browser-fingerprint/raw.md): `POST` — 接收前端 SDK 采集的浏览器指纹（UA / Canvas / WebGL / 字体 / 时区 / 硬件 / WebDriver / 自动化标记等 20+ 维度），综合 9 类规则输出 0-100 风险评分、等级（safe/low/medium/high/critical）、命中的风险因子和异常项，识别爬虫、Headless Chrome、Selenium、虚拟机等异常环境。
- [实时电影票房](https://apizero.cn/aidocs/movie-box/raw.md): `GET` — 实时获取猫眼当日电影票房 Top 10，包含累计票房、实时票房、票房占比、排片占比、上座率等核心指标。数据来源猫眼专业版，按 60 秒缓存。
- [血型遗传查询](https://apizero.cn/aidocs/blood-type/raw.md): `GET` — 根据父母血型查询子女可能/不可能的血型。基于 ABO 显性遗传规律，覆盖全部 16 种父母组合，毫秒级返回。常用于科普教育、亲子问答场景。
- [数据脱敏（敏感信息掩码）](https://apizero.cn/aidocs/desensitize/raw.md): `POST` — 自动检测并脱敏文本中的手机号、身份证（15/18 位）、银行卡（16-19 位）、邮箱、中文姓名等敏感信息。支持按类型组合，纯本地正则匹配，毫秒级返回。默认不回显原文，避免日志泄漏。
- [网页正文提取](https://apizero.cn/aidocs/content-extract/raw.md): `GET` — 从新闻、博客、公众号等网页抽取主体正文，自动去除导航/侧栏/广告/评论。基于文本密度算法，同时返回标题、发布时间、配图列表、字数与预估阅读时长。
- [DNS 劫持检测](https://apizero.cn/aidocs/dns-hijack/raw.md): `GET` — 通过对比 5 大公共 DoH（Cloudflare / Google / AliDNS / DNSPod / OpenDNS）对同一域名的解析结果，检测是否存在 DNS 劫持/污染/篡改。一致 = 安全，多源不一致 = 高风险。
- [网页元数据提取](https://apizero.cn/aidocs/webmeta/raw.md): `GET` — 提取网页的标题、描述、关键词、OG/Twitter Card、favicon，并自动识别使用的 30+ 项技术栈（React/Vue/Next.js/WordPress/Cloudflare 等）。适合 SEO 检测、技术调研、链接预览。
- [身份证归属地查询](https://apizero.cn/aidocs/idcard-region/raw.md): `GET` — 根据身份证号前 6 位查询省/市/区三级归属地。支持完整 18 位身份证号自动脱敏回显。省份数据按需从 CDN 拉取并本地缓存 30 天，网关 Redis 缓存 24h。
- [图片鉴黄](https://apizero.cn/aidocs/image-nsfw/raw.md): `POST` — 图片NSFW内容检测。支持本地NudeNet推理（零调用费）及百度/腾讯/阿里云端三家，统一返回 decision（block/review/pass）+ 分类得分 + 检测框。
- [B 站用户动态](https://apizero.cn/aidocs/bili-dynamic/raw.md): `GET` — 通过 B 站官方公开 API 拉取指定用户的最新动态列表（视频投稿/图文/纯文本/转发等），含发布时间、文本、视频/图片附件、点赞/评论/转发统计。
- [短链还原](https://apizero.cn/aidocs/unshort/raw.md): `GET` — 完整还原一个短链的全部跳转链路，输出每跳的状态码、跳转方式（Location/Meta-Refresh）和耗时。适合钓鱼链接溯源、推广短链分析、二维码内容核对。
- [体脂率与 BMI 计算](https://apizero.cn/aidocs/bodyfat/raw.md): `GET` — 一站式综合计算 BMI、体脂率（Deurenberg 公式）、基础代谢率（Mifflin-St Jeor）、理想体重区间、腰围身高比与健康风险评估。男女区分阈值，附带专业建议。
- [脑筋急转弯](https://apizero.cn/aidocs/brain-teaser/raw.md): `GET` — 从 4500+ 条本地题库随机返回一条脑筋急转弯，包含题目和答案。零上游依赖，毫秒级返回，适合聊天机器人、APP 互动模块。
- [豆瓣电影信息](https://apizero.cn/aidocs/douban-movie/raw.md): `GET` — 通过豆瓣 ID 或 URL 查询电影详情：评分、导演、演员、类型、地区、片长、集数（剧集）、热门短评等。基于豆瓣公开 JSON API。
- [网站安全综合评分](https://apizero.cn/aidocs/site-security/raw.md): `GET` — 五维加权综合评分：SSL 证书 (25%) + 域名安全 (20%) + ICP 备案 (20%) + 微信/QQ 拦截 (15%) + 网站性能 (20%)，总分 0-100，对应 A/B/C/D/F 五级。一次请求得到全面诊断报告。
- [京东地址解析（4 级）](https://apizero.cn/aidocs/jd-address/raw.md): `POST` — 调用京东地址智能识别接口，将自然语言地址解析为「省/市/区/镇」四级行政区划，并返回每级对应的京东 ID。比传统三级行政区划接口多一个「镇」级别。
- [抖音用户公开信息](https://apizero.cn/aidocs/douyin-user/raw.md): `GET` — 通过抖音用户主页链接（短链或长链），获取昵称、头像、签名、作品数、粉丝数、关注数、获赞总数等公开信息。自动展开 v.douyin.com 短链。
- [iOS 证书与描述文件检测](https://apizero.cn/aidocs/ios-cert/raw.md): `POST` — 解析 .p12 证书与 .mobileprovision 描述文件，输出证书有效期、吊销状态、Team ID、证书类型（开发/分发/企业）、设备列表、25 项 entitlements 权限以及证书与描述文件匹配性验证。iOS 开发者必备。
- [网站测速诊断](https://apizero.cn/aidocs/site-check/raw.md): `GET` — 测量网站的 DNS 解析、TCP 连接、SSL 握手、TTFB、总耗时，跟踪重定向链并提取 SSL 证书摘要、命中 IP/端口、页面体积。一次请求 6 大维度全监测。
- [Cloudflare DNS 更新（DDNS）](https://apizero.cn/aidocs/cf-dns/raw.md): `POST` — 通过用户自有的 Cloudflare API Token 更新指定域名的 A/AAAA 记录。家庭宽带 DDNS、办公室外网 IP 自动同步等场景必备。Token 仅作转发使用，不持久化。
- [身份证签发机关查询](https://apizero.cn/aidocs/idcard-organ/raw.md): `GET` — 通过身份证号前 6 位行政区划代码，查询对应的签发机关（地方公安局）。覆盖全国 3000+ 区划代码，本地数据零上游。仅供身份证真伪辅助核验、户籍查询等合规场景。
- [微信文章转存](https://apizero.cn/aidocs/wechat-archive/raw.md): `POST` — 输入微信公众号文章链接，抓取并转为Markdown/纯文本，提取标题、作者、公众号名称、发布时间，下载正文图片资源。
- [域名交易市场](https://apizero.cn/aidocs/domain-trade/raw.md): `GET` — 拉取 EDNS 域名交易市场公开数据，支持按价格、长度、后缀、交易类型筛选。适合站长扫货短米、行业研究、域名估值参考。
- [全网热搜聚合](https://apizero.cn/aidocs/hot-search/raw.md): `POST` — 聚合微博热搜、知乎热榜、B站日榜、百度贴吧热议，一次请求获取全网热门话题。支持按平台筛选和条数限制。
- [访问量计数器](https://apizero.cn/aidocs/visits-counter/raw.md): `GET` — SVG/JSON访问量计数器，支持多套动效主题卡片（咒纹夜/术式蓝焰/五条悟风/无量空处/宿傩咒印等），可嵌入GitHub README或网站。按站点隔离计数。
- [B站弹幕分析](https://apizero.cn/aidocs/bili-danmaku/raw.md): `POST` — 输入B站BV/AV号，拉取视频弹幕并分析高频重复弹幕、热词/梗、整体情感倾向（正向/负向/中性）。
- [DNS 查询](https://apizero.cn/aidocs/dns-lookup/raw.md): `POST` — 零依赖DNS查询API。自实现DNS协议（RFC 1035），支持A/AAAA/MX/TXT/CNAME/NS/SOA/SRV/PTR/CAA记录类型，UDP自动fallback到DoH（DNS over HTTPS）防劫持。

## 其他

- 申请 API Key：https://apizero.cn/account/keys
- 价格 / 套餐：https://apizero.cn/pricing
- 商城（人类版含交互调试）：https://apizero.cn/marketplace
- 联系邮箱：api@zerois.cn