DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
实时 ChatGPT LLM 响应
向 ChatGPT 模型发送 user_prompt 并同步返回其回复。model_name 用于选择模型——参见 get_dataforseo_ai_chat_gpt_llm_responses_models，未列出的名称会被直接拒绝。max_output_tokens、temperature 和 top_p 的行为与供应商自有 API 一致，web_search 或 force_web_search 可让它浏览网页。返回 model_name、input_tokens、output_tokens、reasoning_tokens、web_search、money_spent、datetime、items 和 fan_out_queries。读取响应中的 money_spent 即可知道一次提示词的实际成本。采用 DataForSEO 的信封结构：数据位于 tasks[0].result，结果状态位于 tasks[0].status_code——被拒绝的请求仍会返回 HTTP 200。⚠️ 这是通过数据提供方路由的通用 LLM 调用，不是 SEO 测量。如果你想了解 ChatGPT 如何向用户描述某个品牌，请改用 post_dataforseo_ai_chat_gpt_llm_scraper_live 复现消费者体验。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.0695 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array (object | null)[]
- force类型: boolean | null
_web _search 强制 AI 智能体使用网络搜索
可选字段
要启用此参数，还必须启用web_search；
启用后，AI 模型会被强制访问并引用当前网络信息；
默认值：false；
注意：即使参数设为true，也不能保证响应中会引用网络来源
注意 2：推理模型不支持 - max类型: integer | null
_output _tokens - message类型: array (object | null)[] | null
_chain 对话历史 可选字段 表示此前对话轮次的消息对象数组； 每个对象必须包含： role 字符串，值为 user 或 ai 角色； message 字符串，包含消息内容（最多 500 个字符）； 数组中最多可指定 10 个消息对象； 注意：对于 Perplexity 模型，消息必须严格在 user 与 AI 角色之间交替（user → ai）； 示例： "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]
- message类型: string | null
消息文本
- role类型: string | null
消息来源用户的角色
- model类型: string
_name AI 模型名称
必填字段model_name由实际模型名称和版本名称组成；
如果只指定基础模型名称，将默认设置其最新版本；
例如，指定gpt-4.1时，会自动将gpt-4.1-2025-04-14设为model_name；
可单独向https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models发起请求，获取可用 LLM 模型列表 - system类型: string | null
_message AI 行为指令
可选字段
定义 AI 的角色、语气或特定行为
在system_message字段中最多可指定 500 个字符 - tag类型: string | null
用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
可在响应的data对象中找到指定的tag值 - temperature类型: number | null
AI 响应的随机性
可选字段
值越高，输出越多样；
值越低，输出越集中；
最小值：0
最大值：2
默认值：0.94
注意：推理模型不支持 - top类型: number | null
_p AI 响应的多样性
可选字段
通过限制 token 选择来控制响应的多样性；
最小值：0
最大值：1
默认值：0.92注意：同一请求中
top_p不能与temperature同时使用 - user类型: string
_prompt AI 模型的提示词
必填字段
要发送给 AI 模型的问题或任务；
在user_prompt字段中最多可指定 500 个字符 - web类型: boolean | null
_search - web类型: string | null
_search _city 地点的城市名称
可选字段
注意：o3-mini、o1-pro、o1模型不支持 - web类型: string | null
_search _country _iso _code 地点的 ISO 国家代码
可选字段
要启用此参数，还必须启用web_search；
启用后，AI 模型将从你指定的国家/地区搜索网络；
注意：o3-mini、o1-pro、o1模型不支持
- 类型: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用，美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- cost类型: number | null 格式: double
任务总费用，美元
- data类型: object | null
包含你在 POST 请求中指定的相同参数
- property类型: object | null
Name
- id类型: string | null
任务标识符 我们系统中 UUID 格式的唯一任务标识符
- path类型: array (string | null)[] | null
URL 路径
- result类型: array (object | null)[] | null
结果数组
- datetime类型: string | null
收到结果的日期和时间
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：2019-11-15 12:57:46 +00:00 - fan类型: array (string | null)[] | null
_out _queries 扇出查询数组
包含从主查询派生出的相关搜索查询，以提供更全面的回答 - input类型: integer | null
_tokens 输入中的 token 数
处理的 token 总数 - items类型: array (object | null)[] | null
响应条目数组
包含结构化的 AI 响应数据- type类型: string | null
元素类型
- model类型: string | null
_name 所用 AI 模型的名称
- money类型: number | null
_spent - output类型: integer | null
_tokens 输出中的 token 数
AI 响应中生成的 token 总数 - reasoning类型: integer | null
_tokens 推理 token 数
用于生成推理内容的 token 总数 - web类型: boolean | null
_search 表示是否使用了网络搜索
- result类型: integer | null 格式: int64
_count result 数组中的元素数
- status类型: integer | null
_code 任务的状态码 由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处
- status类型: string | null
_message 任务的信息性消息 完整的一般信息性消息列表见此处
- time类型: string | null
执行时间，秒
- 类型: integer | null 格式: int64tasks
_count tasks 数组中的任务数
- 类型: integer | null 格式: int64tasks
_error tasks 数组中返回错误的任务数
- 类型: string | nulltime
总执行时间，秒
- 类型: string | nullversion
API 的当前版本
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"system_message": "communicate as if we are in a business meeting",
"message_chain": [
{
"role": "user",
"message": "Hello, what’s up?"
},
{
"role": "ai",
"message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
}
],
"max_output_tokens": 200,
"temperature": 0.3,
"top_p": 0.5,
"model_name": "gpt-4.1-mini",
"web_search": true,
"web_search_country_iso_code": "FR",
"web_search_city": "Paris",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"model_name": null,
"input_tokens": null,
"output_tokens": null,
"reasoning_tokens": null,
"web_search": null,
"money_spent": null,
"datetime": null,
"items": [
{
"type": null
}
],
"fan_out_queries": [
null
]
}
]
}
]
}