积分余额

请求参数

这个接口没有参数。

请求示例

curl "https://seo-api.org/api/v1/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

返回 { creditsRemaining }。命令行工具的 login 用它校验 key。

{ "ok": true, "data": { "creditsRemaining": 99 } }

错误码

• SEO_API.MISSING_API_KEY

  HTTP401

  含义没有 Authorization 头，也没有 x-api-key 头。

• SEO_API.INVALID_API_KEY

  HTTP401

  含义key 不存在或已被撤销。

• SEO_API.INVALID_DOMAIN

  HTTP400

  含义缺少 domain 参数，或者它不是域名（IP 会被拒绝）。

• BILLING.INSUFFICIENT_CREDITS

  HTTP402

  含义账号积分用完了。24 小时内的重复查询仍然可用。

• SYSTEM.INTERNAL_SERVER_ERROR

  HTTP500

  含义我们这边出了问题，请退避后重试。

通过 MCP 调用

工具名 get_credit_balance，参数与返回内容和 REST 调用一致。

{
  "name": "get_credit_balance",
  "arguments": {}
}

通过命令行调用

npx @seo-api/cli credits