主题
AI 优化 API 概览
AI 优化 API 面向 AI 搜索优化场景，提供发现、对话式优化及大语言模型（LLM）实时评测所需的数据能力。通过本系列接口，您可以获取主流 LLM 的生成结果、AI 搜索结果、AI 指标，以及品牌或网站在 LLM 回答中的提及数据。
本系列以下功能接口：
LLM Responses API
路径：/v3/ai_optimization/llm_responses/overview/
根据指定的参数，从 ChatGPT、Claude、Gemini、Perplexity 等主流 LLM 实时生成结构化响应。LLM Scraper API
路径：/v3/ai_optimization/chat_gpt/llm_scraper/overview/
根据及参数，获取 ChatGPT 搜索结果的采集数据。AI Keyword Data API
路径：/v3/ai_optimization/ai_keyword_data/overview/
基于在 ChatGPT 等 AI 工和大语言模型中的使用，提供搜索量预估及用户意图洞察。LLM Mentions API
路径：/v3/ai_optimization/llm_mentions/overview/
查询、品牌和网站在 LLM 回答中的提及，并返回 AI 搜索量、量、提及次数等指标。
数据获取方式
本系列接口根据端点及所选 AI 平台，支持以下数据获取方式。
Live 实时模式
Live 模式适用于需要即时返回结果的业务场景。
调用 Live 接口时，通常无需创建任务再单独查询结果；请求完成后，响应中直接返回数据。适合实时问答评估、在线审核、即时品牌监测等需求。
Standard 标准模式
Standard 模式适用于对实时性要求不高、但希望降低任务成本的场景。
该模式通常分为两个步骤：
- 通过 POST 接口提交任务；
- 在任务完成后，通过对应的 GET 接口获取结果。
提交任务时，也可以设置以下回调字段：
| 字段 | 类型 | 说明 |
|---|---|---|
pingback_url | string | 任务完成后，本平台向指定地址发送完成通知。 |
postback_url | string | 任务完成后，本平台将任务结果推送至指定地址。 |
如果一次提交多个任务，可通过 Tasks Ready 接口获取已完成任务的 ID 列表，再通过对应的 Task GET 接口逐项获取结果。
> AI Keyword Data API 和 LLM Mentions API 支持 Live 实时模式。
> LLM Responses API 与 LLM Scraper API 是否支持 Standard 模式，取决于所选择的 AI 平台及端点能力。
认证方式
调用接口时，请在请求头中携带 Bearer Token：
http
Authorization: Bearer smt_live_YOUR_KEY计费说明
AI 优化 API 的费用取决于所调用的接口、任务执行方式及优级。
- Live 实时模式通常适合即时返回数据的请求；
- Standard 标准模式通常适合批量、异步处理任务；
- 不同 LLM 平台、任务类型和参数组合可能采用不同计费规则；
- 实扣费以响应头
X-SeerMarTech-Charge-CNY为准。
您也可以通过用户数据接口查询账户余额、消耗及额信息：
/v3/appendix/user_data/
沙箱测试
在正式接前，可使用沙箱环境验证请求参数、响应结构及任务处理流程：
/v3/appendix/sandbox/
沙箱环境适合用于开发调试和接口联调。正式环境的可用模型、数据范围、响应速度及计费规则可能与沙箱环境不同。
实用场景
- 评测品牌在 AI 回答中的可见度：查询品牌、域名或产品名称在多个 LLM 回答中的提及次数与指标，衡量 AI 搜索渠道的品牌影响力。
- 挖掘 AI 搜索机会：分析在 AI 工中的搜索量预估和用户意图，发现适合生成式搜索优化的选题。
- 对比不同模型的回答质量：向多个 LLM 发送相同提示词，比较回答、引用信息和品牌推荐结果，为模型选型或策略提供依据。
- 监控竞品在生成式搜索中的表现：持续追踪竞品品牌和网站在 LLM 回答中的出现频率，识别竞品覆盖和市场声量变化。
- 优化问答型与落地页：根据 LLM 对用户问题的回答及引用倾向，完善 FAQ、产品页和知识库，提高被 AI 推荐或引用的可能性。