如何获取 API Key 并调用免费 API：新手图文教程
一句话回答
获取 API Key 只需三步：注册登录后，在用户中心「API 密钥」页面生成密钥，再以 apikey 参数拼接到接口地址发起调用；免费接口不扣费，免费用户每分钟最多调用 10 次，并需注意密钥安全与错误码处理。
核心要点 TL;DR
- 注册登录后，进入用户中心「API 密钥」页面点击生成即可获得 Key
- 调用时把 apikey 作为参数拼接到接口地址上即可发起请求
- 免费接口不扣费，免费用户默认每分钟最多 10 次调用
- 密钥不要写进前端代码或公开仓库，可设置 IP 白名单
- 超出频率限制返回 429，建议加入限流与重试逻辑
第一步：注册并登录#
打开 注册页面，填写用户名、邮箱与密码完成注册，然后使用同一账号登录。
第二步：获取 API Key#
登录后进入用户中心「API 密钥」页面，点击生成即可获得一串 API Key。请妥善保存，不要将密钥直接暴露在前端代码或公开仓库中，建议通过服务端转发请求或在调用时限制来源 IP（用户中心支持设置 IP 白名单）。
第三步：发起调用#
以随机动漫壁纸接口为例：
示例说明：以下代码仅用于逻辑验证，生产环境需补充异常处理、超时与重试、日志与监控告警及降级策略。
curl "https://www.api.plus/api/dongman?apikey=你的APIKEY&type=json"返回示例：
{
"code": 200,
"message": "success",
"data": {
"url": "https://www.api.plus/api/dongman/desktop/xxx.jpg",
"size": "850.65 KB"
}
}计费与频率限制#
免费接口不扣费，可直接调用；收费接口按次计费，调用前请确认余额充足。免费用户默认每分钟最多 10 次调用，付费用户根据套餐不同享有更高限制，超出限制会返回 429 状态码，建议在代码中加入限流与重试逻辑。
错误码速查#
- 400：缺少 API Key 或参数不合法；
- 401：API Key 无效或已被封禁；
- 429：请求频率超出限制；
- 500：服务端异常，请稍后重试或联系我们。
延伸阅读#
想直接动手的话，可以先看这些接口文档和相关文章：
常见问题（FAQ）
如何获取 API Key？
注册并登录后进入用户中心「API 密钥」页面，点击生成即可获得一串 API Key；请妥善保存，不要直接暴露在前端代码或公开仓库中。
免费 API 调用会扣费吗？
不会。免费接口不扣费，可直接调用；收费接口按次计费，调用前需确认账户余额充足。
免费用户的调用频率有限制吗？
有。免费用户默认每分钟最多 10 次调用，付费用户按套餐享有更高限制，超出限制会返回 429 状态码。
接口返回 401 是什么原因？
表示 API Key 无效或已被封禁，请检查密钥是否填写正确，必要时重新生成密钥。
怎样安全使用 API Key？
建议通过服务端转发请求，或在用户中心设置 IP 白名单限制来源，不要把密钥写进前端代码或公开仓库。
