GET https://ark.cn-beijing.volces.com/api/v3/models
查询当前账号可见的基础模型版本及其能力、模态、Token 限制、推理强度和支持的 API。返回全部可见模型版本,按创建时间降序排列。
鉴权#
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。
- API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。
请求参数#
响应参数#
data object[] | 模型版本列表
当前账号可见的模型版本列表。无可见模型版本时返回空数组。
created integer | 创建时间
data.created
模型版本创建时间,Unix 时间戳,单位为秒。
domain string | 模型领域
data.domain
模型所属领域,包括 LLM、VLM、ImageGeneration、VideoGeneration、3DGeneration、Audio 和 Embedding。
该模型不支持领域信息时返回空字符串。
features object | 模型能力
data.features
模型支持的能力。
batch object | 批量推理能力
data.features.batch
batch_chat boolean | Batch Chat
data.features.batch.batch_chat
是否支持 Batch Chat。该模型不支持 Batch Chat 时返回 false。
batch_job boolean | Batch Job
data.features.batch.batch_job
是否支持 Batch Job。该模型不支持 Batch Job 时返回 false。
cache object | 缓存能力
data.features.cache
prefix_cache boolean | 前缀缓存
data.features.cache.prefix_cache
是否支持前缀缓存。该模型不支持前缀缓存时返回 false。
session_cache boolean | 会话缓存
data.features.cache.session_cache
是否支持会话缓存。该模型不支持会话缓存时返回 false。
structured_outputs object | 结构化输出能力
data.features.structured_outputs
json_object boolean | JSON 对象输出
data.features.structured_outputs.json_object
是否支持 JSON 对象输出。该模型不支持 JSON 对象输出时返回 false。
json_schema boolean | JSON Schema 输出
data.features.structured_outputs.json_schema
是否支持 JSON Schema 输出。该模型不支持 JSON Schema 输出时返回 false。
thinking object | 思考能力
data.features.thinking
type string | 思考类型
data.features.thinking.type
是否支持深度思考能力。enabled 表示支持,disabled 表示不支持。
tools object | 工具能力
data.features.tools
工具调用能力。
function_calling boolean | 函数调用
data.features.tools.function_calling
是否支持函数调用。该模型不支持函数调用时返回 false。
web_search boolean | 联网搜索
data.features.tools.web_search
是否支持联网搜索。该模型不支持联网搜索时返回 false。
id string | 模型版本 ID
data.id
name string | 基础模型名称
data.name
object string | 对象类型
data.object
对象类型,固定为 model。
version string | 模型版本
data.version
api_supported object | 支持的 API
data.api_supported
模型支持的 API 及其启用状态。
context_window integer | 上下文窗口
data.context_window
最大上下文长度,单位为 Token。
最小值:0
effort object | 推理强度
data.effort
模型支持的推理强度等级和默认等级。
supported_levels string[] | 支持的推理强度等级
data.effort.supported_levels
default_level string | 默认推理强度等级
data.effort.default_level
模型默认使用的推理强度等级。
max_output_tokens integer | 最大输出 Token 数
data.max_output_tokens
最大输出长度,单位为 Token。
最小值:0
modalities object | 模态
data.modalities
模型支持的输入和输出模态。
input_modalities string[] | 输入模态
data.modalities.input_modalities
模型支持的输入模态,包括 text、image、video 和 audio。
output_modalities string[] | 输出模态
data.modalities.output_modalities
模型支持的输出模态,包括 text、image、video、audio、3D 和 embedding。
status string | 生命周期状态
data.status
模型版本的生命周期状态。Published 表示模型已上线,可正常调用;Retiring 表示模型处于计划下线状态,当前仍可调用,后续将停止服务。
task_type string[] | 任务类型
data.task_type
模型支持的任务类型。
token_limits object | Token 限制
data.token_limits
模型 Token 限制。
context_window integer | 上下文窗口
data.token_limits.context_window
最大上下文长度,单位为 Token。
最小值:0
max_input_token_length integer | 最大输入 Token 数
data.token_limits.max_input_token_length
最大输入长度,单位为 Token。
最小值:0
max_output_token_length integer | 最大输出 Token 数
data.token_limits.max_output_token_length
最大输出长度,单位为 Token。
最小值:0
max_reasoning_token_length integer | 最大推理 Token 数
data.token_limits.max_reasoning_token_length
最大推理长度,单位为 Token。
最小值:0
object string | 对象类型
响应对象类型,固定为 list。