主题
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 模式适用于不要求实时返回结果的场景。该模式通常需要分两步完成:
- 通过任务提交接口创建任务。
- 通过 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 模式批量提交任务,并通过回调地址或任务查询接口获取结果,降低实时调用成本并支持规模化监测。