余额查询

查询 DeepSeek API 账户余额，了解可用额度和货币信息。

通过余额查询 API，你可以获取当前 DeepSeek API 账户的余额信息，包括可用总额、赠送余额和充值余额。在运行长时间任务或批量调用前检查余额，可以避免因余额不足导致的中断。

基本用法

通过模型实例的 balance() 方法获取账户余额：

import { createModel } from 'deepseek-kit'

const model = createModel({ model: 'deepseek-v4-flash' })

const response = await model.balance()

console.log(response.is_available)
console.log(response.balance_infos)

余额信息详解

返回结果包含 is_available 和 balance_infos 两个字段：

const response = await model.balance()

if (response.is_available) {
  for (const info of response.balance_infos) {
    console.log(`货币: ${info.currency}`)
    console.log(`总余额: ${info.total_balance}`)
    console.log(`赠送余额: ${info.granted_balance}`)
    console.log(`充值余额: ${info.topped_up_balance}`)
  }
}
else {
  console.log('账户余额不足，无法进行 API 调用')
}

余额字段说明

字段说明
currency货币类型，'CNY'（人民币）或 'USD'（美元）
total_balance总可用余额，包含赠送余额和充值余额
granted_balance未过期的赠送余额
topped_up_balance充值余额

余额检查工具

在执行批量任务前检查余额，确保有足够的额度：

import { createModel } from 'deepseek-kit'

const model = createModel({ model: 'deepseek-v4-flash' })

async function checkBalanceBeforeRun() {
  const response = await model.balance()

  if (!response.is_available) {
    throw new Error('余额不足，请充值后再试。')
  }

  const cnyInfo = response.balance_infos.find(b => b.currency === 'CNY')
  if (cnyInfo) {
    const total = Number.parseFloat(cnyInfo.total_balance)
    if (total < 1) {
      console.warn(`警告：余额仅剩 ${cnyInfo.total_balance} ${cnyInfo.currency}，建议及时充值。`)
    }
  }

  return response
}

await checkBalanceBeforeRun()

自定义配置

balance() 方法支持传入自定义配置，覆盖默认的 API Key、Base URL 或超时时间：

const response = await model.balance({
  timeout: 10000,
})

API 参考

model.balance() 参数

apiKeystring
API 密钥。默认使用模型实例的配置。
baseURLstring
API 基础 URL。默认使用模型实例的配置。
timeoutnumber
请求超时时间（毫秒）。

UserBalanceResponse

is_availableboolean
账户余额是否足够进行 API 调用。
balance_infosBalanceInfo[]
余额信息列表，按货币类型分别展示。

BalanceInfo

currency'CNY' | 'USD'
货币类型。
total_balancestring
总可用余额，包含赠送余额和充值余额。
granted_balancestring
未过期的赠送余额。
topped_up_balancestring
充值余额。
模型列表
查询 DeepSeek API 可用的模型列表，获取模型标识符和归属信息。
集成概览
deepseek-kit 可以与 AI SDK、LangChain 等框架协同工作——将 DeepSeek 智能体作为子智能体嵌入其他框架，或将其他框架的智能体作为工具引入 deepseek-kit。