{ "openapi": "3.1.0", "info": { "title": "极数本源 聚合 API", "version": "1.0.0", "description": "极数本源 提供的全部公开 HTTP API。统一 Key、统一计费、统一限流。\n\n申请 API Key：https://apizero.cn/account/keys\n文档主页：https://apizero.cn/aidocs", "termsOfService": "https://apizero.cn/terms", "contact": { "name": "极数本源", "email": "api@zerois.cn", "url": "https://apizero.cn" }, "license": { "name": "Proprietary", "url": "https://apizero.cn/terms" } }, "servers": [ { "url": "https://v1.apizero.cn", "description": "v1 网关（生产）" } ], "externalDocs": { "description": "AI 友好的完整文档（Markdown）", "url": "https://apizero.cn/aidocs/llms-full.txt" }, "tags": [ { "name": "life", "description": "生活服务" }, { "name": "finance", "description": "金融数据" }, { "name": "ai", "description": "AI 能力" }, { "name": "geo", "description": "地理位置" }, { "name": "kyc", "description": "身份核验" }, { "name": "content", "description": "内容娱乐" }, { "name": "dev", "description": "开发工具" } ], "components": { "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "从 https://apizero.cn/account/keys 创建" }, "ApiKeyQuery": { "type": "apiKey", "in": "query", "name": "key", "description": "也可通过 URL ?key= 传递（与 X-Api-Key 二选一）" } }, "schemas": { "OkEnvelope": { "type": "object", "required": [ "code", "msg", "data", "request_id" ], "properties": { "code": { "type": "integer", "const": 0, "description": "成功固定为 0" }, "msg": { "type": "string", "example": "成功" }, "data": { "description": "业务数据，结构详见各接口的 200 响应 schema" }, "request_id": { "type": "string", "example": "req_abcd1234" } } }, "ErrEnvelope": { "type": "object", "required": [ "code", "msg" ], "properties": { "code": { "type": "integer", "example": 4000 }, "msg": { "type": "string", "example": "参数错误" }, "data": { "nullable": true }, "request_id": { "type": "string", "example": "req_abcd1234" } } } }, "responses": { "BadRequest": { "description": "参数错误 / 校验失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrEnvelope" }, "example": { "code": 4000, "msg": "参数错误", "data": null, "request_id": "req_xxx" } } } }, "Unauthorized": { "description": "API Key 无效或缺失", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrEnvelope" }, "example": { "code": 4011, "msg": "API Key 无效", "data": null, "request_id": "req_xxx" } } } }, "TooManyRequests": { "description": "QPS 超限或额度耗尽", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrEnvelope" }, "example": { "code": 4029, "msg": "调用过快，请稍后再试", "data": null, "request_id": "req_xxx" } } } }, "UpstreamError": { "description": "上游服务不可用", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrEnvelope" }, "example": { "code": 5020, "msg": "上游服务不可用", "data": null, "request_id": "req_xxx" } } } } } }, "security": [ { "ApiKeyHeader": [] }, { "ApiKeyQuery": [] } ], "paths": { "/api/video-parse": { "get": { "operationId": "video_parse", "summary": "全平台视频元数据解析服务", "description": "```\n全平台视频元数据解析服务 — 专业、合规、稳定\n\n## 服务概述\n本服务通过 RESTful API 形式，将用户已能合法访问的视频/图集分享链接，\n解析为结构化的元数据信息（标题、封面、作者、原始 URL 等），\n便于开发者集成到内容审核、个人备份、学术研究、数据迁移等场景。\n\n## 核心能力\n- **覆盖广**：国内主流平台全覆盖（抖音、小红书、哔哩哔哩、快手、微博、\n 皮皮虾、最右、贴吧、即梦、可灵 AI 等），海外平台 5 站智能路由\n （YouTube、Vimeo、Twitter 等通过 yt-dlp 兜底）\n- **响应快**：智能缓存 + 多通道竞速，平均响应 1.3 秒，QPS 可达 15\n- **稳定性**：99.7% 月度可用性（含失败重试与自动降级）\n- **合规优先**：\n · 强制在每个响应中返回 source 来源标注字段\n · 不存储任何原始视频/图片内容\n · 完善的 DMCA 侵权处理通道（24 小时响应）\n · 90 天日志保留期，超期自动清理\n\n## 适用场景\n✅ 个人内容备份（用户备份自己发布或合法授权的内容）\n✅ MCN 机构内容审核（对委托发布的内容进行合规审查）\n✅ 学术研究（高校研究机构的传播规律分析）\n✅ 合法范围内的市场数据聚合分析\n✅ 用户在自有多账号间的内容迁移\n\n## 严禁用途（违反者立即终止服务且不予退款）\n❌ 公开传播、二次发布他人受版权保护的内容\n❌ 集成到视频下载站、聚合下载工具等以下载为主功能的产品\n❌ 大规模爬取、自动化抓取\n❌ 用于侵犯他人著作权、肖像权、隐私权的任何用途\n❌ 二次商业转售本服务的解析结果\n\n## 调用即同意《用户协议与免责声明》\n完整协议：如下免责申明\n侵权投诉：1790643379@qq.com\n```", "tags": [ "content" ], "x-pricing": { "mode": 10, "point_cost": 0, "qps_limit": 3, "daily_free_limit": 20, "no_key_daily": 5 }, "x-doc-url": "https://www.apizero.cn/aidocs/video-parse", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/video-parse/raw.md", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "待解析的视频/图文链接。支持完整 URL 或分享短链（如 v.douyin.com/xxx、vm.tiktok.com/xxx）。最大 2048 字符", "schema": { "type": "string", "example": "https://www.bilibili.com/video/BV1gY411A7y7" }, "example": "https://www.bilibili.com/video/BV1gY411A7y7" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "code": 200, "platform": "bilibili", "type": "视频", "data": { "title": "100小时安娜的睡针，献给所有守望玩家", "video_url": "https://upos-sz-mirrorhw.bilivideo.com/upgcxcode/.../xxx.mp4", "cover_url": "http://i0.hdslb.com/bfs/archive/xxx.jpg", "audio_url": "", "imagelist": [] }, "stats": { "author_name": "AIX5E", "author_avatar": "https://i0.hdslb.com/bfs/face/xxx.jpg", "like_count": 334, "comment_count": 74, "share_count": 32, "play_count": 6843, "collect_count": 21, "publish_time": "2022-05-05 16:08:33" }, "video_list": [ { "quality": "原画 1080P", "url": "https://...", "size": "~38.01MB", "resolution": "1920x1080" }, { "quality": "720P", "url": "https://...", "size": "~25.34MB", "resolution": "1280x720" }, { "quality": "480P", "url": "https://...", "size": "~11.43MB", "resolution": "852x480" } ] }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/barcode-gs1": { "get": { "operationId": "barcode_gs1", "summary": "商品条码查询-官方数据", "description": "官方权威的商品条码查询接口，数据直通中国物品编码中心(GS1 China)官方注册数据库。\n\n【数据源升级 · 2026-05】当前以中国编码官方 APP (ancc.org.cn) 为主源，多源兜底（chinatrace / gds-bff / cnaidc），三级缓存设计（Redis 24h → MySQL 永久库 → 上游 API），高频查询的条码自动周期性回源刷新，数据时效性进一步优化。\n\n与 `barcode-lookup` 定位不同：\n- 本接口**官方权威**：返回厂商注册名称、产品登记信息、上市日期、官方商品图等可追溯的官方数据\n- 本接口**仅覆盖国内注册条码**(6/690 开头)，进口商品或非注册条码会返回 found=false\n- 适合合规核验、溯源、上架审核等对数据权威性要求高的场景\n\n支持输入格式：8 / 12 / 13 / 14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14。\n\n返回数据包含：产品名称、品牌、通用名、分类（含分类编号）、规格、净含量、上市日期、厂商企业名、官方商品图、条码激活日期、产品创建日期、企业注册日期、已用天数等核心字段，部分情况下额外提供生产国、企业地址、参考售价、厂商识别代码等扩展字段。", "tags": [ "life" ], "x-pricing": { "mode": 10, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 20, "no_key_daily": 20 }, "x-doc-url": "https://www.apizero.cn/aidocs/barcode-gs1", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/barcode-gs1/raw.md", "parameters": [ { "name": "code", "in": "query", "required": true, "description": "商品条形码(8/12/13/14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14)", "schema": { "type": "string", "example": "6921168509256" }, "example": "6921168509256" }, { "name": "Authorization", "in": "header", "required": false, "description": "登录用户传 API Key 享用更高额度；匿名调用每天 20 次免费", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "barcode": "6907992700199", "gtin14": "06907992700199", "found": true, "registered": true, "registration_message": "该商品条码已经在中国物品编码中心注册，编码信息已按规定通报。", "name": "伊利儿童奶酪棒香草冰淇淋味再制干酪", "brand": "伊利", "general_name": "奶酪（易腐坏）", "feature": "伊利儿童奶酪棒香草冰淇淋味再制干酪", "category": "奶酪（易腐坏）(10000028)", "specification": "90克", "net_content": "90克", "sale_date": null, "manufacturer": "内蒙古伊利实业集团股份有限公司", "images": [ "https://www.gds.org.cn/userfile/uploada/gra/sj201210093039959369/06907992700199/06907992700199.1.jpg" ], "qr_active_date": null, "product_create_date": "2019年11月18日", "company_register_date": null, "use_days": 2366, "country": null, "address": null, "price": null, "category_code": null }, "request_id": "mp0vcq0fab827132" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/hot-baidu": { "get": { "operationId": "hot_baidu", "summary": "百度热搜榜", "description": "聚合百度搜索热榜数据，实时返回 4 大榜单的 Top 30~50 条热门内容。零成本调用，适合做内容聚合 / 热点追踪 / 资讯类产品。\n\n【支持榜单】\n- realtime（实时热搜）· 默认值，约 30~50 条\n- novel（小说）· 约 30 条，含作者\n- movie（电影）· 约 10 条，含类型\n- tv（电视剧）· 约 10 条，含演员\n\n【返回字段】\n- rank · 榜单排名\n- title · 标题\n- desc · 简短描述\n- hot_index · 热度指数（数字）\n- link · 详情链接（百度搜索）\n- image · 配图 URL（直接可用，无防盗链限制）\n- tag · 标签（如「热」「新」「沸」「爆」）\n- author / category / actors · 小说 / 电影 / 电视剧专属字段\n\n【典型场景】\n- 资讯类 App 的\"今日热点\"模块\n- AI 写作助手的\"实时热点选题\"参考\n- 数据看板 / 大屏展示\n- 微信公众号选题辅助\n- 热搜监控 / 舆情分析\n\n【调用示例】\nGET /api/hot-baidu · 默认实时热搜\nGET /api/hot-baidu?tab=realtime\nGET /api/hot-baidu?tab=novel\nGET /api/hot-baidu?tab=movie\nGET /api/hot-baidu?tab=tv\n\n【性能与缓存】\n- 平均响应 200ms（缓存命中时 < 50ms）\n- 后端 60 秒缓存（百度榜单本身分钟级更新，短缓存合理且节省调用方资源）\n\n【⚠️ 数据来源说明】\n本接口数据来源于百度搜索热榜公开页面（top.baidu.com），仅用于个人开发测试与小规模商业场景；如需大规模商业使用建议自建抓取或采购官方 API。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 10000, "no_key_daily": 1000 }, "x-doc-url": "https://www.apizero.cn/aidocs/hot-baidu", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/hot-baidu/raw.md", "parameters": [ { "name": "tab", "in": "query", "required": false, "description": "榜单类型：realtime（实时热搜，默认）/ novel（小说）/ movie（电影）/ tv（电视剧）", "schema": { "type": "string", "example": "realtime" }, "example": "realtime" }, { "name": "Authorization", "in": "header", "required": false, "description": "可选 API Key 鉴权。未登录每天 50 次免费体验额度；登录用户更高额度且无需 IP 限制", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "tab": "realtime", "update_time": "2026-05-06 07:15:00", "total": 30, "list": [ { "rank": 1, "title": "总书记对青年学子的殷切期待", "desc": "坚定不移走中国特色社会主义道路...", "hot_index": 4982315, "link": "https://www.baidu.com/s?wd=%E6%80%BB%E4%B9%A6%E8%AE%B0%E5%AF%B9%E9%9D%92%E5%B9%B4...", "image": "https://fyb-2.cdn.bcebos.com/hotboard_image/ced2dbd68e9ca16f8fc405530a0a3a5d?x-bce-process=image/resize,m_fill,w_256,h_170", "tag": "热" }, { "rank": 2, "title": "...", "desc": "...", "hot_index": 3500000, "link": "https://www.baidu.com/s?wd=...", "image": "https://fyb-2.cdn.bcebos.com/hotboard_image/...", "tag": "新" } ] }, "request_id": "mqx8x12345abc" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/barcode-lookup": { "get": { "operationId": "barcode_lookup", "summary": "商品条码查询-免费版", "description": "通过商品条形码（EAN-13 / UPC-A / UPC-E / EAN-8）一键查询商品信息，覆盖国内日常消费品超千万 SKU，包括食品饮料、日用百货、个护美妆、酒水烟草、母婴用品等。\n\n【核心字段】\n- name 商品名称\n- brand 品牌\n- manufacturer 生产厂商 / 经销商\n- spec 规格（如 550ml / 250g / 6 听装）\n- price 参考价（人民币元，仅作参考非实时市场价）\n- image 商品图片 URL（自有 CDN 代理，跨域友好）\n\n【典型场景】\n- 电商 / 零售 ERP：扫码录入商品自动补全字段\n- 个人记账 App：扫码识物展示购物明细\n- 物流仓储：条码核销 + 商品图展示\n- 自动售货机：条码识别后获取商品名称\n- 营销活动：用户扫码核销福利时验证商品\n\n【调用示例】\nGET /api/barcode-lookup?barcode=6921168509256\n\n【特别说明】\n- 平均响应 100ms（不含图片下载）\n- 国内主流商品（农夫山泉、可口可乐、康师傅、伊利等）覆盖率 > 95%\n- 个别冷门 / 新上市 SKU 可能未收录，此时 found=false\n- price 字段仅作参考，非各电商平台实时价格\n- image 字段始终返回有效 URL（接图片 onError 即可降级到默认图标）\n\n【⚠️ 注意】\n图片资源为公开懒加载代理，不计入接口调用次数；商品文本数据为按次计费。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 200, "no_key_daily": 20 }, "x-doc-url": "https://www.apizero.cn/aidocs/barcode-lookup", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/barcode-lookup/raw.md", "parameters": [ { "name": "barcode", "in": "query", "required": true, "description": "8~13 位纯数字条形码。支持 EAN-13、UPC-A、EAN-8、UPC-E 等主流标准。", "schema": { "type": "string", "example": "6921168509256" }, "example": "6921168509256" }, { "name": "mode", "in": "query", "required": false, "description": "保留参数：mode=image 时返回该商品的图片二进制（不计费、公开访问，主要由响应中的 image 字段链接自动调用）。", "schema": { "type": "string", "example": "image" }, "example": "image" }, { "name": "Authorization", "in": "header", "required": false, "description": "可选 API Key 鉴权。未登录每天有 20 次免费体验额度；登录用户每天 200 次免费", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "barcode": "6921168509256", "found": true, "name": "农夫山泉 饮用天然水550ml", "brand": "农夫山泉", "manufacturer": "农夫山泉股份有限公司", "spec": "550ml", "price": 1.5, "category": null, "description": null, "image": "https://v1.apizero.cn/api/barcode-lookup?mode=image&barcode=6921168509256" }, "request_id": "mqx8x12345abc" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/weather": { "get": { "operationId": "weather", "summary": "彩云天气", "description": "基于彩云天气 v2.6 的全功能天气接口，覆盖：\n • 实时天气（温度/湿度/风/能见度/AQI/PM2.5）\n • 分钟级降水预报（未来 2 小时）\n • 小时预报（最长 360 小时 = 15 天）\n • 天预报（最长 15 天，含日出日落、温度极值、生活指数）\n • 综合数据（一次返回全部 + 气象预警）\n\n特色：\n • 支持城市名直接查询（内置 ~140 个常用中国城市表 + Open-Meteo 兜底，无需高德/百度 Key）\n • 自动中文化：skycon 转中文、风向转 16 方位、风速转蒲福风级、AQI 转等级颜色\n • 预警标准化：从原始 title 提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重）\n • 顶层 summary 字段提供\"一眼看懂\"的实时摘要", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 2000, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/weather", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/weather/raw.md", "parameters": [ { "name": "type", "in": "query", "required": false, "description": "查询类型：realtime / minutely / hourly / daily / weather（默认 weather 综合）", "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "description": "城市/地区名称（如「北京」「朝阳区」），与 location 二选一", "schema": { "type": "string" } }, { "name": "location", "in": "query", "required": false, "description": "经纬度坐标，格式 经度,纬度（如 116.3975,39.9085），优先级高于 city", "schema": { "type": "string" } }, { "name": "alert", "in": "query", "required": false, "description": "是否包含气象预警，true/false，默认 true（仅 realtime/weather 生效）", "schema": { "type": "string" } }, { "name": "days", "in": "query", "required": false, "description": "天预报步长，1~15，默认 5（仅 daily/weather 生效）", "schema": { "type": "number" } }, { "name": "hours", "in": "query", "required": false, "description": "小时预报步长，1~360，默认 24（仅 hourly/weather 生效）", "schema": { "type": "number" } }, { "name": "X-API-Key", "in": "header", "required": false, "description": "API Key（不传走匿名额度）", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "type": "weather", "location": { "city": "北京", "longitude": 116.4074, "latitude": 39.9042, "timezone": "Asia/Shanghai" }, "server_time": "2026-05-06 08:43:01", "forecast_keypoint": "未来两小时不会下雨，放心出门", "summary": { "skycon": "小雨", "skycon_emoji": "🌦️", "skycon_code": "LIGHT_RAIN", "temperature": 21.5, "apparent_temperature": 21.8, "humidity_percent": 55, "cloudrate_percent": 100, "visibility_km": 20.3, "wind": { "speed_ms": 3.7, "direction_deg": 239.9, "direction_text": "西南偏南风", "level": 3, "level_text": "微风" }, "air_quality": { "aqi": 68, "level": "良", "level_color": "yellow", "pm25": 27 }, "alert_count": 1 }, "alerts": [ { "title": "东城区气象台发布大风蓝色预警[IV/一般]", "description": "预计 6 日早晨至午后...有 3-4 级偏北风，阵风 6-7 级...", "color": "蓝色", "level": "一般", "status": "预警中", "province": "北京市", "city": "北京城区", "county": "东城区", "pub_time": "2026-05-05 16:46:00", "source": "国家预警信息发布中心", "alert_id": "11010141600000_..." } ], "realtime": "...（彩云原始 realtime 字段，详见上方字段说明）", "minutely": "...（type=weather 才有）", "hourly": "...（type=weather 才有）", "daily": "...（type=weather 才有）" }, "request_id": "mota..." } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/whois": { "get": { "operationId": "whois", "summary": "Whois 域名查询", "description": "对接 whoiscx.com 上游，查询域名注册信息（注册商 / 注册主体 / 创建时间 / 到期时间 / DNS 服务器 / 域名状态 / DNSSEC 等）。\n\n• **支持所有主流 TLD**：.com / .cn / .net / .org / .io / .me / .top / .xyz 等几乎所有 ICANN 认证后缀\n• **自动归一化**：传入 `https://www.baidu.com/abc` 会自动剥离为 `baidu.com`\n• **域名可用性检测**：未注册域名返回 is_available=true，可用于域名抢注前查询\n• **到期告警**：30 天内到期返回 expiring_soon=true，便于前端高亮提示\n• **域龄展示**：creation_age_text 返回「N 年 M 月」人类可读字符串\n• **国内 .cn 主体中文**：whoiscx 上游对国内域名返回中文注册主体名（如「极数本源（福州）科技有限公司」）\n• **缓存 24h**：whois 数据年级变化，全天同一域名查询只调 1 次上游\n• **修复源码 BUG**：错误响应字段是 `error` 不是 `message`，源码取错丢失了上游真实错误", "tags": [ "dev" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 100, "no_key_daily": 30 }, "x-doc-url": "https://www.apizero.cn/aidocs/whois", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/whois/raw.md", "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "待查询域名。自动剥离 http(s):// 前缀、路径、:port 后缀、子域名（如 www.baidu.com → baidu.com 由上游处理）", "schema": { "type": "string", "example": "baidu.com" }, "example": "baidu.com" }, { "name": "with_raw", "in": "query", "required": false, "description": "是否返回 raw_whois 原始 whois 文本（约 3KB），默认 false。建议仅调试时启用", "schema": { "type": "boolean", "example": "false" }, "example": "false" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "domain": "baidu.com", "suffix": "com", "is_available": false, "is_expired": false, "expiring_soon": false, "registrar": "MarkMonitor Information Technology (Shanghai) Co., Ltd.", "registrant": "", "registrant_email": "", "creation_time": "1999-10-11 19:05:17", "expiration_time": "2028-10-11 19:05:17", "creation_days": 9704, "creation_age_text": "26 年 7 个月", "valid_days": 888, "domain_status": [ "clientDeleteProhibited （注册商设置禁止删除）", "clientTransferProhibited （注册商设置禁止转移）" ], "name_servers": [ "NS1.BAIDU.COM", "NS2.BAIDU.COM", "NS3.BAIDU.COM" ], "whois_server": "whois.markmonitor.com", "dnssec": "unsigned", "registrar_url": "http://markmonitor.com", "registrar_abuse_email": "abusecomplaints@markmonitor.com", "registrar_abuse_phone": "+1.2083895740", "query_time": "2026-05-07 09:18:54" }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/movie-box": { "get": { "operationId": "movie_box", "summary": "实时电影票房", "description": "实时获取猫眼当日电影票房 Top 10，包含累计票房、实时票房、票房占比、排片占比、上座率等核心指标。数据来源猫眼专业版，按 60 秒缓存。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 20000, "no_key_daily": 1000 }, "x-doc-url": "https://www.apizero.cn/aidocs/movie-box", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/movie-box/raw.md", "parameters": [ { "name": "X-API-Key", "in": "header", "required": false, "description": "API Key（不传走匿名额度）", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "update_time": "2026-05-06 07:30:00", "total": 10, "list": [ { "rank": 1, "name": "消失的人", "release_days": "上映6天", "total_box": "2.66亿", "box_office": 163.25, "box_rate": 35.5, "show_rate": 28.8, "seat_rate": 33 }, { "rank": 2, "name": "给阿嬷的情书", "release_days": "上映7天", "total_box": "6205.9万", "box_office": 98.85, "box_rate": 21.5, "show_rate": 7.3, "seat_rate": 6.1 } ] }, "request_id": "mot9..." } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/ip-pro": { "get": { "operationId": "ip_pro", "summary": "IP 地址查询（街道级）", "description": "IP 地理位置查询，精确到街道级。多数据源自动切换：主源提供街道 + ISP + 风险评分，主源不可用时自动降级到备用源（城市级 + ISP）。响应 data.source 字段标识本次数据档位。", "tags": [ "geo" ], "x-pricing": { "mode": 14, "point_cost": 5, "qps_limit": 3, "daily_free_limit": 30, "no_key_daily": 5 }, "x-doc-url": "https://www.apizero.cn/aidocs/ip-pro", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/ip-pro/raw.md", "parameters": [ { "name": "ip", "in": "query", "required": false, "description": "要查询的 IP 地址（IPv4 或 IPv6）。不传时自动使用调用方自身 IP，适用于\"查我自己\"", "schema": { "type": "string", "example": "110.87.41.14" }, "example": "110.87.41.14" }, { "name": "Authorization", "in": "header", "required": false, "description": "Bearer Token。匿名调用时可省略（受每日免费额度限制）；付费方案或超过免费额度时必需", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "ip": "117.25.49.203", "continent": "亚洲", "country": "中国", "country_code": "CN", "province": "福建", "city": "福州", "district": "永泰", "street": "城峰镇", "street_alternatives": [ "福建福州永泰城峰镇", "福建福州永泰大洋镇" ], "area_code": "350125", "zip_code": "350000", "city_code": "0591", "latitude": 25.855039, "longitude": 118.94202, "elevation": 29, "time_zone": "Asia/Shanghai", "isp": "电信", "risk": { "level": "无风险", "score": 0, "is_proxy": false, "proxy_probability": 0, "real_rate": 6, "mobile_rate": 4.69 }, "source": "primary" }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/exchange-rate": { "get": { "operationId": "exchange_rate", "summary": "实时汇率查询", "description": "实时汇率查询，支持 26 种主流货币（CNY/USD/EUR/GBP/JPY 等）一键互转。数据 1 分钟级更新，毫秒响应，免费且无需注册即可调用。\n\n基于 ALAPI 汇率源，覆盖人民币、美元、欧元、英镑、日元、港币、韩元、澳元、加元、新加坡元、瑞士法郎、新台币、泰铢、马来西亚林吉特、俄罗斯卢布、印度卢比、巴西雷亚尔、南非兰特、新西兰元、瑞典/挪威/丹麦克朗、菲律宾比索、印尼盾、越南盾、阿联酋迪拉姆等。\n\n支持「同币种快路径」（from=to 时本地直接返回，0 上游消耗），以及「货币列表查询」action=currencies 子命令（返回支持的全部 26 种货币代码与中文名）。", "tags": [ "finance" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 200, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/exchange-rate", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/exchange-rate/raw.md", "parameters": [ { "name": "money", "in": "query", "required": false, "description": "要转换的金额，必须 > 0；缺省 1", "schema": { "type": "number" } }, { "name": "from", "in": "query", "required": false, "description": "源货币代码（ISO 4217 三字母），如 CNY、USD、EUR；缺省 CNY", "schema": { "type": "string", "example": "CNY" }, "example": "CNY" }, { "name": "to", "in": "query", "required": false, "description": "目标货币代码（ISO 4217 三字母），如 USD、JPY；缺省 USD", "schema": { "type": "string", "example": "USD" }, "example": "USD" }, { "name": "action", "in": "query", "required": false, "description": "传 \"currencies\" 直接返回 26 种支持货币列表（不调上游、不计费）", "schema": { "type": "string", "example": "currencies" }, "example": "currencies" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 50 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "money": 1, "from": "CNY", "from_name": "人民币", "to": "USD", "to_name": "美元", "rate": 0.146405, "result": 0.1464, "update_time": "2026-05-06 13:00:02" }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/wzry": { "get": { "operationId": "wzry", "summary": "王者战力查询", "description": "王者荣耀全国战力查询，一接口聚合「英雄列表 + 区服战力分布」2 大功能。\n\n• action=heroes — 返回 130+ 个英雄完整目录（中文名 / ename / 称号 / 头像 URL），优先腾讯官方源 https://pvp.qq.com/web201605/js/herolist.json，失败自动降级 yxsaoma.com\n\n• action=query — 查询某英雄在某区服的全国战力分布数据，返回 90 条左右的省市区战力榜（含同地区相近排名）\n\n支持 4 大区服：\n · aqq = Android QQ\n · awx = Android 微信\n · iqq = iOS QQ\n · iwx = iOS 微信\n\n查询类型：\n · all = 完整 heroList（按 level 混合排列，约 90 项）\n · min = 各级（省/市/区）最低战力 + 相近排名（rank ≤ +100）\n · max = 各级（省/市/区）最高战力 + 相近排名\n\n上游签名（warzoneSignKey20240515 + MD5 + timestamp）已在网关侧自动处理，调用方无需关心。英雄列表缓存 24 小时，战力数据缓存 1 小时。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 200, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/wzry", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/wzry/raw.md", "parameters": [ { "name": "action", "in": "query", "required": true, "description": "操作类型：heroes=英雄列表 / query=战力查询", "schema": { "type": "string", "example": "query" }, "example": "query" }, { "name": "hero", "in": "query", "required": false, "description": "英雄中文名（如「赵云」）；action=query 时与 hero_id 二选一必传", "schema": { "type": "string", "example": "赵云" }, "example": "赵云" }, { "name": "hero_id", "in": "query", "required": false, "description": "英雄 ename（如赵云=107）；action=query 时与 hero 二选一必传，hero_id 优先级更高", "schema": { "type": "number" } }, { "name": "zone", "in": "query", "required": false, "description": "区服代码：aqq=Android QQ / awx=Android 微信 / iqq=iOS QQ / iwx=iOS 微信；action=query 必填", "schema": { "type": "string", "example": "aqq" }, "example": "aqq" }, { "name": "type", "in": "query", "required": false, "description": "返回类型：all=完整列表（默认）/ min=最低战力 / max=最高战力", "schema": { "type": "string", "example": "all" }, "example": "all" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 50 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "action": "query", "hero": { "name": "赵云", "title": "苍天翔龙", "ename": "107", "avatar": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/107/107.jpg" }, "zone": { "code": "aqq", "system": "Android", "platform": "QQ" }, "type": "最低战力", "type_code": "min", "syn_date": "2026-05-06", "rank_data": { "extreme": { "province": { "address": "云南", "level": "province", "rank": 4500, "adcode": "..." }, "city": { "address": "海南/三亚市", "level": "city", "rank": 1800, "adcode": "..." }, "district": { "address": "北京/朝阳区", "level": "district", "rank": 800, "adcode": "..." } }, "similar": { "province": [ { "address": "云南", "rank": 4500 }, { "address": "甘肃", "rank": 4520 } ], "city": [], "district": [] } } }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/qq": { "get": { "operationId": "qq", "summary": "QQ 信息", "description": "通过 QQ 号查询昵称、QQ 邮箱、QQ 空间链接，并生成 4 种尺寸的头像直链 URL（s40/s100/s140/s640）。\n\n• 严格 5-11 位数字校验（防上游字符串截断引起的号码错位）\n• 安全增强：上游返回的 QQ key 必须与请求严格一致，否则视为未查询到\n• 错误兼容：自动识别上游错误响应（_Callback({error:...})）和正常响应（portraitCallBack(...)）\n• 编码兜底：腾讯接口历史输出 GBK 含中文昵称时自动转 UTF-8\n• 多尺寸头像：avatars 对象内含 s40/s100/s140/s640 四种尺寸 URL，前端 `` 直接用", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 300, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/qq", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/qq/raw.md", "parameters": [ { "name": "qq", "in": "query", "required": true, "description": "5-11 位 QQ 号码（纯数字）", "schema": { "type": "string", "example": "88888888" }, "example": "88888888" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 50 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "qq": "88888888", "name": "腾讯客服", "mail": "88888888@qq.com", "qzone": "https://user.qzone.qq.com/88888888", "avatars": { "s40": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=40", "s100": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=100", "s140": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=140", "s640": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=640" }, "is_found": true }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/image-enhance": { "post": { "operationId": "image_enhance", "summary": "AI 图片变清晰", "description": "基于先进 AI 超分辨率算法的图片高清化服务。输入一张模糊 / 低分辨率图片 URL，约 4 秒内返回 4 倍超分辨率的高清版本（如 300×300 → 1200×1200），支持 JPEG / PNG / WebP / BMP 等主流格式。\n\n【核心能力】\n- 4 倍超分辨率（最大边自动放大约 4 倍）\n- 自动去噪 / 去糊 / 锐化细节\n- 保留原图色彩与构图\n- 适合老照片修复、缩略图放大、低质截图增强、网络图片优化\n- 输出 JPEG 高质量（HD 模式）\n\n【典型场景】\n- 电商：商品低清图自动高清化\n- 自媒体：老照片 / 截图修复用于配图\n- 设计：素材尺寸不够时快速放大\n- 视频缩略图、社交头像高清化\n- 旧扫描件 / 截屏文字增强\n\n【调用示例】\nPOST /api/image-enhance\nContent-Type: application/x-www-form-urlencoded\n\nimg=https://example.com/your-blurry-image.jpg\n\n【⚠️ 输入限制】\n- 必须是 **公网可访问** 的 http/https URL（私有 OSS 链接需先签名）\n- 文件大小 ≤ 10 MB\n- 支持格式：JPEG / PNG / WebP / BMP\n\n【⚠️ 输出说明】\n- 返回的 enhanced_url 为平台代理 URL（自有域名，跨域友好）\n- 实际图片在 6 小时内有效，请尽快下载保存\n- 平均响应 4~6 秒，复杂图片可能需要 10~30 秒\n\n【计费说明】\n登录用户每日 10 次免费体验，超出按点数扣费（详见控制台）。", "tags": [ "ai" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 1, "daily_free_limit": 10, "no_key_daily": 0 }, "x-doc-url": "https://www.apizero.cn/aidocs/image-enhance", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/image-enhance/raw.md", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "img": { "type": "string", "description": "待增强的图片 URL，必须是公网可访问的 http/https 地址；文件 ≤ 10 MB；JPEG / PNG / WebP / BMP 格式", "example": "https://example.com/blurry-photo.jpg" } }, "required": [ "img" ] }, "example": { "img": "https://example.com/blurry-photo.jpg" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": true, "description": "API Key 鉴权（在控制台申请）", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": false, "description": "使用 form-urlencoded 或 JSON body 都可", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "original_url": "https://example.com/blurry-photo.jpg", "enhanced_url": "https://v1.apizero.cn/api/image-enhance?mode=image&u=aHR0cHM6Ly9...&s=a1b2c3d4e5f6", "width": 1200, "height": 1200, "expires_in": 21600 }, "request_id": "mqx8x12345abc" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/aggregate-translate": { "post": { "operationId": "aggregate_translate", "summary": "聚合翻译", "description": "聚合 DeepL / 腾讯 / 有道三大引擎的多语言翻译，可指定单一引擎或自动选优；支持 platform=all 模式同时返回所有引擎结果用于对比。三个 action：translate（翻译，默认）/ engines（引擎列表）/ languages（语言列表）。支持 12 种语言互译。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 50, "no_key_daily": 20 }, "x-doc-url": "https://www.apizero.cn/aidocs/aggregate-translate", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/aggregate-translate/raw.md", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "description": "translate（默认）/ engines / languages" }, "text": { "type": "string", "description": "translate 必填；待翻译文本（≤ 5000 字）", "example": "Hello world" }, "source_lang": { "type": "string", "description": "源语言；auto/zh/en/ja/ko/fr/de/es/pt/it/ru/pl/nl，默认 auto；别名 from" }, "target_lang": { "type": "string", "description": "目标语言；同上但不允许 auto，默认 en；别名 to" }, "engine": { "type": "string", "description": "指定引擎：deepl / tencent / youdao；留空则自动选优" }, "platform": { "type": "string", "description": "设为 all 则同时调用所有引擎返回对比结果（alternatives 字段）" } }, "required": [ "text" ] }, "example": { "text": "Hello world" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "result": { "text": "你好，世界", "source_lang": "en", "target_lang": "zh", "engine": "deepl" }, "alternatives": null }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/content-moderation": { "post": { "operationId": "content_moderation", "summary": "内容审核", "description": "基于「敏感词库 + 正则规则 + AI 特征评分」三重策略检测文本中的色情 / 政治 / 广告 / 联系方式 / 引流 / 谩骂 6 大类敏感内容。识别变体绕过（谐音、拼音、符号替换），输出 safe/low/medium/high 风险等级，可选自动脱敏。", "tags": [ "content" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 500, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/content-moderation", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/content-moderation/raw.md", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "description": "操作：moderate（默认）/ batch / categories", "example": "moderate" }, "text": { "type": "string", "description": "待审核文本（仅 action=moderate 用），1-5000 字", "example": "今天天气不错" }, "texts": { "type": "array", "description": "批量文本（仅 action=batch 用），最多 50 条", "example": "[\"文本1\", \"文本2\"]" }, "mask": { "type": "boolean", "description": "是否返回脱敏文本，默认 false", "example": "true" } }, "required": [ "text" ] }, "example": { "action": "moderate", "text": "今天天气不错", "texts": "[\"文本1\", \"文本2\"]", "mask": "true" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "is_pass": false, "risk_level": "high", "categories": [ "谩骂" ], "details": [ { "category": "谩骂", "method": "敏感词", "matches": [ "傻逼", "脑残" ], "count": 2 } ], "masked_text": "你这个**，**吧", "original_length": 10 }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/dns-check": { "get": { "operationId": "dns_check", "summary": "DNS 劫持检测", "description": "通过 4 家公共 DoH（DNS over HTTPS）服务器并发查询同一域名，对比解析结果检测 DNS 是否被运营商劫持、终端 hosts 篡改或遭遇异常 GeoDNS 分流。\n\n服务器列表：\n • AliDNS（阿里云 - 中国）\n • DNSPod（腾讯 - 中国）\n • 360 安全 DNS（中国）\n • Cloudflare（美国 - 在中国大陆服务器侧可能超时，会被标记为 timeout）\n\n特性：\n • A + AAAA 记录同时查询（IPv4 / IPv6）\n • 提取 CNAME 链路（CDN 跳转可见）\n • TTL 信息汇总（缓存提示）\n • 智能风险分级算法：safe / safe_with_geodns / suspicious / hijack_likely / unknown\n • 支持各类输入：domain / https://domain / domain:port / domain/path（自动剥离）", "tags": [ "dev" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 2000, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/dns-check", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/dns-check/raw.md", "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "要检测的域名（如 baidu.com，自动剥离 http(s):// 协议头与路径，最长 253 字符）", "schema": { "type": "string" } }, { "name": "X-API-Key", "in": "header", "required": false, "description": "API Key（不传走匿名额度）", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "domain": "taobao.com", "input": "https://www.taobao.com/page", "exec_ms": 312, "summary": { "status_text": "DNS 解析正常", "risk_level": "safe", "risk_score": 95, "explain": "4 家 DoH 全部相互验证通过，未检测到劫持迹象。", "cname_chain": [ "www.taobao.com.danuoyi.tbcache.com" ], "success_count": 3, "total_count": 4, "unique_ipv4_count": 8, "unique_ipv6_count": 0 }, "unique_ipv4": [ "59.82.121.163", "59.82.122.130", "59.82.122.140", "59.82.122.165", "59.82.43.234", "59.82.43.238", "59.82.43.239", "59.82.44.240" ], "unique_ipv6": [], "servers": [ { "key": "alidns", "name": "AliDNS", "status": "ok", "error": null, "latency_ms": 105, "ipv4": [ "59.82.121.163", "59.82.122.130", "..." ], "ipv6": [], "cname_chain": [ "www.taobao.com.danuoyi.tbcache.com" ], "ttl_min": 60 }, { "key": "dnspod", "name": "DNSPod", "status": "ok", "latency_ms": 180, "ipv4": [ "59.82.121.163", "..." ] }, { "key": "china360", "name": "360", "status": "ok", "latency_ms": 117 }, { "key": "cloudflare", "name": "Cloudflare", "status": "timeout", "error": "Operation timed out after 6000 ms", "latency_ms": 6000 } ] }, "request_id": "mota..." } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/moji-weather": { "get": { "operationId": "moji_weather", "summary": "墨迹天气", "description": "接入墨迹天气 iOS 客户端协议，支持全国 3 万+ 城市实况、历史天气、未来 7 天、24 小时趋势、AQI、9 项生活指数、气象预警及农历，一次调用全量返回。\n\n支持 4 种查询模式：\n- ?city=北京 · 按城市名查实况（自动模糊匹配第一个）\n- ?id=33 · 按 internal_id 直查（跳过搜索，更快）\n- ?op=search&keyword=北京 · 仅搜索城市列表，拿 id\n- ?op=history&city=北京&day=2026-05-12 · 历史天气（支持单日 / 整月）\n\n历史天气范围：\n- 当前月：返回 1 号至昨天的数据\n- 历史月（≤ 上月）：返回完整 30 天\n- 建议查近 40 天以内，过早的月份可能无数据\n\n服务端缓存策略：\n- 实况：5 分钟；历史·当月：30 分钟；历史·过去月：24 小时\n\n注意：数据由墨迹天气提供，仅供参考，不应用于农业、保险、航运、防灾等专业决策场景。\n\n联系站长：apizero.cn", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 30, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/moji-weather", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/moji-weather/raw.md", "parameters": [ { "name": "city", "in": "query", "required": false, "description": "城市中文名（支持 \"北京\" / \"大化\" / \"杭州\"）；与 id 二选一", "schema": { "type": "string", "example": "大化" }, "example": "大化" }, { "name": "id", "in": "query", "required": false, "description": "城市 internal_id（可先调 ?op=search 查询）；与 city 二选一", "schema": { "type": "number" } }, { "name": "op", "in": "query", "required": false, "description": "查询模式：search=城市搜索；history=历史天气；缺省=实况天气", "schema": { "type": "string", "example": "history" }, "example": "history" }, { "name": "keyword", "in": "query", "required": false, "description": "【op=search】关键字，支持中文 / 拼音 / 拼音首字母", "schema": { "type": "string", "example": "大化" }, "example": "大化" }, { "name": "limit", "in": "query", "required": false, "description": "【op=search】返回条数（1-50，默认 20）", "schema": { "type": "number" } }, { "name": "day", "in": "query", "required": false, "description": "【op=history】查某一天：YYYY-MM-DD / MM-DD（需配 month）/ DD（需配 month）", "schema": { "type": "string", "example": "2026-05-12" }, "example": "2026-05-12" }, { "name": "month", "in": "query", "required": false, "description": "【op=history】查整月：YYYYMM。当前月返回 1 号到昨天；历史月返回完整 30 天", "schema": { "type": "string", "example": "202604" }, "example": "202604" }, { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "city": { "id": 1205, "name": "大化瑶族自治县", "parent": "广西壮族自治区", "pinyin": "dahuayaozuzizhixian", "timezone": 8 }, "condition": { "condition": "多云", "temperature": 32, "real_feel": 36, "humidity": 62, "pressure": 999, "wind_dir": "南风", "wind_level": 3, "uvi": "中等", "sun_rise": 1778706000000, "sun_set": 1778757660000, "lunar_date": "丙午年三月廿八", "tips": "防暑||中午外出请注意防暑降温。" }, "aqi": { "value": 29, "level": 1, "description": "优", "updatetime": 1778756400000 }, "forecast_day": [ { "predict_date": 1778601630000, "condition_day": "多云", "condition_night": "多云", "temp_day": 32, "temp_night": 21, "wind_dir_day": "南风", "wind_level_day": 3, "aqi_value": 29, "aqi_desc": "优" } ], "forecast_hour": [ { "predict_hour": 1778752800000, "condition": "多云", "temperature": 32, "humidity": 62, "wind_dir": "南风", "wind_level": "3", "aqi_value": 29 } ], "index": [ { "name": "限行", "status": "不限行" }, { "name": "穿衣", "status": "炎热" } ], "summary": "大化瑶族自治县，多云，32℃，南风3级，空气优。", "_cached": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/fund": { "get": { "operationId": "fund", "summary": "基金估值跟踪", "description": "基金估值跟踪，一接口聚合「基金实时估值 / 指数行情 / 基金详情 / 全部常用指数批量」4 大功能，覆盖国内基金 + A 股核心指数。\n\n基于天天基金、新浪财经、东方财富三路上游，无需注册即可调用：\n\n• action=estimate — 基金实时估值（盘中每分钟更新，含单位净值、估算净值、估算涨跌幅、上次净值日期）\n\n• action=index — 单个指数行情（新浪主、东方财富备双通道容灾，含当前点位、涨跌点、涨跌幅）\n\n• action=info — 基金详细信息（名称、净值、累计净值、近 1 月/3 月/6 月/1 年/3 年/成立来收益、基金类型、风险等级、规模、基金经理、成立日、管理人）\n\n• action=indices — 6 个常用指数批量（上证、深证成指、创业板、上证 50、沪深 300、中证 500）\n\n本接口已修复源码中「新浪通道缺 sh/sz 前缀」的 bug，并优化了 HTML 爬虫的容错。", "tags": [ "finance" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 200, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/fund", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/fund/raw.md", "parameters": [ { "name": "action", "in": "query", "required": true, "description": "操作类型：estimate=基金估值 / index=单个指数 / info=基金详情 / indices=全部常用指数", "schema": { "type": "string", "example": "estimate" }, "example": "estimate" }, { "name": "code", "in": "query", "required": false, "description": "基金或指数代码（6 位数字）；当 action 为 estimate/index/info 时必填，indices 时不需要", "schema": { "type": "string", "example": "005827" }, "example": "005827" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 50 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "action": "estimate", "fund_code": "005827", "fund_name": "易方达蓝筹精选混合", "nav_date": "2026-04-30", "net_value": 1.7393, "estimate": 1.727, "change_rate": -0.71, "update_time": "2026-05-06 15:00" }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/email-check": { "get": { "operationId": "email_check", "summary": "邮箱地址检测", "description": "综合性邮箱质量评估接口，一次请求完成 6 项检测：\n ① RFC 5322 格式校验\n ② 临时/一次性邮箱检测（基于 72,345 条开源域名库，3 个数据源合并去重）\n ③ MX 记录验证（用 AliDNS DoH，避开 PHP getmxrr 不稳定）\n ④ 拼写纠正（gmial.com → 提示 gmail.com）\n ⑤ 服务商识别（QQ邮箱/Gmail/网易/Outlook 等 40+ 主流邮箱）\n ⑥ 综合风险评分 0-100，附详细原因清单\n\n典型用例：用户注册时的反垃圾邮箱过滤、邮件营销列表清洗、KYC 风控辅助。", "tags": [ "kyc" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 500, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/email-check", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/email-check/raw.md", "parameters": [ { "name": "email", "in": "query", "required": true, "description": "要检测的邮箱地址，最长 254 字符（RFC 上限）", "schema": { "type": "string" } }, { "name": "X-API-Key", "in": "header", "required": false, "description": "API Key（不传走匿名额度）", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "email": "test@gmial.com", "input": "test@gmial.com", "valid_format": true, "local": "test", "domain": "gmial.com", "is_disposable": false, "disposable_match": null, "is_trusted": false, "provider": null, "has_mx": false, "mx_records": [], "spelling_suggestion": "gmail.com", "risk_score": 5, "risk_level": "invalid", "reasons": [ "⚠️ 域名无 MX 记录，无法接收邮件", "⚠️ 域名疑似拼写错误，建议用 gmail.com", "⚠️ 本地部分含测试/系统类关键词" ] }, "request_id": "mota..." } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/baby-naming": { "post": { "operationId": "baby_naming", "summary": "八字起名", "description": "输入父母姓氏与出生时间，基于「八字五行 + 五格数理 + 三才配置」综合评分生成高分名字候选，附寓意标签与全国重名预估。三个 action：naming（智能起名）/ duplicate（重名查询）/ bazi（八字查询）。内置 396 姓氏笔画 + 175 起名字 + 88 姓人口。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 50, "no_key_daily": 30 }, "x-doc-url": "https://www.apizero.cn/aidocs/baby-naming", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/baby-naming/raw.md", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "description": "naming（默认）/ duplicate / bazi" }, "surname": { "type": "string", "description": "naming/duplicate 必填；姓氏（≤ 2 字）", "example": "王" }, "mother_surname": { "type": "string", "description": "母姓（仅 naming，可选；填写则生成双姓名）" }, "birth_year": { "type": "number", "description": "naming/bazi 必填；2000-2100", "example": "2026" }, "birth_month": { "type": "number", "description": "naming/bazi 必填；1-12", "example": "5" }, "birth_day": { "type": "number", "description": "naming/bazi 必填；1-31", "example": "10" }, "birth_hour": { "type": "number", "description": "出生时辰；0-23，默认 12" }, "gender": { "type": "string", "description": "性别偏好：male/female/neutral，默认 neutral" }, "count": { "type": "number", "description": "返回名字数量；1-30，默认 10" }, "name": { "type": "string", "description": "duplicate 必填；要查的名字（不含姓）", "example": "梓涵" } }, "required": [ "surname" ] }, "example": { "surname": "王", "birth_year": "2026", "birth_month": "5", "birth_day": "10", "name": "梓涵" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "bazi": { "八字": "丙午癸巳辛未癸巳", "四柱": [ "丙午", "癸巳", "辛未", "癸巳" ], "日主": "金" }, "wu_xing_analysis": { "五行分布": { "金": 1, "木": 0, "水": 2, "火": 4, "土": 1 }, "五行缺失": [ "木" ], "建议补充": [ "木" ] }, "needed_wuxing": [ "木" ], "names": [ { "name": "王梓森", "surname": "王", "given_name": "梓森", "score": 95, "wuge": { "天格": 5, "人格": 15, "地格": 23, "外格": 16, "总格": 27 }, "wuge_score": 88, "wuxing_chars": "木+木", "meaning_tags": [ "栋梁", "繁盛" ], "duplicate_rate": { "estimated_count": 320, "level": "较低", "description": "..." } } ] }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/crazy-thursday": { "get": { "operationId": "crazy_thursday", "summary": "疯狂星期四文案", "description": "随机返回一段脑洞大开的 KFC「疯狂星期四」文学。内置 52 条精选文案，覆盖情感/搞笑/职场/文艺/学术/古风/悬疑/科幻/鸡汤/日常 10 个分类。支持随机、批量、分类列表与疯四倒计时。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 200, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/crazy-thursday", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/crazy-thursday/raw.md", "parameters": [ { "name": "action", "in": "query", "required": false, "description": "操作：random（默认）/ batch / categories / countdown", "schema": { "type": "string", "example": "random" }, "example": "random" }, { "name": "category", "in": "query", "required": false, "description": "分类筛选（仅 random/batch 用）：情感/搞笑/职场/文艺/学术/古风/悬疑/科幻/鸡汤/日常", "schema": { "type": "string", "example": "搞笑" }, "example": "搞笑" }, { "name": "count", "in": "query", "required": false, "description": "批量数量（仅 action=batch 用），1-20，默认 5", "schema": { "type": "number", "example": "5" }, "example": "5" }, { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "text": "我是秦始皇，我打下了万里江山，统一了六国文字和度量衡，但是我没有统一KFC疯狂星期四的价格。V朕50。", "category": "搞笑", "is_thursday": true, "thursday_tip": "今天就是疯狂星期四！冲！" }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/risk-score": { "post": { "operationId": "risk_score", "summary": "综合风控评分", "description": "输入手机号 / IP / 邮箱，秒级输出 0~100 风险分与放行/二次验证/拦截建议，专治注册薅羊毛、批量养号、营销作弊。三维信号：手机号识别虚拟运营商与物联网卡号段，IP 识别代理/VPN/机房与风险分，邮箱识别临时邮箱与 MX 异常。一次调用拿到可直接用于业务决策的结论。", "tags": [ "kyc" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 20, "no_key_daily": 0 }, "x-doc-url": "https://www.apizero.cn/aidocs/risk-score", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/risk-score/raw.md", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "mobile": { "type": "string", "description": "手机号（11 位手机号或 13 位物联网卡号），识别虚拟运营商/物联网卡", "example": "17012345678" }, "ip": { "type": "string", "description": "IPv4/IPv6 地址；传 self 检测调用者自身 IP", "example": "47.88.1.1" }, "email": { "type": "string", "description": "邮箱地址，识别临时邮箱/MX/本地异常", "example": "abc@guerrillamail.com" }, "scene": { "type": "string", "description": "业务场景 register/login/order/coupon，默认 register", "example": "register" } } }, "example": { "mobile": "17012345678", "ip": "47.88.1.1", "email": "abc@guerrillamail.com", "scene": "register" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "risk_score": 88, "risk_level": "critical", "decision": "reject", "checked": { "mobile": true, "ip": true, "email": true }, "hit_rules": [ { "code": "MOBILE_MVNO", "weight": 35, "desc": "虚拟运营商号段（170），实名宽松，薅羊毛高发" }, { "code": "EMAIL_DISPOSABLE", "weight": 35, "desc": "一次性/临时邮箱域名，典型用于注册套利" }, { "code": "IP_DATACENTER", "weight": 30, "desc": "机房/IDC IP（非真实用户网络，脚本批量常用）" } ], "signals": { "mobile": { "checked": true, "input_mask": "170****5678", "valid": true, "number_type": "mvno", "carrier": "虚拟运营商", "risk": "high" }, "email": { "checked": true, "email": "abc@guerrillamail.com", "valid_format": true, "is_disposable": true, "is_trusted": false, "has_mx": true, "risk": "high" }, "ip": { "checked": true, "ip": "47.88.x.x", "valid": true, "is_private": false, "is_proxy": false, "is_datacenter": true, "province": "", "isp": "阿里云", "risk": "medium" } }, "scene": "register" }, "request_id": "k9x2p4mabc12" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/gold": { "get": { "operationId": "gold", "summary": "黄金价格查询", "description": "实时黄金价格聚合查询，一次返回三大维度的金价数据：\n\n• 国际黄金报价（4 项）：国际金价、国际铂金、国际银价、国际钯金，含最新价 / 涨跌额 / 涨跌幅 / 最高价 / 最低价 / 报价时间\n\n• 国内黄金报价（7 项）：国内金价、国内银价、投资金条、黄金回收价格、铂金回收价格、18K 金回收价格、钯金回收价格\n\n• 十大品牌金店金价（17 家）：内地周大福、周生生、六福珠宝、老凤祥、老庙黄金、中国黄金、周六福、菜百、明牌珠宝、潮宏基等十大品牌的当日黄金 / 铂金 / 金条价格（元/克）\n\n通过参数 type 可只取某一类（all=全部，brand=品牌金店，international=国际，domestic=国内）。\n\n基于 huangjinjiage.cn 数据源，已修复源码 GBK 编码乱码 bug，内建 10 分钟缓存。", "tags": [ "finance" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 5, "daily_free_limit": 200, "no_key_daily": 50 }, "x-doc-url": "https://www.apizero.cn/aidocs/gold", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/gold/raw.md", "parameters": [ { "name": "type", "in": "query", "required": false, "description": "返回类型：all=全部（默认）/ brand=品牌金店 / international=国际黄金 / domestic=国内黄金", "schema": { "type": "string", "example": "all" }, "example": "all" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 50 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "update_time": "2026-05-06 15:30:00", "source": "huangjinjiage.cn", "type": "all", "international": [ { "name": "国际金价", "price": "4647.3", "change": "7.19", "percent": "0.39%", "high": "1828.34", "low": "1815.50", "time": "2026-5-6" }, { "name": "国际银价", "price": "75.28", "change": "0.21", "percent": "0.91%", "high": "23.24", "low": "22.78", "time": "2026-5-6" } ], "domestic": [ { "name": "国内金价", "price": "1022.9", "change": "2.08", "percent": "0.56%", "high": "375", "low": "372.76", "time": "2026-5-6" } ], "brand": [ { "brand": "内地周大福", "gold_price": "1413", "pt_price": "-", "bar_price": "1239", "unit": "元/克", "time": "2026-5-6" } ] }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/hash": { "get": { "operationId": "hash", "summary": "哈希加密计算", "description": "哈希加密计算，支持 12 种主流算法，可一次性返回全部，也可指定单个算法。支持 HMAC 签名模式与 hex / base64 双输出编码，毫秒级返回。\n\n• 通用摘要：MD5、SHA-1、SHA-256、SHA-384、SHA-512\n\n• 现代抗碰撞：SHA3-256、SHA3-512、RIPEMD-160、Whirlpool\n\n• 校验和：CRC32、CRC32B、Adler-32\n\n• HMAC 签名：传入 hmac_key 自动切换为 HMAC 模式（用于 API 签名 / 防篡改场景）\n\n• 输出编码：hex（默认，更可读）/ base64（节省 25% 字节，适合 URL 传输）\n\n纯本地计算，零外部上游依赖，毫秒级响应。HMAC 密钥仅参与计算，不写日志、不缓存、不回显。", "tags": [ "dev" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 20, "daily_free_limit": 1000, "no_key_daily": 200 }, "x-doc-url": "https://www.apizero.cn/aidocs/hash", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/hash/raw.md", "parameters": [ { "name": "text", "in": "query", "required": true, "description": "要计算哈希的文本，UTF-8 编码，最长 10000 字节（中文 1 字 = 3 字节，约支持 3300 个中文）", "schema": { "type": "string", "example": "hello" }, "example": "hello" }, { "name": "algorithm", "in": "query", "required": false, "description": "算法标识，默认 all。支持：all / md5 / sha1 / sha256 / sha384 / sha512 / sha3-256 / sha3-512 / ripemd160 / whirlpool / crc32 / crc32b / adler32（自动兼容无连字符写法 sha3256）", "schema": { "type": "string", "example": "all" }, "example": "all" }, { "name": "encoding", "in": "query", "required": false, "description": "输出编码：hex（默认，更可读）/ base64（节省 25% 字节）", "schema": { "type": "string", "example": "hex" }, "example": "hex" }, { "name": "hmac_key", "in": "query", "required": false, "description": "HMAC 密钥，传入则自动切换为 HMAC 模式生成签名；密钥仅参与计算，不写入任何日志或缓存", "schema": { "type": "string", "example": "mysecret" }, "example": "mysecret" }, { "name": "Authorization", "in": "header", "required": false, "description": "API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 200 次免费）", "schema": { "type": "string", "example": "Bearer sk_live_xxxxxxxxxxxxxx" }, "example": "Bearer sk_live_xxxxxxxxxxxxxx" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "text_length": 5, "text_bytes": 5, "encoding": "hex", "hmac": false, "hash_count": 3, "hashes": { "md5": { "algorithm": "MD5", "bits": 128, "value": "5d41402abc4b2a76b9719d911017c592", "length": 32 }, "sha1": { "algorithm": "SHA-1", "bits": 160, "value": "aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d", "length": 40 }, "sha256": { "algorithm": "SHA-256", "bits": 256, "value": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824", "length": 64 } } }, "request_id": "abc123def456" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/nine-grid-cutter": { "post": { "operationId": "nine_grid_cutter", "summary": "九宫格切图", "description": "上传一张图片（multipart 文件 / base64 / URL 三选一），自动居中裁切为正方形后均分为 N×N 宫格小图，按朋友圈发图顺序返回（左到右、上到下编号 1..N²）。支持 2×2 / 3×3 / 4×4，可设置切片间留白，输出 base64 数组或直接下载 zip。", "tags": [ "dev" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 2, "daily_free_limit": 50, "no_key_daily": 20 }, "x-doc-url": "https://www.apizero.cn/aidocs/nine-grid-cutter", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/nine-grid-cutter/raw.md", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "file": { "type": "string", "description": "图片文件（multipart 上传，三选一之一），支持 jpg/png/webp/gif" }, "image_base64": { "type": "string", "description": "图片 base64（dataURL 或纯 base64，三选一）" }, "image_url": { "type": "string", "description": "公网图片 URL（http/https，三选一）" }, "grid": { "type": "number", "description": "宫格数：2 / 3 / 4，默认 3", "example": "3" }, "gap": { "type": "number", "description": "切片间留白像素 0-20，默认 0", "example": "0" }, "output": { "type": "string", "description": "输出格式：base64（默认，JSON）/ zip（直接返回 application/zip）", "example": "base64" } } }, "example": { "grid": "3", "gap": "0", "output": "base64" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "grid": "3x3", "total": 9, "gap": 0, "original_size": "1080x1920", "square_side": 1080, "cell_size": "360x360", "source": "multipart", "pieces": [ { "index": 1, "size": "360x360", "base64": "iVBORw0K...", "data_url": "data:image/png;base64,iVBORw0K..." }, { "index": 2, "size": "360x360", "base64": "...", "data_url": "..." } ] }, "request_id": "abc123" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/address-parse": { "post": { "operationId": "address_parse", "summary": "中文地址解析", "description": "一行 API 从中文地址字符串中提取「省市区街道 + 详细地址 + 姓名 + 手机号 + 邮编」。\n\n适用场景：电商收货地址自动拆分、快递下单页智能填充、CRM 客户资料清洗、办公地址结构化入库。\n\n特点：纯本地正则算法，无任何上游依赖，毫秒级响应；支持 34 个省级行政区及其简称识别（如「北京」→「北京市」、「新疆」→「新疆维吾尔自治区」）；支持快递场景下「张三 138xxxxxxxx 上海市浦东新区xx路xx号 200000」这类混合输入的自动拆分。", "tags": [ "geo" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 20, "daily_free_limit": 1000, "no_key_daily": 100 }, "x-doc-url": "https://www.apizero.cn/aidocs/address-parse", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/address-parse/raw.md", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "中文地址字符串。支持姓名/手机/邮编混合输入，长度 ≤ 500", "example": "张三 13812345678 上海市浦东新区张江镇科苑路88号 201203" } }, "required": [ "address" ] }, "example": { "address": "张三 13812345678 上海市浦东新区张江镇科苑路88号 201203" } } } }, "parameters": [ { "name": "Authorization", "in": "header", "required": false, "description": "Bearer sk_live_xxx（可选；未登录匿名调用受更严格的限流）", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "original": "张三 138****1234 上海市浦东新区张江镇科苑路88号 201203", "province": "上海市", "city": "上海市", "district": "浦东新区", "street": "张江镇", "detail": "科苑路88号", "zipcode": "201203", "phone": "138****1234", "name": "张三" }, "request_id": "kx8n9q2a1b3c4d5e6f7g" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/bencao": { "get": { "operationId": "bencao", "summary": "本草纲目·中药查询", "description": "传统中药材知识查询接口，覆盖《本草纲目》及常见中药材数据。输入药材名称（如「人参」「丁香」「甘草」「枸杞」），返回该药材的释名、气味、主治、附方等详细记载。\n\n【典型场景】\n- 中医养生 / 食疗 App 的药材百科\n- 中药知识科普类小程序\n- AI 中医问诊辅助参考\n- 古籍数字化项目\n- 国学 / 中医文化教学\n\n【调用示例】\nGET /api/bencao?msg=人参\nGET /api/bencao?msg=丁香\nGET /api/bencao?msg=甘草\n\n【模糊匹配】\n- 精确名称查得到 → 直接返回详情（matched=exact）\n- 找不到时返回 4040 + suggestions 数组（最多 10 个相关建议）\n- 比如查「人参枸杞」会建议「人参、枸杞」等单味药\n\n【⚠️ 数据来源说明】\n本接口数据整理自《本草纲目》及网络公开整理资料，仅供学习参考；中医药疗用请遵医嘱。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 10, "daily_free_limit": 10000, "no_key_daily": 1000 }, "x-doc-url": "https://www.apizero.cn/aidocs/bencao", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/bencao/raw.md", "parameters": [ { "name": "msg", "in": "query", "required": true, "description": "药品名称（中文），如：人参、丁香、甘草、当归、枸杞。最长 50 个字符。", "schema": { "type": "string", "example": "人参" }, "example": "人参" }, { "name": "Authorization", "in": "header", "required": false, "description": "可选 API Key 鉴权。未登录每天 30 次免费体验", "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "name": "人参", "detail": "「释名」黄参、神草、土精、血参...\n「气味」（根）甘、温、无毒...\n「主治」补五脏，安精神...", "matched": "exact" }, "request_id": "mqx8x12345abc" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/hitokoto": { "get": { "operationId": "hitokoto", "summary": "一言 · 经典语录", "description": "从 370+ 条经典语录库（动漫/漫画/游戏/文学/影视/诗词/哲学/网络等 12 类）随机返回一条，含原文、出处、作者、分类、字数。支持按分类与长度筛选。", "tags": [ "life" ], "x-pricing": { "mode": 1, "point_cost": 0, "qps_limit": 20, "daily_free_limit": 500, "no_key_daily": 200 }, "x-doc-url": "https://www.apizero.cn/aidocs/hitokoto", "x-doc-markdown-url": "https://www.apizero.cn/aidocs/hitokoto/raw.md", "parameters": [ { "name": "c", "in": "query", "required": false, "description": "分类单字母 a-l（不传则全类别随机）", "schema": { "type": "string", "example": "i" }, "example": "i" }, { "name": "min_length", "in": "query", "required": false, "description": "最小字符数", "schema": { "type": "number" } }, { "name": "max_length", "in": "query", "required": false, "description": "最大字符数", "schema": { "type": "number" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkEnvelope" }, "example": { "code": 0, "msg": "成功", "data": { "id": 1234, "hitokoto": "落霞与孤鹜齐飞，秋水共长天一色。", "type": "i", "type_name": "诗词", "from": "滕王阁序", "from_who": "王勃", "length": 16, "total_pool": 370 } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamError" } } } }, "/api/tts": { "post": { "operationId": "tts", "summary": "TTS 语音合成", "description": "对接 alapi.cn 文本转语音（TTS）服务，输入文本返回 base64 编码的 MP3 音频。\n\n• **5 种音色**：女声主播 / 男声主播 / 男声说唱 / 女声四川话 / 男声低沉\n• **500 字以内**：单次请求最多 500 字符（中英文均按 1 字符计）\n• **MP3 格式**：上游返回 audio/mpeg 编码，前端可直接 `