主题
Gemini LLM Scraper 语言列表
GET /v3/ai_optimization/gemini/llm_scraper/languages
接口概述
通过本接口可获取 gemini 模型在 llm_scraper 场景下支持的语言列表。
- 请求方式:
GET - 请求地址:
https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/languages - 计费说明:调用本接口不收费
- 实扣费以响应头
X-SeerMarTech-Charge-CNY为准
该接口返回 JSON 结构,响应中 tasks 数组;每个任务含请求信息及语言列表结果。
请求信息
HTTP 请求
bash
GET /v3/ai_optimization/gemini/llm_scraper/languages
Host: api.seermartech.cn
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json响应字段说明
顶层字段
| 字段名 | 类型 | 说明 |
|---|---|---|
version | string | API 当前版本 |
status_code | integer | 通用状态码 |
status_message | string | 通用提示信息 |
time | string | 执行时间,单位:秒 |
cost | float | 本次请求总费用,单位:USD |
tasks_count | integer | tasks 数组中的任务数量 |
tasks_error | integer | tasks 数组中返回错误的任务数量 |
tasks | array | 任务数组 |
tasks[] 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
id | string | 任务唯一标识,UUID 格式 |
status_code | integer | 任务状态码,范围通常为 10000-60000 |
status_message | string | 任务状态说明 |
time | string | 任务执行时间,单位:秒 |
cost | float | 单任务费用,单位:USD |
result_count | integer | result 数组中的数量 |
path | array | URL 路径 |
data | object | GET 请求 URL 中传的参数信息 |
result | array | 结果数组 |
tasks[].data 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
api | string | API 模块,固定为 ai_optimization |
function | string | 当前方法名,固定为 languages |
se | string | 大语言模型标识,本示例为 gemini |
se_type | string | 场景类型,本接口为 llm_scraper |
tasks[].result[] 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
language_name | string | 语言名称 |
language_code | string | 语言代码,遵循 ISO 639-1 标准 |
调用示例
cURL
bash
curl --location --request GET "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"Python
python
import requests
url = "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/languages"
headers = {
"Authorization": "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
data = response.json
if data.get("status_code") == 20000:
print(data)
# 在此处理语言列表结果
else:
print(f"error. Code: {data.get('status_code')} Message: {data.get('status_message')}")TypeScript
typescript
import axios from "axios";
// 获取 llm_scraper 支持的语言列表
axios({
method: "get",
url: "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/languages",
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
},
})
.then(function (response) {
const result = response.data;
// 输出返回结果
console.log(result);
})
.catch(function (error) {
console.log(error);
});响应示例
json
{
"version": "3.20191128",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1773 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"data": {
"api": "ai_optimization",
"function": "languages",
"se": "gemini",
"se_type": "llm_scraper"
},
"result": []
}
]
}状态码说明
20000:请求成功- 状态码:表示请求或任务处理异常
通用错误码与状态信息请参考 /v3/appendix/errors。
使用说明
- 本接口用于查询指定大语言模型在
llm_scraper模式下支持的语言集合。 - 除
gemini外,也可以将路径中的模型标识替换为支持的模型名称,但路径结构需保持容格式。 - 返回的
language_code采用 ISO 639-1 标准,适合用于后续语言参数校验、界面下拉项生成及自动化任务前置检查。
实用场景
- 校验抓取语言参数:在提交 LLM 抓取任务前拉取支持语言列表,传无效语言代码导致任务失败。
- 生成语言选择器:为后台页或客户前台表单动态生成可选语言下拉项,减少手工维护成本。
- 适多语言站点采集:根据接口返回的语言能力,规划不同国家/语言版本页面的抓取策略,提高化 SEO 数据覆盖率。
- 做任务前置风控:在批量创建抓取任务前校验目标语言是否受支持,降低批量报错和重试成本。
- 同步模型能力变化:定期拉取语言列表并比对历史版本,及时发现平台模型支持语言的新增或调整。