调用agent space api必须指定有效模型id,可通过控制台模型广场查看、describemodellist接口查询(仅status为"online"的可用)或api快捷接入页复制获取,id区分大小写。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在调用Agent Space API时,必须明确指定模型ID才能成功发起请求,否则会因model参数缺失或无效导致401 Unauthorized或NPE空指针异常。
通过控制台模型广场获取模型ID
打开Agent平台控制台,确保已登录具备模型访问权限的账号。
点击左侧菜单栏「模型广场」→进入模型列表页。
在搜索框中输入目标模型名称(如qwen-plus、deepseek-v4-flash、glm-4-air),回车筛选。
找到对应模型卡片后,点击「详情」→在模型详情页顶部区域,【模型ID】字段即为调用API时需填入的model参数值,例如qwen-plus或deepseek-v4-flash。该ID区分大小写,不可修改拼写。
通过API接口动态查询可用模型
方法一:调用DescribeModelList接口(推荐用于自动化场景)
构造HTTP GET请求,URL为https://api.adp.tencent.com/v20260520/model/list,需携带合法认证头(Authorization: Bearer {token})。
响应体中models数组每项含model_id、name、status字段,【仅status为"online"的model_id才可实际调用】。
方法二:使用SDK快速枚举(以Python SDK为例)
执行client.DescribeModelList(DescribeModelListRequest()),遍历返回的resp.ModelList,提取model_id属性值。
从API快捷接入页直接复制
第一步:在控制台左侧菜单进入「概览」→点击「API接入」。
第二步:在API快捷接入页面完成两项选择:
① 服务组:从下拉菜单中选择已创建的服务组;若无,点击「确认创建并选择」生成默认组。
② 模型:从模型下拉菜单中选择目标模型。
第三步:页面下方自动生成各语言示例代码,其中model参数值即为当前所选模型的ID,直接复制使用即可。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











