SeerMarTech API 文档

主题

设置 Gemini LLM 响应任务 ​

POST /v3/ai_optimization/gemini/llm_responses/task_post

本接口使用 POST 方法，路径为：

/v3/ai_optimization/gemini/llm_responses/task_post

Gemini LLM Responses 接口可根据参数，调用指定的 Gemini 模型并创建结构化响应任务。

本接口采用标准任务模式：提交任务后，系统异步处理请求，完成后再通过任务查询接口获取结果。如果不要求实时返回结果，推荐使用此模式。任务执行时间取决于系统负载。

如需立即获取结果，可使用 Live 方法：

/v3/ai_optimization/gemini/llm_responses/live

Live 方法无需分别调用任务提交和结果查询接口。

> 注意： 执行任务时会自动预扣参考费用约 ¥0.0720 / 次。如果产生的 LLM 费用低于该金额，差额将退回账户余额。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求说明 ​

所有 POST 数据使用 UTF-8 编码的 JSON 格式。请求体是 JSON 数组，每个数组代表一个任务。

平台限流以认证说明中的 30/60/120 次/分钟规则为准。

  • 每次 POST 请求最多 100 个任务。
  • 如果单次请求 100 个任务，出部分将返回错误码 40006。
  • 标准任务最长可能需要 72 小时完成。
  • 如果任务在 72 小时未完成，将被标记为失败，并退还预扣费用。
  • 如果账户余额为负数，即使任务已成功完成，也不会返回结果。

任务完成后，可以通过任务唯一标识 id 查询结果。也可以在提交任务时 postback_url 或 pingback_url，由本平台在任务完成后主动通知。

如果接收通知的服务器在 10 秒未返回响应，连接将因时中断，任务会转移到 tasks_ready 列表。错误码和错误信息取决于接收服务器的。

计费 ​

账户在成功提交任务时产生计费记录。

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

请求参数 ​

参数类型填说明
user_promptstring是发送给 AI 模型的问题或任务。最多 500 个字符。
model_namestring是AI 模型名称，可模型版本。如果只填写基础模型名称，系统将自动使用最新版本。例如填写 gemini-1.5-pro 时，系统可能自动设置为 gemini-1.5-pro-002。可通过模型列表接口获取可用模型：/v3/ai_optimization/gemini/llm_responses/models。
max_output_tokensinteger否AI 响应生成的最大 Token 数。最小值为 1，最大值为 4096，默认值为 2048。启用 web_search 或使用推理模型时，输出 Token 数可能该限制。启用 use_reasoning 时，最小值为 1024。
temperaturefloat否控制响应随机性。取值范围为 0 至 2，默认值为 1.3。值越高，输出越多样；值越低，输出越集中。
top_pfloat否控制响应多样性，通过限制候选 Token 范围影响结果。取值范围为 0 至 1，默认值为 0.9。
web_searchboolean否是否启用联网搜索。启用后，模型可以访问并引用当前网页信息。默认值为 false。支持该功能的模型请参考 /v3/ai_optimization/gemini/llm_responses/models。该参数可能产生额外费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
system_messagestring否AI 行为指令，用于定义角色、语气或特定行为。最多 500 个字符。
message_chainarray否对话历史，由消息对象组成。最多 10 个消息对象。每个对象 role 和 message 字段。
use_reasoningboolean否是否启用模型推理。启用后，模型会进行推理，再生成最终响应。默认值为 false。支持该功能的模型请参考 /v3/ai_optimization/gemini/llm_responses/models。启用后，max_output_tokens 最小值为 1024。对于 Gemini Pro 模型，该参数会自动设置为 true。
tagstring否用户自定义的任务标识，最长 255 个字符。可用于识别任务并将任务与结果进行匹。提交的值会在响应的 data 对象中返回。
postback_urlstring否接收任务结果的 URL。任务完成后，本平台会向该地址发送 POST 请求，结果使用 gzip 格式压缩。URL 中可以使用 $id 和 $tag 占位符，系统发送请求前会自动替换为任务 ID 和经过 URL 编码的标签值。
pingback_urlstring否任务完成通知 URL。任务完成后，本平台会向该地址发送 GET 请求。URL 中可以使用 $id 和 $tag 占位符，系统发送请求前会自动替换为任务 ID 和经过 URL 编码的标签值。

message_chain 消息对象 ​

参数类型说明
rolestring消息角色，只能为 user 或 ai。
messagestring消息，最多 500 个字符。

示例：

json
"message_chain": [
  {
    "role": "user",
    "message": "你好，最近怎么样？"
  },
  {
    "role": "ai",
    "message": "我很好，谢谢。今天想讨论什么主题？"
  }
]

回调 URL 占位符 ​

postback_url 示例：

text
https://your-server.example.com/postbackscript?id=$id&tag=$tag

pingback_url 示例：

text
https://your-server.example.com/pingscript?id=$id&tag=$tag

回调 URL 中的特殊字符会进行 URL 编码。例如，# 会被编码为 %23。

请求示例 ​

curl ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_responses/task_post" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "model_name": "gemini-2.5-flash",
      "user_prompt": "分析当前法国游乐园业务的市场性"
    }
  ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_responses/task_post"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

post_data = [
    {
        "system_message": "请以商务会议的方式进行沟通",
        "message_chain": [
            {
                "role": "user",
                "message": "你好，最近怎么样？",
            },
            {
                "role": "ai",
                "message": "我很好，谢谢。今天想讨论什么主题？",
            },
        ],
        "max_output_tokens": 1024,
        "temperature": 0.3,
        "top_p": 0.5,
        "model_name": "gemini-2.5-flash",
        "user_prompt": "分析当前法国游乐园业务的市场性",
    }
]

response = requests.post(url, headers=headers, json=post_data)
response.raise_for_status()

result = response.json()
print(result)

TypeScript ​

typescript
import axios from "axios";

const postData = [
  {
    system_message: "请以商务会议的方式进行沟通",
    message_chain: [
      {
        role: "user",
        message: "你好，最近怎么样？",
      },
      {
        role: "ai",
        message: "我很好，谢谢。今天想讨论什么主题？",
      },
    ],
    max_output_tokens: 1024,
    temperature: 0.3,
    top_p: 0.5,
    model_name: "gemini-2.5-flash",
    user_prompt: "分析当前法国游乐园业务的市场性",
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_responses/task_post",
    postData,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

PHP ​

php
<?php

$url = 'https://api.seermartech.cn/v3/ai_optimization/gemini/llm_responses/task_post';

$data = [
    [
        'system_message' => '请以商务会议的方式进行沟通',
        'message_chain' => [
            [
                'role' => 'user',
                'message' => '你好，最近怎么样？',
            ],
            [
                'role' => 'ai',
                'message' => '我很好，谢谢。今天想讨论什么主题？',
            ],
        ],
        'max_output_tokens' => 1024,
        'temperature' => 0.3,
        'top_p' => 0.5,
        'model_name' => 'gemini-2.5-flash',
        'user_prompt' => '分析当前法国游乐园业务的市场性',
    ],
];

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer smt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($data, JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

响应说明 ​

接口返回 JSON 数据 tasks 数组。每个任务对象任务提交状态及任务标识。

顶层响应字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。完整错误码列表请参考 /v3/appendix/errors。
status_messagestring通用状态说明。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务对象数组。

tasks 任务字段 ​

字段类型说明
idstring系统中的唯一任务标识，采用 UUID 格式。
status_codeinteger当前任务状态码，取值范围为 10000 至 60000。完整错误码列表请参考 /v3/appendix/errors。
status_messagestring当前任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharrayAPI URL 路径。
dataobject与 POST 请求中提交的任务参数相同。
resultarray | null任务结果数组。任务提交成功后，该字段通常为 null，需要通过任务查询接口获取最终结果。

响应示例 ​

json
{
  "version": "0.1.20250526",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1071 sec.",
  "cost": 0.0734,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "status_code": 20100,
      "status_message": "Task Created.",
      "time": "0.0500 sec.",
      "cost": 0.0734,
      "result_count": 0,
      "path": [
        "v3",
        "ai_optimization",
        "gemini",
        "llm_responses",
        "task_post"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "llm_responses",
        "se": "gemini",
        "system_message": "请以商务会议的方式进行沟通",
        "message_chain": [],
        "model_name": "gemini-2.5-flash",
        "user_prompt": "分析当前法国游乐园业务的市场性"
      },
      "result": null
    }
  ]
}

实用场景 ​

  • 批量生成多市场行业分析：提交不同国家、地区或行业的问题，统一获取 Gemini 结构化回答，支持 SEO 市场评估和规划。
  • 构建 SEO研究任务：结合 web_search 查询当前网页信息，为文章选题、行业报告和落地页提供实时资料。
  • 复用多轮对话上下文：通过 message_chain 传递历史问题与回答，持续完善策略、竞品分析或大纲。
  • 统一管理异步 AI 分析流程：使用 tag 和任务 id 追踪批量任务，便于将分析结果与客户、项目或集合。
  • 接收任务完成通知： postback_url 或 pingback_url，在长耗时分析完成后自动触发后续库、审核或报告生成流程。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API