主题
LLM 抓取支持语言列表
接口说明
该接口用于获取 LLM 抓取能力支持的语言列表。
请求方式: GET请求地址: https://api.seermartech.cn/v3/ai_optimization/wp/v2/languages
调用后将返回当前模型与版本下可用的语言名称及 ISO 639-1 语言代码。
说明:
- 使用本接口不收费
- 实扣费以响应头
X-SeerMarTech-Charge-CNY为准- 路径中的
wp表示的大语言模型类型,除wp外,也可替换为受支持的模型标识- 路径中的
/v3/ai_optimization/...为容路径,需原样保留
如需批量查看完整语言单,也可参考平台提供的语言列表文件。
请求
HTTP Request
bash
GET /v3/ai_optimization/wp/v2/languages
Host: api.seermartech.cn
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
wp | string | LLM 抓取目标对应的模型标识。除 wp 外,也可使用受支持的模型参数。 |
v2 | string | 模型版本或接口类型标识,需按容路径传。 |
响应结构
接口返回 JSON 数据,顶层 tasks 数组每个任务对象对应一次获取结果。
顶层字段
| 字段名 | 类型 | 说明 |
|---|---|---|
version | string | 当前 API 版本 |
status_code | integer | 接口整体状态码 |
status_message | string | 接口整体状态信息 |
time | string | 请求执行时间,单位:秒 |
cost | float | 本次请求总费用,单位:USD;本接口通常为 0 |
tasks_count | integer | tasks 数组中的任务数量 |
tasks_error | integer | 返回错误的任务数量 |
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 | 请求路径信息 |
data | object | GET 请求 URL 中携带的参数信息 |
result | array | 获取结果数组 |
result[] 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
language_name | string | 语言名称 |
language_code | string | 语言代码,遵循 ISO 639-1 标准 |
返回状态码
可重点以下字段:
| 字段 | 说明 |
|---|---|
status_code | 整个请求的执行状态 |
tasks[].status_code | 单个任务的执行状态 |
常见成功状态:
| 状态码 | 含义 |
|---|---|
20000 | 请求成功 |
更多错误码可参考 /v3/appendix/errors。
调用示例
cURL
bash
curl --location --request GET "https://api.seermartech.cn/v3/ai_optimization/wp/v2/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/wp/v2/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";
// 获取支持的语言列表
axios({
method: "get",
url: "https://api.seermartech.cn/v3/ai_optimization/wp/v2/languages",
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json"
}
})
.then((response) => {
// 返回结果
console.log(response.data);
})
.catch((error) => {
console.error(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": "wp",
"se_type": "v2"
},
"result": []
}
]
}说明:示例中结果有省略,返回时
tasks中通常还会id、status_code、status_message、time、cost、result_count、path等字段。
字段解读
data 对象
tasks[].data 用于回显当前请求对应的接口上下文,常见字段如下:
| 字段名 | 类型 | 说明 |
|---|---|---|
api | string | API 分组,此处为 ai_optimization |
function | string | 当前功能,此处为 languages |
se | string | 模型标识,例如 wp |
se_type | string | 接口类型或版本标识,例如 v2 |
使用建议
- 在正式发起 LLM 抓取请求前,调用本接口确认目标语言是否受支持
- 若你维护多模型接,可分别替换路径中的模型标识,获取各模型对应的语言能力范围
- 将
language_code统一保存为 ISO 639-1 编码,便于后续任务、过滤和分析
实用场景
- 校验抓取语言:在创建 LLM 抓取任务前验证目标语言是否支持,因参数错误导致任务失败。
- 构建多语言投放策略:拉取可用语言列表后,为不同国家站点匹合适的抓取语言,提升 SEO 分析覆盖率。
- 动态生成前端下拉选项:将接口返回的语言单用于后台或运营系统的语言选择器,减少手工维护成本。
- 比对不同模型的语言覆盖:替换路径中的模型标识,评估不同 LLM 抓取能力支持的语种范围,为产品选型提供依据。
- 统一语言编码体系:基于
language_code建立标准字段,方便与、、地区等数据进行分析。