❓ 帮助中心
快速入门指南、接口调用教程和常见问题解答，帮助你快速上手 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 列表页 点击任意接口卡片，进入详情页使用在线调试面板直接测试。
📂 接口分类
🌐 网络工具
IP归属地查询、DNS查询、WHOIS查询等网络诊断工具。
🌤️ 生活服务
天气查询与预报、油价查询、快递查询、星座运势、手机归属地、汇率转换等日常生活接口。
🛠️ 开发工具
二维码生成、正则测试、JSON格式化、网站地图生成、头像生成、B站视频信息等开发者常用工具。
🔒 加密编码
MD5、SHA256 散列，AES 加解密，Base64 编解码，URL 编解码等安全与编码工具。
🔥 热榜资讯
聚合热榜（60+平台）、科技资讯、GitHub热门、热门电影、NBA赛事、足球赛程等实时资讯。
🤖 AI 智能
AI 对话（Qwen3.6-Plus）、AI 识图、AI 绘画、AI 文本检测、AI 菜品识别、文本向量化、文档重排序等 AI 类接口。
🎮 游戏娱乐
洛克王国图鉴、明日方舟数据库、王者荣耀战力查询、MC服务器状态等游戏相关接口。
🎨 随机图片
原神、崩坏星穹铁道、明日方舟、碧蓝航线、崩坏3、鸣潮、动漫、王者荣耀等 14 个主题随机壁纸。
🔑 认证与限制
认证方式
所有 /v1/ 接口需在请求头携带 Authorization: Bearer sk_xxx。友链接口（/v1/friend-links）无需认证。
调用限额
每位用户每日可免费调用 100,000 次（UTC+8 每日 00:00 自动重置）。可在用户中心概览页查看当日已用次数。
提升额度
可通过兑换码提升每日调用额度。关注官方渠道获取兑换码（格式：TINY-XXXX-XXXX-XXXX），在用户中心兑换即可生效。
❔ 常见问题
如何注册获取 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 对话接口支持哪些功能？▼
AI 对话接口（
/v1/chat/completions）支持两种参数格式：① {"prompt": "你的问题"} 简化调用；② {"messages": [{"role":"user","content":"..."}]} OpenAI 兼容格式。每人并发限制 3 路。如何提交反馈或功能建议？▼
在任意 API 详情页点击红色的「反馈」按钮，填写标题和描述即可提交。需先登录用户中心。管理员回复后可在反馈列表中查看。
如何申请友链交换？▼
访问 友情链接 页面查看本站信息和申请须知。通过用户中心的反馈功能提交申请，注明「友链交换」。
📞 联系我们
如有任何问题或建议，欢迎通过以下方式联系我们：
- 在任意 API 详情页提交反馈
- 登录用户中心 → 反馈列表页提交