Lingara Lingara 文档 学习指南 API 库 应用 构建 网页版
语言: 中文简体

获取剩余额度

API 版本 2026-10-affable-towhee

get https://api.getlingara.com/v1/usage

列出适用于你账户的每项额度,包括已使用量和重置时间。

权限范围 usage:read

参数

Lingara-Versionheaderstring可选
回应此请求所用的 API 版本。不提供时,访问令牌使用其客户端绑定的版本,不带令牌的请求使用当前版本。仍在开发中的版本只能通过在此指定来访问。未知版本会以 400 回应,代码为 api_version_unknown。GET /v1/versions 会列出所有版本。

响应

200 你的额度

allowancearray of AllowanceRow必填
featurestring必填
windowstring必填
limitinteger必填
usedinteger必填
remaininginteger必填
reset_atinteger | null可选
ledgerUsageLedger | null可选

此客户端自每月一日 UTC 午夜以来的调用次数和单位数。仅在按用量计费的客户端上出现,其调用不消耗额度。可能比你最近一次调用延迟最多五秒。

sincestring必填
callsinteger必填
unitsinteger必填

错误

410application/json
回应此请求所用的 API 版本已停用。请在 Lingara-Version 中发送一个受支持的版本,或将客户端绑定到其他版本。
4XXapplication/json
请求被拒绝。code 说明原因,error 用文字描述原因。
503application/json · text/plain
服务暂时不可用;请在 Retry-After 所示的秒数之后重试。维护期间,响应体为纯文本,而不是错误信封。
5XXapplication/json
请求被拒绝。code 说明原因,error 用文字描述原因。
codestring必填

请求被拒绝的原因,以稳定的代码表示,可据此进行分支处理:例如 insufficient_scope(403)、rate_limited(429),以及按用量计费的客户端的 spend_cap_reached(402)和 metered_billing_inactive(402)。

errorstring必填

示例

代码示例语言

curl

curl "https://api.getlingara.com/v1/usage" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

TypeScript

const usage = await client.getUsage();
for (const row of usage.allowance) {
  console.log(row.feature, row.window, `${row.remaining} of ${row.limit} left`);
}

Rust

let usage = client.get_usage().await?;
for row in &usage.allowance {
    println!("{} {}: {} of {} left", row.feature, row.window, row.remaining, row.limit);
}

Go

usage, err := client.GetUsage(ctx)
if err != nil {
	return err
}
for _, row := range usage.Value.Allowance {
	fmt.Printf("%s (%s): %d of %d left\n", row.Feature, row.Window, row.Remaining, row.Limit)
}

Java

import com.getlingara.client.model.AllowanceRow;
import com.getlingara.client.model.Usage;

Usage usage = client.getUsage().body();
for (AllowanceRow row : usage.getAllowance()) {
  System.out.println(
      row.getFeature()
          + " ("
          + row.getWindow()
          + "): "
          + row.getRemaining()
          + " of "
          + row.getLimit()
          + " left");
}

Kotlin

val usage = client.getUsage().body
for (row in usage.allowance) {
    println("${row.feature} (${row.window}): ${row.remaining} of ${row.limit} left")
}

Ruby

usage = client.get_usage.value
usage.allowance.each { |row| puts "#{row.feature} (#{row.window}): #{row.remaining} of #{row.limit} left" }
puts "#{usage.ledger.calls} calls this month" if usage.ledger

PHP

foreach ($client->getUsage()->value->getAllowance() as $row) {
    echo $row->getFeature(), ': ', $row->getRemaining(), ' of ', $row->getLimit(), ' left this ', $row->getWindow(), "\n";
}

更喜欢用库?请参阅“库”部分。

如译文与英文参考文档不一致,以英文参考文档为准。