user_prompt 欄位中最多可指定 500 個字元"
},
"model_name": {
"type": "string",
"description": "AI 模型名稱model_name 由實際模型名稱和版本名稱組成；claude-opus-4-0 時，會自動將 claude-opus-4-20250514 設為 model_name；https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models 發出請求，取得可用的 LLM 模型清單"
},
"max_output_tokens": {
"type": [
"integer",
"null"
],
"description": "AI 回應中的最大 token 數1；4096；2048；web_search 設為 true，或請求中指定的是推論模型，輸出 token 數可能超過指定的 max_output_tokens 上限use_reasoning 設為 true，max_output_tokens 的最小值為 1025"
},
"temperature": {
"type": [
"number",
"null"
],
"description": "AI 回應的隨機性010.7注意：同一請求中 temperature 不能與 top_p 同時使用"
},
"top_p": {
"type": [
"number",
"null"
],
"description": "AI 回應的多樣性
選填欄位
透過限制 token 選擇來控制回應的多樣性；
最小值：0
最大值：1
預設值：null
注意：同一請求中 top_p 不能與 temperature 同時使用"
},
"web_search": {
"type": [
"boolean",
"null"
],
"description": "啟用網路搜尋以取得目前資訊
選填欄位
啟用後，AI 模型可以存取並引用目前的網路資訊；
注意：支援 web_search 的模型清單請參閱 Models 端點；
預設值：false；
此參數的費用可在 定價頁計算"
},
"force_web_search": {
"type": [
"boolean",
"null"
],
"description": "強制 AI 代理程式使用網路搜尋
選填欄位
要啟用此參數，還必須啟用 web_search；
啟用後，AI 模型會被強制存取並引用目前的網路資訊；
預設值：false；
注意：即使參數設為 true，也無法保證回應中會引用網路來源"
},
"web_search_country_iso_code": {
"type": [
"string",
"null"
],
"description": "用於網路搜尋的地點的 ISO 國家代碼
選填欄位
可能的值：'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'"
},
"web_search_city": {
"type": [
"string",
"null"
],
"description": "用於網路搜尋的地點的城市名稱
選填欄位
"
},
"system_message": {
"type": [
"string",
"null"
],
"description": "AI 行為指令
選填欄位
定義 AI 的角色、語氣或特定行為；
在 system_message 欄位中最多可指定 500 個字元"
},
"message_chain": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"role": {
"type": [
"string",
"null"
],
"description": "訊息來源使用者的角色"
},
"message": {
"type": [
"string",
"null"
],
"description": "訊息文字"
}
}
}
]
},
"description": "對話歷史\n選填欄位\n代表先前對話輪次的訊息物件陣列；\n每個物件必須包含：\nrole 字串，值為 user 或 ai 角色；\nmessage 字串，包含訊息內容（最多 500 個字元）；\n陣列中最多可指定 10 個訊息物件；\n注意：對於 Perplexity 模型，訊息必須嚴格在 user 與 AI 角色之間交替（user → ai）；\n範例：\n\"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?\"}]"
},
"use_reasoning": {
"type": [
"boolean",
"null"
],
"description": "為 AI 模型啟用推論
選填欄位
啟用後，模型會在產生回應前進行推論
支援 reasoning 的模型清單請參閱 Models 端點
預設值：false
注意：如果設為 true，max_output_tokens 的最小值為 1025
注意 2：如果設為 true，force_web_search 必須設為 false
注意 3：如果設為 true，則不能使用 temperature 與 top_p"
},
"tag": {
"type": [
"string",
"null"
],
"description": "使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
可在回應的 data 物件中找到指定的 tag 值"
}
},
"example": [
{
"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,
"model_name": "claude-opus-4-0",
"temperature": 0.3,
"web_search": true,
"web_search_country_iso_code": "FR",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]
}
]
},
"example": [
{
"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,
"model_name": "claude-opus-4-0",
"temperature": 0.3,
"web_search": true,
"web_search_country_iso_code": "FR",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo"
}
]
}
```
### 400 — 無法處理該要求。請檢查請求參數。
### 401 — 需要有效的 Felo API 金鑰。
### 402 — 由於未符合計費要求，要求無法繼續。
### 403 — 該帳戶無權執行此操作。
### 429 — 已達到要求或支出上限。
### 502 — 服務無法完成該要求。
### 503 — API 或計費服務暫時無法使用。
### 504 — 服務在處理要求時逾時。
### default — 錯誤回應；上游透傳回應可能採用供應商格式
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo"
}
]
},
"description": "任務陣列"
}
}
}
]
}
```
### Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResultInfo
`#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResultInfo`
```json
{
"type": "object",
"properties": {
"model_name": {
"type": [
"string",
"null"
],
"description": "所用 AI 模型的名稱"
},
"input_tokens": {
"type": [
"integer",
"null"
],
"description": "輸入中的 token 數
處理的 token 總數"
},
"output_tokens": {
"type": [
"integer",
"null"
],
"description": "輸出中的 token 數
AI 回應中產生的 token 總數"
},
"reasoning_tokens": {
"type": [
"integer",
"null"
],
"description": "推理 token 數
用於產生推理內容的 token 總數"
},
"web_search": {
"type": [
"boolean",
"null"
],
"description": "表示是否使用了網路搜尋"
},
"money_spent": {
"type": [
"number",
"null"
],
"description": "AI token 成本（美元）
第三方 AI 模型供應商依其定價收取的費用"
},
"datetime": {
"type": [
"string",
"null"
],
"description": "收到結果的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：2019-11-15 12:57:46 +00:00"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseAiOptimizationLlmResponseElementItem"
}
]
},
"description": "回應項目陣列
包含結構化的 AI 回應資料"
},
"fan_out_queries": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "扇出查詢陣列
包含從主查詢衍生的相關搜尋查詢，以提供更全面的回答"
}
}
}
```
### Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResultInfo"
}
]
},
"description": "結果陣列"
}
}
}
]
}
```
### Response36Afe1097B20_BaseAiOptimizationLlmResponseElementItem
`#/components/schemas/Response36Afe1097B20_BaseAiOptimizationLlmResponseElementItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
}
},
"additionalProperties": false,
"discriminator": {
"propertyName": "type",
"mapping": {
"reasoning": "#/components/schemas/Response36Afe1097B20_ReasoningAiOptimizationLlmResponseElementItem",
"message": "#/components/schemas/Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem"
}
}
}
```
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API 的目前版本"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "一般狀態碼\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "一般資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "總執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中的任務數",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中傳回錯誤的任務數",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "任務識別碼\n我們系統中 UUID 格式的唯一任務識別碼"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "任務的狀態碼\n由 DataForSEO 產生，範圍如下：10000-60000\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "任務的資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 陣列中的元素數",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL 路徑"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "包含你在 POST 請求中指定的相同參數"
}
}
}
```