通过调用/v1/models API实时获取模型清单，检查data数组中status为"active"的模型才真正可用；CLI命令agent-space models list可查看注册与健康检查时间，ping命令能验证实际调用能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space API怎么查看可用模型
要确认当前 Agent Space 环境下哪些模型真正可调用、可注册、可路由，不能只查文档或界面列表，必须通过 API 实时拉取平台实际加载的模型元数据——因为模型是否“可用”，取决于后端服务是否完成注册、密钥是否激活、权限是否授予、缓存是否刷新。
直接调用 /v1/models 接口获取实时模型清单
这是最权威、最轻量的方式，绕过前端缓存和静态配置页，直连模型注册中心。
第一步：构造请求 URL，使用当前 Space 的 Base URL + /v1/models 路径。例如：https://api.coze.cn/v1/models 或 https://agent-space.example.com/api/v1/models。
第二步：在请求头中携带有效的认证凭证。必须使用 Bearer {your_space_api_key}，该密钥需具备 model:read 权限；若用错密钥类型（如误用 Bot Token 或 User Token），会返回 403 且不提示具体原因。
第三步：发送 GET 请求，响应体为 JSON 格式。重点检查 data 数组中的每个模型对象是否包含 status: "active" 字段——只有 status 为 active 的模型才代表已通过健康检查、密钥校验与路由注册，可被 Agent 正常调用。status 为 pending 或 disabled 的模型虽出现在列表中，但实际不可用。
通过 CLI 工具快速验证模型状态
如果你已在本地安装官方 CLI（如 coze-cli 或 agent-space-cli），可跳过手动发请求，用一行命令完成全链路验证。
方法一：执行 agent-space models list --space-id spc_xxx --verbose。该命令不仅列出模型 ID 和名称，还会显示每项的 registration_time 和 last_health_check 时间戳。若 last_health_check 超过 5 分钟未更新，说明该模型后端服务可能已掉线。
方法二：对单个模型做探活测试，运行 agent-space models ping --model-id qwen3.7-max。它会自动发起一次最小化推理请求（输入 "ping"），并返回耗时、HTTP 状态码及错误原因（如 "auth_failed" 或 "route_not_found"）。这比单纯看列表更能暴露真实问题。
从 Space 控制台导出模型 CSV 并交叉核对
适用于需要批量比对、审计或同步到内部知识库的场景。控制台导出的数据虽非实时，但含字段更全，可补足 API 返回中缺失的业务标签。
进入 Agent Space 控制台 → 左侧导航栏点击「模型管理」→ 右上角点击「导出 CSV」按钮 → 下载文件后打开，检查三列关键内容：model_id（必须与 API 返回一致）、is_routable（布尔值，仅 true 才能被 Auto Router 选中）、quota_used_percent（若接近 100%，即使 status 为 active，也可能因配额超限而实际拒调）。
注意：导出 CSV 中的 last_updated 时间必须晚于你调用 /v1/models 接口的时间，否则说明控制台缓存未刷新，应以 API 结果为准。
