Docs认证 (Auth)

认证 (Authentication)

所有 FindIP API 请求都需要通过 Authorization 头进行 Bearer 令牌认证。

API 密钥格式

API 密钥格式为 psk_live_xxxxxxxxxxxxxxxx。在仪表盘中可生成和管理密钥。

注意

请妥善保管 API 密钥。不要暴露在客户端代码、公开仓库或浏览器请求中。请使用服务器环境变量或服务器端代理。

发送已认证请求

将 API 密钥放入 Authorization 头并加 Bearer 前缀。

cURL

curl -X POST https://api.findip.ai/search \
-H "Authorization: Bearer psk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"query": "semiconductor etching process", "top_k": 5}'

Python

import requests

response = requests.post(
  "https://api.findip.ai/search",
  headers={
      "Authorization": "Bearer psk_live_your_api_key",
      "Content-Type": "application/json",
  },
  json={
      "query": "semiconductor etching process",
      "top_k": 5,
  },
)
data = response.json()

JavaScript (Node.js)

const response = await fetch("https://api.findip.ai/search", {
method: "POST",
headers: {
  "Authorization": "Bearer psk_live_your_api_key",
  "Content-Type": "application/json",
},
body: JSON.stringify({
  query: "semiconductor etching process",
  top_k: 5,
}),
});
const data = await response.json();

请求限额 (Rate Limiting)

检索调用从订阅套餐的月度额度中扣除。详情·附图·编号查询不计入额度。超过额度时 API 将返回 429 Too Many Requests。所有调用还另有每分钟 60 次的速率限制。

套餐	每月检索额度
免费 (Free)	每月 30 次
基础 (Basic)	每月 300 次
专业 (Pro)	每月 1,000 次
企业	另行协商

密钥管理

在仪表盘中可方便地管理 API 密钥。

按环境（开发、生产）发行多个密钥
立即吊销（Revoke）泄露的密钥
监控每个密钥的使用量和请求日志

Search API Next: 错误代码