获取模型列表

获取模型列表

更新时间：2026-11-11

GET

https://qianfan.baidubce.com/v2/models

权限说明

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

请求结构

GET /v2/models HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>

示例代码

Shell

Python

curl https://qianfan.baidubce.com/v2/models \
 -H "Authorization:  Bearer <API Key>" \
 -H "Content-Type: application/json" \

import requests
import json

def main():
    url = "https://qianfan.baidubce.com/v2/models"
    
    payload = json.dumps({
    })
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer bce-v3/ALTAK-*********/614fb**********'
    }
    
    response = requests.request("GET", url, headers=headers, data=payload)
    
    print(response.text)
    

if __name__ == '__main__':
    main()

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

object string

固定值为list

可选

data array

可选

显示子属性隐藏子属性

items object {19}

显示子属性隐藏子属性

id string

模型标识符，值为模型对应的model值

可选

object string

对象类型，固定值为model

可选

owned_by string

拥有该模型的组织，例如 Baidu、Meta、DeepSeek 等

可选

created integer

模型上线时间，Unix timestamp（秒）

可选

type string

模型类型，例如 chat、text2image、image2image、text2video、embeddings、rerank 等

可选

context_length oneOf {2}

多选一且必需"只能"符合其中一个

模型支持的最大上下文长度（token），含输入、输出及思维链

可选

显示子属性隐藏子属性

context_length integer

context_length null

max_completions_tokens oneOf {2}

多选一且必需"只能"符合其中一个

可指定的模型最大思考+输出 token 数

可选

显示子属性隐藏子属性

max_completions_tokens integer

max_completions_tokens null

max_tokens oneOf {2}

多选一且必需"只能"符合其中一个

可指定的模型最大输出 token 数

可选

显示子属性隐藏子属性

max_tokens integer

max_tokens null

prompt_tokens oneOf {2}

多选一且必需"只能"符合其中一个

可指定的模型最大输入 token 数

可选

显示子属性隐藏子属性

prompt_tokens integer

prompt_tokens null

architecture object {3}

模型输入输出模态信息

可选

显示子属性隐藏子属性

modality string

输入输出模态组合的简洁描述，例如 text+image->text、text->image、text->embedding 等

可选

input_modalities array

输入模态列表，例如["text"], ["image"], ["video"]等

可选

显示子属性隐藏子属性

items string

output_modalities array

输出模态列表，例如 ["text"]、["image"]、["embedding"]等

可选

显示子属性隐藏子属性

items string

pricing object {6}

模型计费信息

可选

显示子属性隐藏子属性

prompt oneOf {2}

多选一且必需"只能"符合其中一个

输入 tokens 单价，文本模型适用；固定价格为 string，分段计价为 array

可选

显示子属性隐藏子属性

prompt string

固定价格，单位：元/千tokens

prompt array

分段计价列表

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

up_to oneOf {2}

多选一且必需"只能"符合其中一个

该分段的千tokens上限，null 表示无上限

可选

显示子属性隐藏子属性

up_to integer

up_to null

price string

该分段的单价，单位：元/千tokens

可选

completion oneOf {3}

多选一且必需"只能"符合其中一个

输出 tokens 单价，格式同 prompt

可选

显示子属性隐藏子属性

completion string

固定价格，单位：元/千tokens

completion array

分段计价列表

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

up_to oneOf {2}

多选一且必需"只能"符合其中一个

该分段的千tokens上限

可选

显示子属性隐藏子属性

up_to integer

up_to null

price string

该分段的单价，单位：元/千tokens

可选

completion null

image oneOf {2}

多选一且必需"只能"符合其中一个

输出图片单价，单位：元/张，仅图像生成/编辑模型适用

可选

显示子属性隐藏子属性

image string

image null

video oneOf {2}

多选一且必需"只能"符合其中一个

输出视频单价，单位：元/秒，仅视频生成模型适用

可选

显示子属性隐藏子属性

video string

video null

web_search oneOf {2}

多选一且必需"只能"符合其中一个

联网搜索增强单价，单位：元/次，仅支持 web_search 的模型适用

可选

显示子属性隐藏子属性

web_search string

web_search null

cache string

缓存命中价格，单位：元/千 tokens

可选

model_name string

模型展示名称

可选

model_description string

模型描述

可选

status string

模型状态：active 活跃、new 发布 14 天内、soon_offline 距下线 30 天内（即将下线）、offline 已下线

可选

features string

支持的能力标签（仅支持项出现）：web_search 联网搜索、function_call 工具调用、structured_output 结构化输出、prompt_caching 前缀读写（缓存）、fim_completion FIM 补全

可选

shutdown_time integer

下线/预计下线时间，null 表示无下线计划

可选

tpm integer

每分钟 token 限额（当前登录主账号维度），null 表示未配置

可选

rpm integer

每分钟请求限额（当前登录主账号维度），null 表示未配置

可选

endpoints string

支持的调用协议路径：/v2/chat/completions、/v2/responses、/anthropic/v1/messages

可选

响应示例

{
    "object": "list",
    "data": [
        {
            "id": "deepseek-v3.2",
            "object": "model",
            "owned_by": "DeepSeek",
            "model_name": "DeepSeek-V3.2",
            "model_description": "DeepSeek 通用对话模型",
            "status": "active",
            "features": ["function_call", "structured_output", "prompt_caching", "fim_completion"],
            "created": 1717000000,
            "shutdown_time": null,
            "type": "chat",
            "context_length": 131072,
            "max_completions_tokens": 8192,
            "max_tokens": 4096,
            "prompt_tokens": 126976,
            "tpm": 50000,
            "rpm": 165,
            "architecture": {
                "modality": "text->text",
                "input_modalities": ["text"],
                "output_modalities": ["text"]
            },
            "pricing": {
                "prompt": "0.002",
                "completion": "0.008",
                "cache": "0.0005"
            },
            "endpoints": ["/v2/chat/completions", "/v2/responses", "/anthropic/v1/messages"]
        }
    ]
}

请求异常码

异常码 (code)	HTTP 状态码	说明
InternalError	500	本接口唯一对外异常码。`/v2/models` 无请求参数，出错均归为系统内部错误，涵盖：carrier-api→carrier 的 RAL 调用失败或 `result` 反序列化失败；carrier 侧查询预置模型/版本列表失败、批量询价失败、价格查询异常；调用 Compass Console 预置服务管理列表（tpm/rpm/下线时间）失败。对应 carrier 系统错误码 COMMON(11000)，经 `NewCarrierError` 归一为 `InternalError`

错误返回结构

与成功时的透传不同，出错时 handler 使用 BuildResponse 返回标准错误包装：带 requestId 外层、无 result 字段。/v2/models 无请求参数，出错均为系统内部错误，HTTP 状态码为 500。结构如下：

字段	类型	说明
requestId	string	请求追踪 ID
code	string	错误码，如 `InternalError`；下游 carrier/compass 错误按映射透传对应错误码
message	string	错误描述信息

错误返回示例：

json

{
    "requestId": "2744981776",
    "code": "InternalError",
    "message": "We encountered an internal error. Please try again."
}

评价此篇文章

有帮助没帮助

百度智能云

千帆AI应用开发者中心-API参考 qianfan-api

千帆AI应用开发者中心-API参考 qianfan-api

权限说明

请求参数

示例代码

返回响应

请求异常码

错误返回结构