Gemini LLM Responses 可用模型列表

GET /v3/ai_optimization/gemini/llm_responses/models

接口概述

通过本接口可获取当前可用的 Gemini AI 模型列表。

• 请求方式：GET
• 接口地址：https://api.seermartech.cn/v3/ai_optimization/gemini/llm_responses/models
• 计费说明：调用本接口不收费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

接口返回为 JSON 数据，顶层 tasks 数组，每个任务中对应的结果信息。

---

请求信息

HTTP 请求

GET /v3/ai_optimization/gemini/llm_responses/models

认证方式

请在请求头中使用 Bearer Token：

Authorization: Bearer smt_live_YOUR_KEY

---

响应结构

顶层字段

字段名	类型	说明
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	任务状态信息，可参考 /v3/appendix/errors
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，可合该模型使用标准任务模式

---

响应说明

本接口用于列出可用模型及能力特征，便于在后续生成式 AI 调用前完成模型选择与能力判断。重点可以下字段：

• model_name：用于识别模型
• reasoning：判断是否适合复杂分析、推理类任务
• web_search_supported：判断是否可启用联网搜索增强回答
• task_post_supported：判断是否可使用标准任务提交与轮询获取结果的方式

---

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/ai_optimization/gemini/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/gemini/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/gemini/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.0668 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "ai_optimization",
 "function": "llm_responses",
 "se": "gemini"
 },
 "result": []
 }
 ]
}

说明：示例响应中部分任务级字段被省略，返回通常还会 id、status_code、status_message、time、cost、result_count、path 等字段。

---

状态码与错误处理

可通过以下两层状态字段判断请求是否成功：

###局状态

• status_code = 20000：请求成功
• 状态码：表示请求或系统层面异常

任务状态

• tasks[].status_code = 20000：当前任务成功
• 状态码：表示该任务执行失败或参数异常

完整错误码与说明请参考 /v3/appendix/errors。

---

使用建议

在正式调用 Gemini LLM 响应类接口前，建议调用本接口，完成以下检查：

1. 确认可用模型名称，传不存在的模型
2. 根据 reasoning 选择适合复杂任务的模型
3. 根据 web_search_supported 判断是否可启用联网搜索
4. 根据 task_post_supported 判断是否可使用标准任务模式

---

实用场景

• 筛选可推理模型：在构建 SEO 问答、分析或竞争对手洞察流程前，优识别支持 reasoning 的模型，提高复杂任务输出质量。
• 判断联网搜索能力：在生成需要实时网页信息支持的回答前，确认模型是否支持 web_search，功能无效。
• 选择任务提交方式：根据 task_post_supported 判断模型是否支持标准 POST-GET 模式，便于设计同步或异步处理流程。
• 动态维护模型白名单：定时拉取模型列表，自动更新业务系统中的可用模型，减少因模型变动导致的请求失败。
• 按能力路由请求：根据模型的推理、联网搜索、标准任务支持能力，将不同类型的 AI SEO 任务分发到最适合的模型上。