Skip to content

Claude LLM Responses:概览

本接口用于生成和获取结构化的 Claude 响应。你可以根据指定的参数,分析 Claude 针对品牌、产品、竞争对手、或主题的回答。

本组接口以下 API 路径:

  • POST /v3/ai_optimization/claude/llm_responses/live/:根据参数,实时获取指定 Claude 模型生成的结构化响应。
  • GET /v3/ai_optimization/claude/llm_responses/models/:获取可用于 LLM Responses 接口的 Claude 模型列表。
  • Standard 模式还支持通过任务提交、任务查询和结果获取接口处理异步任务任务提交路径为 /v3/ai_optimization/claude/llm_responses/task_post/

认证

请求时请在 HTTP 请求头中传 API 密钥:

http
Authorization: Bearer smt_live_YOUR_KEY

调用方式

Claude LLM Responses API 支持 Standard 和 Live 两种结果交付方式。费用取决于所选调用方式以及任务执行优级。

Live 模式

Live 模式适用于需要即时获取结果的场景。调用时提交请求后,接口会直接返回任务结果,无需再分别调用 POST 和 GET 接口。

Live 模式的任务执行时间目前最长约为 120 秒。同一账户针对每个平台最多可同时提交 30 个 Live 请求

Standard 模式

Standard 模式适用于不要求实时返回结果的场景。该模式通常需要分两步完成:

  1. 通过任务提交接口创建任务。
  2. 通过 GET 接口查询并获取任务结果。

Standard 模式的价格通常低于 Live 模式,但任务完成时间最长可能达到 72 小时。系统完成任务后,可以通过以下方式获取结果:

  • 使用任务结果查询接口主动获取结果。
  • 在创建任务时设置 pingback_url,任务完成后接收完成通知。
  • 在创建任务时设置 postback_url,任务完成后由平台将任务结果发送到指定地址。
  • 批量提交任务时,使用 Tasks Ready 接口获取已完成任务的 ID 列表,再通过 Task GET 接口逐个获取任务结果。

请求限制

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

  • Live 请求的并发数量上限为:每个账户针对每个平台最多 30 个
  • 如需提高调用频率或并发限制,请联系平台技术支持。

费用说明

费用取决于调用方式、任务执行优级以及使用量。接口的扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

你也可以通过用户数据接口查询账户使用:

http
GET /v3/appendix/user_data/

请求示例

以下示例展示了调用 Live 接口时的基本请求方式。请求参数请参考对应接口文档。

bash
curl --request POST \
  --url https://api.seermartech.cn/v3/ai_optimization/claude/llm_responses/live/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[{
    "model": "claude-model-id",
    "input": "请分析该品牌在目标上的表现"
  }]'

##测试

你可以使用本平台的 Sandbox 环境测试 Claude LLM Responses API。Sandbox 适用于接口联调和请求格式验证,能力及限制以 Sandbox 说明为准:

text
/v3/appendix/sandbox/

实用场景

  • 分析品牌问答:批量查询 Claude 对品牌、产品和服务的描述,评估品牌在生成式搜索场景中的可见度与认知偏差。
  • 监测竞争对手表现:针对相同和主题获取 Claude 对多个竞争品牌的回答,支持竞品定位、差异和市场认知分析。
  • 评估语义覆盖:提交目标或主题,分析 Claude 是否提及企业的核心产品、优势和实体,优化策略。
  • 比较不同 Claude 模型输出:通过模型列表接口获取可用模型,再使用不同模型生成响应,评估模型差异对品牌监测结果的影响。
  • 构建定期 AI 搜索监测任务:使用 Standard 模式批量提交任务,并通过回调地址或任务查询接口获取结果,降低实时调用成本并支持规模化监测。

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