❓ 帮助中心

快速入门指南、接口调用教程和常见问题解答，帮助你快速上手 TinyAPI。

🚀 快速入门

只需三步即可开始调用 API 接口：

1

注册账号

访问 用户中心，填写用户名和密码完成注册。

2

获取 API Key

注册成功后登录，系统自动生成 API Key（格式：sk_xxxxxx），在控制台概览页即可看到。

3

开始调用

在请求头中携带 API Key 即可调用接口，详见下方示例。

📡 调用示例

💡 说明：除特殊标注外，所有 API 同时支持 GET 和 POST 两种请求方式。GET 用 URL 参数（?key=value），POST 用 JSON Body（{"key":"value"}），两者效果完全相同。

GET 请求（以 IP 查询为例）

curl "https://api.tinyaii.top/v1/ip?ip=8.8.8.8" \ -H "Authorization: Bearer sk_your_api_key"

POST 请求（同样的 API，用 JSON Body）

curl -X POST "https://api.tinyaii.top/v1/ip" \ -H "Authorization: Bearer sk_your_api_key" \ -H "Content-Type: application/json" \ -d '{"ip": "8.8.8.8"}'

Python 示例

import requests API_KEY = "sk_your_api_key" BASE_URL = "https://api.tinyaii.top" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # GET 请求（推荐） resp = requests.get(f"{BASE_URL}/v1/weather", params={"city": "北京"}, headers=HEADERS) print(resp.json()) # POST 请求（效果相同） resp = requests.post(f"{BASE_URL}/v1/weather", headers={**HEADERS, "Content-Type": "application/json"}, json={"city": "北京"}) print(resp.json())

JavaScript 示例

const API_KEY = "sk_your_api_key"; const BASE = "https://api.tinyaii.top"; const headers = { "Authorization": `Bearer ${API_KEY}` }; // GET 请求 const resp1 = await fetch(`${BASE}/v1/ip?ip=8.8.8.8`, { headers }); console.log(await resp1.json()); // POST 请求（效果相同） const resp2 = await fetch(`${BASE}/v1/ip`, { method: 'POST', headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify({ ip: "8.8.8.8" }) }); console.log(await resp2.json());
💡 提示：你也可以在 API 列表页 点击任意接口卡片，进入详情页使用在线调试面板直接测试。

📂 接口分类

TinyAPI 提供 352+ 个免费 API 接口，涵盖以下 36 个分类：

🤖 AI 智能 & 模型市场

模型市场（/v1beta）：OpenAI 兼容大模型接口，支持 DeepSeek-V4-Pro、glm-5.2 等多个模型，流式输出、函数调用，使用独立 skm_ Key 按次计费（Tiny-￥）。另有 AI 识图、AI 绘画、OCR 文字识别、语音转文字、音频纠错、人声伴奏分离、智能搜索、文本向量化等 18+ 个接口。

🎮 游戏专区（16 个游戏分类）

三角洲行动（13）、王者荣耀（28）、Steam（22）、暗区突围（9）、永劫无间（4）、明日方舟（11）、洛克王国（15）、PUBG（3）、崩坏星穹铁道（2）、原神（1）、绝区零（3）、鸣潮（1）、异环（4）、奶块（2）、泰拉瑞亚（5）、我的世界（2）、米游社（4）等，每个游戏独立分类，数据精准。

🎨 随机壁纸

原神、崩铁、明日方舟、碧蓝航线、FGO、初音、东方、偶像大师、Re:Zero、赛马娘、孤独摇滚、电锯人、EVA、宝可梦、LoL、公主连结、FF、五等分、赛博朋克、战双、崩三、Nier、兔女郎、守望先锋、狐妖、斗罗等 42 个主题随机壁纸接口。

📺 哔哩哔哩

哔哩哔哩视频解析、用户评论、用户弹幕、直播弹幕、直播统计、直播分区、用户名查询等 9 个接口。

🎵 网易云音乐

搜索、歌曲URL、排行榜、歌单、歌词、专辑、评论等 8 个接口，支持 FLAC 无损直链。

🎬 短视频解析

支持哔哩哔哩、快手、抖音、小红书等多平台短视频去水印解析，4 套解析源自动切换。

💾 网盘解析

网盘资源搜索（影视/游戏/软件）、诚通网盘、123盘、奶牛快传、蓝奏云等解析接口。

🔥 热榜资讯

聚合热榜（60+平台）、科技资讯、GitHub热门、历史今天、NBA赛事、足球赛程等 13 个接口。

🚗 生活查询

天气查询与预报、油价查询、黄金价格、节假日、星座运势、手机归属地、汇率转换、城际路线、骚扰电话等 19 个接口。

📚 文学百科

古诗词查询（4接口）、维基百科搜索与摘要等 6 个接口。

🌐 网络工具

IP归属地查询、DNS查询、WHOIS查询、域名ICP备案、微博反查等 10 个接口。

🛠️ 开发 & 工具

开发工具（10个）：二维码、正则、JSON、UUID、进制转换、单位转换等。加密解密（9个）：MD5、SHA、AES、Base64、JWT等。文本处理（11个）：翻译、敏感词、拼音、简繁转换等。图片工具（9个）：图床上传、Bing壁纸、AI绘画等。实用工具（7个）：短链、临时邮箱、Steam下载等。

🎲 趣味娱乐 & 杂项

趣味娱乐（13个）：一言、毒鸡汤、歇后语、KFC、答非所问等。快递查询（4个）：快递查询、物流追踪等。QQ（5个）：QQ估价、QQ查ICP等。杂项工具（5个）：时间戳、颜色、身份证等。

🔑 认证与限制

认证方式

所有 /v1/ 接口需在请求头携带 Authorization: Bearer sk_xxx。友链接口（/v1/friend-links）无需认证。模型市场（/v1beta）使用独立的 skm_ Key（用户中心「大模型」页面生成），与普通 sk_ Key 不通用。

调用限额

每位用户每日可免费调用 100,000 次（UTC+8 每日 00:00 自动重置）。可在用户中心概览页查看当日已用次数。模型市场（/v1beta）额度独立，按次计费（Tiny-￥），失败自动退款。

提升额度

可通过兑换码提升每日调用额度。关注官方渠道获取兑换码（格式：TINY-XXXX-XXXX-XXXX），在用户中心兑换即可生效。

📋 OpenAPI 一键导入

如果你需要将 TinyAPI 的全部接口批量添加到 Bot、Postman、IDE 或其他工具中，无需逐个手动配置。我们提供标准的 OpenAPI 3.0 格式文档，一键导入即可。

文档地址：https://api.tinyaii.top/openapi.json

Postman 导入

1

打开 Postman → 点击左上角 Import

2

选择 Link 标签 → 粘贴 https://api.tinyaii.top/openapi.json → 点击 Import

3

自动生成 Collection，包含全部 352+ 个接口请求，设置变量 apikey 即可批量调用

Insomnia 导入

1

打开 Insomnia → Import/Export → From URL

2

粘贴 https://api.tinyaii.top/openapi.json → 自动生成全部接口

代码自动生成（SDK）

使用 openapi-generator 从 OpenAPI 文档自动生成各语言 SDK 代码：

# 安装工具 npm install @openapitools/openapi-generator-cli -g # 生成 Python SDK openapi-generator-cli generate -i https://api.tinyaii.top/openapi.json -g python -o tinyapi-python # 生成 Node.js SDK openapi-generator-cli generate -i https://api.tinyaii.top/openapi.json -g javascript -o tinyapi-js # 生成 Java SDK openapi-generator-cli generate -i https://api.tinyaii.top/openapi.json -g java -o tinyapi-java

Bot 框架接入

多数 Bot 框架（如 NoneBot2、Koishi、Suzhetech 等）支持从 OpenAPI 文档自动注册命令和接口，请参考对应框架的插件开发文档。

提示：OpenAPI 文档包含每个接口的路径、参数类型、返回格式和示例数据，完全结构化，机器可直接解析。

❔ 常见问题

如何注册获取 API Key？▼
访问 用户中心，点击注册按钮填写用户名和密码即可。注册成功后自动生成 API Key（格式：sk_xxxxxx），在控制台概览页可以查看和复制。
API Key 忘记了怎么办？▼
登录 用户中心 → API Key 页面，可以查看当前 Key。如需重置，可联系管理员。
调用接口返回 code 401 怎么办？▼
请检查：① 请求头是否包含 Authorization: Bearer sk_xxx；② API Key 是否正确（注意前后不要有空格）；③ API Key 是否已被重置或禁用。
调用接口返回 code 429 怎么办？▼
表示今日调用次数已达上限（默认 100,000 次/天）。请等待次日 00:00（UTC+8）自动重置。如需更多额度，可使用兑换码提升每日限额。
接口返回的数据不准确或不完整？▼
部分接口依赖第三方数据源，可能存在延迟或更新不及时的情况。请在 API 详情页通过反馈按钮提交问题，我们会尽快核实修复。
AI 对话接口支持哪些功能？▼
TinyAPI 提供两套 AI 对话接口：

① 模型市场（/v1beta/chat/completions）：OpenAI 兼容格式，支持多模型（DeepSeek-V4-Pro、glm-5.2 等）、流式输出（stream: true）、函数调用（Function Calling）。使用独立的 skm_ Key 认证，按次计费（Tiny-￥）。

② 经典 AI 对话（/v1/chat/completions）：简化调用，支持 {"prompt": "你的问题"} 或 OpenAI 格式 {"messages": [...]}，使用普通 sk_ Key。
sk_ 和 skm_ Key 有什么区别？▼
sk_ Key 用于调用全部 /v1/ 接口（天气、游戏、工具等），按每日次数限额（默认 100,000 次/天）。

skm_ Key 用于调用模型市场 /v1beta/ 接口（大模型对话），按次计费（Tiny-￥ 余额）。

两个 Key 在用户中心分别查看和生成，互不通用。调用 /v1beta 接口时如果使用 sk_ Key 会返回 401。
支持哪些游戏的兑换码查询？▼
目前支持以下游戏的兑换码查询：
① 原神：/v1/genshin/redeem（147个，国服+国际服）
② 崩坏星穹铁道：/v1/hsr/redeem（88个，国服+国际服）
③ 绝区零：/v1/zzz/redeem（28个）
④ 鸣潮：/v1/mc/redeem
⑤ 异环：/v1/nte/redeem

所有兑换码接口默认只返回有效的，传 all=true 可查看含过期的全部数据。
游戏图鉴/攻略类接口有哪些？▼
目前提供以下游戏图鉴/攻略接口：
① 绝区零图鉴：/v1/zzz/collection（201条，角色/音擎/驱动盘/邦布）+ /v1/zzz/collection/detail（含养成推荐和配队方案）
② 崩铁角色列表：/v1/hsr/characters（92个角色+7种元素）
③ 奶块药水：/v1/naikuai/potions（15种药水）+ /v1/naikuai/formula（248条配方）
④ 明日方舟：/v1/prts/*（8个接口）+ /v1/ark/*（3个剧情接口）
⑤ 三角洲行动：/v1/df/*（12个接口，含战备推荐/图鉴/价格等）
⑥ 暗区突围：/v1/aq/*（8个接口）
⑦ 永劫无间：/v1/naraka/search（玩家搜索+详情+对局）
如何提交反馈或功能建议？▼
在任意 API 详情页点击红色的「反馈」按钮，填写标题和描述即可提交。需先登录用户中心。管理员回复后可在反馈列表中查看。
如何批量导入所有 API 到我的项目/Bot？▼
TinyAPI 提供标准 OpenAPI 3.0 格式的接口文档，一键导入即可使用全部 API：

文档地址：https://api.tinyaii.top/openapi.json

导入方式：
① Postman：Import → Link → 粘贴上方地址 → 自动生成全部请求
② Insomnia：Import/Export → From URL → 粘贴上方地址
③ VS Code REST Client：安装 OpenAPI 扩展，加载文档即可
④ 代码生成：使用 openapi-generator 等工具，从文档自动生成 Python/Node.js/Java 等语言的 SDK 代码
⑤ Bot 框架：多数 Bot 框架支持从 OpenAPI 文档自动注册命令和接口

文档包含全部 352+ 个接口的路径、参数、返回格式和示例，无需逐个手动添加。
如何申请友链交换？▼
访问 友情链接 页面查看本站信息和申请须知。通过用户中心的反馈功能提交申请，注明「友链交换」。

📞 联系我们

如有任何问题或建议，欢迎通过以下方式联系我们：

  • 在任意 API 详情页提交反馈
  • 登录用户中心 → 反馈列表页提交