← 返回接入教程
GET

/api/proxy/usage · Usage 用量

查询当前 API Key 所属账号的 Credit。不扣费,不调用上游,不写调用日志。MCP 工具名 usage,无参数。remaining = poolRemaining + prepaidCredits。

响应字段
参数
类型
说明
remaining
integer响应字段。剩余可用 credit = 套餐池剩余 + 备用
maxCredits
integer响应字段。套餐池大小(含推荐加成、管理端加成)
prepaidCredits
integer响应字段。备用 credit(购买或签到的储备,不随套餐池清零)
creditsUsed
integer响应字段。套餐池已消耗
poolRemaining
integer响应字段。套餐池剩余,下限为 0
代码示例
cURL
Python
JavaScript
Go
curl https://tavily.sharyuke.com/api/proxy/usage \
  -H "Authorization: Bearer thb-xxxxxxxx"
响应示例
{ "code": 0, "message": "success", "data": { "remaining": 135, "maxCredits": 115, "prepaidCredits": 50, "creditsUsed": 30, "poolRemaining": 85 } }
错误码
错误码
含义
处理建议
400请求参数错误检查请求体字段
401API Key 无效检查 Authorization 头
429超过速率限制降低请求频率
500内部错误稍后重试或联系支持
503上游服务不可用网关已自动重试,请稍候

准备好接入了吗?

邮箱注册即可免费使用,每月 3,600 次免费调用,无需信用卡。