Claude 模型列表查询

接口说明

GET /v3/ai_optimization/claude/llm_responses/models

用于获取当前可用的 Claude AI 模型列表。

该接口返回 JSON 结构的数据，响应中 tasks 数组，每个任务对象本次请求的执行状态及模型列表结果。

计费说明

调用此接口不收费。

可理解为：

• 参考价约 ¥0.0000 / 次
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

请求地址

GET https://api.seermartech.cn/v3/ai_optimization/claude/llm_responses/models

请求参数

该接口为 GET 请求，无需请求体。

响应字段

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口总体状态码，完整列表参见 /v3/appendix/errors
status_message	string	接口总体状态信息，完整列表参见 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	所有任务总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000，完整列表参见 /v3/appendix/errors
status_message	string	任务状态说明
time	string	任务执行耗时，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中携带的参数信息
result	array	模型列表结果

result[] 字段

字段名	类型	说明
model_name	string	AI 模型名称
reasoning	boolean	是否支持推理能力
web_search_supported	boolean	是否支持网页搜索；若为 true，则可为该模型设置 web_search 参数
task_post_supported	boolean	是否支持标准模式（POST-GET）数据获取；若为 true，可结合标准模式调用对应模型

调用示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/ai_optimization/claude/llm_responses/models" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/claude/llm_responses/models"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json)
# 可在此处理模型列表结果

TypeScript

import axios from "axios";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/ai_optimization/claude/llm_responses/models",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 console.log(response.data);
 // 可在此处理模型列表结果
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20250812",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0658 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "ai_optimization",
 "function": "llm_responses",
 "se": "claude"
 },
 "result": []
 }
 ]
}

状态码说明

状态码	说明
20000	请求成功
10000-60000	任务级状态码范围，含义参见 /v3/appendix/errors

使用说明

返回的 result 数组中当前可用模型及能力标识，可用于在正式发起 LLM 响应请求前动态选择模型。重点建议以下字段：

• model_name：用于确定可调用的模型名称
• reasoning：用于筛选备推理能力的模型
• web_search_supported：用于判断是否可以启用联网搜索
• task_post_supported：用于判断是否可使用标准模式（POST-GET）获取结果

如果你的业务需要根据模型能力自动路由请求，建议在调用生成类接口前，调用本接口缓存可用模型列表。

错误处理建议

当响应中的顶层 status_code 或任务级 status_code 非 20000 时，建议：

1. 检查鉴权信息是否正确；
2. 检查请求路径是否为 /v3/ai_optimization/claude/llm_responses/models；
3. 根据 /v3/appendix/errors 对状态码含义定位问题；
4. 同时 tasks_error 是否大于 0。

实用场景

• 筛选可用模型：在业务系统启动或定时任务中拉取模型列表，确保前端或调度器只展示当前可用的 Claude 模型，减少调用失败率。
• 判断是否启用联网搜索：根据 web_search_supported 自动识别哪些模型支持 web_search，为问答、研究、SERP助分析等场景选择合适模型。
• 选择推理型模型：根据 reasoning 字段筛选更适合复杂分析、SEO 策略归因、结构推演等任务的模型，提高输出质量。
• 切换调用模式：根据 task_post_supported 判断模型是否支持标准模式（POST-GET），便于在批量任务和异步处理链路中稳定集成。
• 构建模型能力映射表：将模型名称与能力标签同步到中心，为不同业务线实现按能力自动分流与灰度发布。