1. 系统 API(客户可用)
心流API 接口文档
  • 引言
  • 在线调试说明
  • 发出请求
  • 中转站基本介绍
    • API 快速开始指南
    • 联系客服
    • 代理接口调用地址
    • API Key 额度查询服务
  • 通用接口
    • 文本通用接口
      POST
    • 图片通用接口
      POST
    • 视频通用接口
      POST
  • 图像模型
    • GPT Image 2(OpenAI 生图)
      • GPT Image 2 文生图
      • GPT Image 2 图生图(编辑)
    • Gemini Nano Banana(Google 生图)
      • Gemini Nano Banana 图片生成
      • 文本通用接口(Gemini 原生格式)
    • Grok Imagine(xAI 生图)
      • Grok 文生图(同步)
  • 视频模型
    • Grok Imagine 1.0 视频
      • Grok Imagine 1.0 视频生成
    • Grok Imagine 1.5 Video Preview(xAI 文生/图生视频)
      • Grok Imagine Video Preview 视频生成
      • Grok Imagine Video 1.5 Preview 视频生成
    • Grok Imagine 1.5 720p(xAI 图生视频)
      • Grok Imagine 1.5 Super 视频生成
    • Veo(Google 视频生成)
      • Veo 视频生成
      • Veo 视频延长(Extend)
    • Omni 系列(omni_flash · 文生 / 图生 / 视频修改)
      • Omni 视频生成(omni_flash-10s)
    • Grok Video 3 系列(xAI 新族)
      • Grok Video 3 视频生成
    • Sora 2(OpenAI 视频生成)
      • Sora 2 视频生成
    • Grok Video 10s
      • Grok Video 6s/10s/12s 视频生成
    • HappyHorse 1.0 系列(阿里淘天)
      • HappyHorse 1.0 视频生成
    • 豆包 Seedance 2.0 Fast
      • 豆包 Seedance 2.0 Fast 视频生成
    • 视频任务查询(共用)
      GET
    • 视频内容下载(共用)
      GET
  • 系统 API(客户可用)
    • 拉取模型列表
      GET
    • 查询当前令牌用量
      GET
    • 系统状态 / 公告
      GET
  • 各种插件/软件使用教程
    • Codex 配置教程
    • OpenClaw Clawdbot 自定义中转站配置教程
    • N8N 工作流使用中转API 教程
    • opencode 配置教程
    • Gemini CLI 中转站配置使用教程
    • Claude Code 安装使用教程
    • CherryStudio调用cluade MCP
    • Cherry Studio配置教程
    • Cherry Studio配置 banana pro 4K和分辨率教程
    • CherryStudio配置o4推理级别
    • 扣子工作流简单配置从输入到获取url
    • dify添加模型
    • cline 配置教程
    • aider 配置教程
    • Cursor 配置教程
    • lobechat 设置教程
    • ChatBox(推荐使用)
    • 开源gpt_academic
    • nextchat 设置教程
    • zotero gpt 配置方法
    • CLAUDE DEV 配置教程
    • 沉浸式翻译 设置gpt翻译
    • 浏览器插件ChatGPT Sidebar
    • chatgpt-on-wechat 配置教程
    • chatgpt GPT Academic 学术优化配置gpt教程
    • RikkaHub 配置教程
    • coze 工作流使用中转API 教程
    • n8n 工作流获取本地图片生成视频例子
    • OpenClaw 最新版本 自定义中转站配置教程
    • OpenClaw配合CC switch自定义中转站配置教程
  • 帮助中心
    • AI返回字段: 思考相关
    • HTTP状态码及其含义
    • 自建图床API
  • Python配置方式
    • python 使用 语音转文本
    • python 使用文本转语音
    • python 使用Embeddings 向量化
    • python 调用DALL·E
    • python简单调用 openai function-calling demo
    • python 简单langchain 调用openai demo
    • python llama_index 配置
    • Python基础对话
    • Python使用gpt-4o识别图片-本地图片
    • Python使用gpt-4o识别图片
    • Python使用Claude识别图片
    • python 库流式输出
    • gpt realtime模型调用
    • python request 请求 流式输出demo
    • python 使用gpt-image-1 创建编辑图片
    • python openai官方库(使用AutoGPT,langchain等)
    • python 连续对话
  • php配置方式
    • php使用图片编辑demo
  • nodejs 配置方式
    • nodejs 基础对话
  1. 系统 API(客户可用)

查询当前令牌用量

GET
/api/usage/token/

查询当前令牌用量#

返回当前 API Key 的累计用量、剩余额度、过期时间、是否无限额度等。

接入地址#

线路Base URL说明
国内加速(推荐)https://cdn.wusag.com走国内 CDN 节点
海外直连https://api.xinliu.one海外服务器或加速节点异常时使用
两个地址共用同一账户和 Key。

请求#

方法:GET {Base URL}/api/usage/token/
Header:Authorization: Bearer 你的令牌

示例#

返回字段#

字段类型说明
data.namestring令牌名称(后台设置时填的)
data.expires_atint过期时间戳,0 = 永不过期
data.unlimited_quotabooltrue 时为无限额度(此时 total_available 显示为负数表示无限)
data.total_grantedint总授予额度(按"美元 × 500000"换算的内部单位)
data.total_usedint已使用额度
data.total_availableint剩余额度 = total_granted - total_used(无限模式下可能为负数)
data.model_limits_enabledbool是否按模型限额
data.model_limitsobject按模型限额配置(仅 model_limits_enabled=true 时有内容)

计算"剩余多少美元"#

非无限模式下:美元 = total_available / 500000。

返回示例#

{
  "data": {
    "name": "我的令牌",
    "expires_at": 0,
    "unlimited_quota": true,
    "total_granted": 0,
    "total_used": 59590819,
    "total_available": -59590819,
    "model_limits_enabled": false,
    "model_limits": {},
    "object": "token_usage"
  },
  "message": "",
  "success": true
}

错误码#

401 令牌无效

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/usage/token/' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{}
修改于 2026-05-09 10:28:29
上一页
拉取模型列表
下一页
系统状态 / 公告
Built with