模型列表

查询 DeepSeek API 可用的模型列表，获取模型标识符和归属信息。

通过模型列表 API，你可以查询当前 DeepSeek 平台上所有可用的模型，获取每个模型的标识符和归属信息。这在需要动态选择模型、构建模型选择器 UI 或验证模型可用性时非常有用。

基本用法

通过模型实例的 list() 方法获取可用模型列表：

import { createModel } from 'deepseek-kit'

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

const response = await model.list()

console.log(response.data)

返回结果包含一个 data 数组，每项代表一个可用模型：

[
  { id: 'deepseek-v4-flash', object: 'model', owned_by: 'deepseek' },
  { id: 'deepseek-v4-pro', object: 'model', owned_by: 'deepseek' },
]

提取模型名称

从返回结果中提取所有模型名称，用于构建模型选择器：

const response = await model.list()

const modelNames = response.data.map(m => m.id)
console.log(modelNames)
// ['deepseek-v4-flash', 'deepseek-v4-pro']

验证模型可用性

在创建模型实例前，先检查目标模型是否可用：

import { createModel } from 'deepseek-kit'

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

const response = await model.list()
const availableModels = response.data.map(m => m.id)

const targetModel = 'deepseek-v4-pro'

if (availableModels.includes(targetModel)) {
  console.log(`${targetModel} 可用`)
}
else {
  console.log(`${targetModel} 不可用`)
}

自定义配置

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

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

API 参考

model.list() 参数

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

ListModelsResponse

object'list'
响应对象类型，固定为 'list'。
dataModelInfo[]
可用模型列表。每项包含以下字段：
ModelInfo.idstring
模型标识符，可在 API 请求中引用。
ModelInfo.object'model'
对象类型，固定为 'model'。
ModelInfo.owned_bystring
模型归属组织。
FIM 补全
FIM（Fill in the Middle）补全让模型根据前缀和后缀生成中间内容——适用于代码补全、文本填充等场景。
余额查询
查询 DeepSeek API 账户余额，了解可用额度和货币信息。