DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
「LLM Responses Claude」タスクの設定
Claude のプロンプトを待たずにキューに登録し、タスク id を返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。先に get_dataforseo_ai_claude_llm_responses_models で task_post_supported を確認し、get_dataforseo_ai_claude_llm_responses_fetch で取得してください。
料金の参考情報
- 計測方法: 報告されたレスポンスコスト。
- 参考リクエスト見積もり: 0.701 USD。
- 参照用の顧客乗数: 1.0。確定済みの顧客金額に再度適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- force型: boolean | null
_web _search AI エージェントにウェブ検索を強制
任意フィールド
このパラメーターを有効にするには、web_searchも有効にする必要があります
有効にすると、AI モデルは現在のウェブ情報にアクセスして引用することが強制されます
デフォルト値:false
注意: パラメーターをtrueに設定しても、レスポンスでウェブソースが引用される保証はありません - max型: integer | null
_output _tokens AI レスポンスの最大トークン数
任意フィールド
最小値:1
最大値:4096
デフォルト値:2048
注意:web_searchをtrueに設定した場合、またはリクエストで推論モデルを指定した場合、出力トークン数が指定したmax_output_tokensの上限を超えることがあります
注意 2:use_reasoningをtrueに設定した場合、max_output_tokensの最小値は1025です - 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は実際のモデル名とバージョン名で構成されます
基本モデル名を指定した場合、その最新バージョンがデフォルトで設定されます
たとえばclaude-opus-4-0を指定すると、claude-opus-4-20250514が自動的にmodel_nameに設定されます
別途https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/modelsにリクエストを送信すると、利用可能な LLM モデルの一覧を取得できます - pingback型: string | null
_url タスク完了通知の URL
任意フィールド
タスクが完了すると、指定した URL に GET リクエストを送信して通知します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストの送信前に必要な値を設定します
例:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意:pingback_url内の特殊文字は URL エンコードされます
たとえば、#文字は%23にエンコードされます - postback型: string | null
_url タスク結果送信用の URL
任意フィールド
タスクが完了すると、結果をgzip形式で圧縮し、指定したpostback_urlに POST リクエストを送信します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストの送信前に必要な値を設定します。
例:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
注意:postback_url内の特殊文字は URL エンコードされます
たとえば、#文字は%23にエンコードされます - system型: string | null
_message AI の動作に関する指示
任意フィールド
AI の役割、トーン、または特定の動作を定義しますsystem_messageフィールドには最大 500 文字を指定できます - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - temperature型: number | null
AI レスポンスのランダム性
任意フィールド
値が大きいほど出力が多様になります
値が小さいほど出力が集中します
最小値:0
最大値:1
デフォルト値:0.7注意: 同じリクエストで
temperatureとtop_pを併用することはできません - top型: number | null
_p AI レスポンスの多様性
任意フィールド
トークンの選択を制限してレスポンスの多様性を制御します
最小値:0
最大値:1
デフォルト値:null注意: 同じリクエストで
top_pとtemperatureを併用することはできません - use型: boolean | null
_reasoning - user型: string
_prompt AI モデルへのプロンプト
必須フィールド
AI モデルに送信する質問またはタスクuser_promptフィールドには最大 500 文字を指定できます - web型: boolean | null
_search - web型: string | null
_search _city ウェブ検索に使用するロケーションの都市名
任意フィールド - web型: string | null
_search _country _iso _code ウェブ検索に使用するロケーションの 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'
- 型: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: object | null
結果の配列
この場合、値はnullになります - 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/claude/llm_responses/task_post \
--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": 1024,
"temperature": 0.3,
"web_search_country_iso_code": "FR",
"model_name": "claude-sonnet-4-0",
"web_search": true,
"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": null
}
]
}