# ライブ ChatGPT LLM レスポンス **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live` **Tags:** DataForSEO `user_prompt` を ChatGPT モデルに送信し、同期的に返信を返します。`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` が消費者体験を再現します。 ### 料金の参考情報 - 計測方法：報告されたレスポンスコスト。 - 参考リクエスト見積もり：USD 0.0695。 - 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。 参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "user_prompt": { "type": "string", "description": "AI モデルへのプロンプト
必須フィールド
AI モデルに送信する質問またはタスク
user_prompt フィールドには最大 500 文字を指定できます" }, "model_name": { "type": "string", "description": "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 モデルの一覧を取得できます" }, "max_output_tokens": { "type": [ "integer", "null" ], "description": "AI レスポンスの最大トークン数
任意フィールド
推論モデル（例: Models エンドポイントで reasoning が true）の最小値: 1024
非推論モデルの最小値: 16
最大値: 4096
デフォルト値: 2048
注意: web_search を true に設定した場合、またはリクエストで推論モデルを指定した場合、出力トークン数が指定した max_output_tokens の上限を超えることがあります" }, "temperature": { "type": [ "number", "null" ], "description": "AI レスポンスのランダム性
任意フィールド
値が大きいほど出力が多様になります
値が小さいほど出力が集中します
最小値: 0
最大値: 2
デフォルト値: 0.94
注意: 推論モデルではサポートされていません" }, "top_p": { "type": [ "number", "null" ], "description": "AI レスポンスの多様性
任意フィールド
トークンの選択を制限してレスポンスの多様性を制御します
最小値: 0
最大値: 1
デフォルト値: 0.92

注意: 同じリクエストで top_p と temperature を併用することはできません" }, "web_search": { "type": [ "boolean", "null" ], "description": "ウェブ検索を有効化
任意フィールド
有効にすると、AI モデルは現在のウェブ情報にアクセスして引用できます
デフォルト値: false
注意: web_search をサポートするモデルの一覧については、Models エンドポイントを参照してください" }, "force_web_search": { "type": [ "boolean", "null" ], "description": "AI エージェントにウェブ検索を強制
任意フィールド
このパラメーターを有効にするには、web_search も有効にする必要があります
有効にすると、AI モデルは現在のウェブ情報にアクセスして引用することが強制されます
デフォルト値: false
注意: パラメーターを true に設定しても、レスポンスでウェブソースが引用される保証はありません
注意 2: 推論モデルではサポートされていません" }, "web_search_country_iso_code": { "type": [ "string", "null" ], "description": "ロケーションの ISO 国コード
任意フィールド
このパラメーターを有効にするには、web_search も有効にする必要があります
有効にすると、AI モデルは指定した国からウェブ検索を行います
注意: o3-mini、o1-pro、o1 モデルではサポートされていません" }, "web_search_city": { "type": [ "string", "null" ], "description": "ロケーションの都市名
任意フィールド
注意: o3-mini、o1-pro、o1 モデルではサポートされていません" }, "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?\"}]" }, "tag": { "type": [ "string", "null" ], "description": "ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定した tag の値は、レスポンスの data オブジェクトに含まれます" } }, "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, "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" } ] } ] }, "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, "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" } ] } ``` ## Responses ### 200 — 操作成功 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo" } ] } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo` ```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_AiOptimizationChatGptLlmResponsesLiveTaskInfo" } ] }, "description": "タスクの配列" } } } ] } ``` ### Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResultInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResultInfo` ```json { "type": "object", "properties": { "model_name": { "type": [ "string", "null" ], "description": "使用された AI モデルの名前" }, "input_tokens": { "type": [ "integer", "null" ], "description": "入力内のトークン数
処理されたトークンの合計数" }, "output_tokens": { "type": [ "integer", "null" ], "description": "出力内のトークン数
AI レスポンスで生成されたトークンの合計数" }, "reasoning_tokens": { "type": [ "integer", "null" ], "description": "推論トークン数
推論コンテンツの生成に使用されたトークンの合計数" }, "web_search": { "type": [ "boolean", "null" ], "description": "ウェブ検索が使用されたかどうかを示します" }, "money_spent": { "type": [ "number", "null" ], "description": "AI トークンのコスト（米ドル）
サードパーティの 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_AiOptimizationChatGptLlmResponsesLiveTaskInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo` ```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_AiOptimizationChatGptLlmResponsesLiveResultInfo" } ] }, "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": "タスクの総コスト（USD）", "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": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "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 リクエストで指定したものと同じパラメーターを含みます" } } } ```