# پاسخ‌های زنده Claude LLM

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/claude/llm_responses/live`

**Tags:** DataForSEO

یک `user_prompt` به مدل Claude می‌فرستد و پاسخ آن را به‌صورت همگام برمی‌گرداند. `model_name` باید از `get_dataforseo_ai_claude_llm_responses_models` بیاید — نام‌ها شبیه `claude-sonnet-5` هستند و حدس معقول‌به‌نظر رد می‌شود. `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 برمی‌گرداند.

### مرجع قیمت‌گذاری

- اندازه‌گیری: هزینه پاسخ گزارش‌شده.
- برآورد درخواست مرجع: 0.0567 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.

فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

## Related links

- [نقطه پایانی Models](<https://docs.dataforseo.com/v3/ai_optimization/claude/llm_responses/models/>)
- [قیمت‌گذاری](<https://docs.anthropic.com/en/docs/about-claude/pricing>)

## 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": "<em>پرامپت مدل هوش مصنوعی</em><br><strong>فیلد الزامی</strong><br>پرسش یا وظیفه‌ای که می‌خواهید به مدل هوش مصنوعی بفرستید;<br>می‌توانید <strong>حداکثر 500 کاراکتر</strong> در فیلد <code>user_prompt</code> تعیین کنید"
          },
          "model_name": {
            "type": "string",
            "description": "<em>نام مدل هوش مصنوعی</em><br><strong>فیلد الزامی</strong><br><code>model_name</code >از نام واقعی مدل و نام نسخه تشکیل می‌شود;<br>اگر نام مدل پایه تعیین شود، آخرین نسخه آن به‌صورت پیش‌فرض تنظیم می‌شود;<br>مثلاً اگر <code>claude-opus-4-0</code> تعیین شود، <code>claude-opus-4-20250514</code> به‌صورت خودکار به‌عنوان <code>model_name</code> تنظیم می‌شود;<br>می‌توانید فهرست مدل‌های LLM موجود را با ارسال یک درخواست جداگانه به <code>https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models</code> دریافت کنید"
          },
          "max_output_tokens": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>حداکثر تعداد توکن‌ها در پاسخ هوش مصنوعی</em><br>فیلد اختیاری<br>حداقل مقدار: <code>1</code>;<br>حداکثر مقدار: <code>4096</code>;<br>مقدار پیش‌فرض: <code>2048</code>;<br><strong>توجه:</strong> اگر <code>web_search</code> روی <code>true</code> تنظیم شود یا مدل استدلالی در درخواست مشخص شود، تعداد توکن‌های خروجی ممکن است از محدودیت <code>max_output_tokens</code> فراتر رود<br><strong>توجه 2:</strong> اگر <code>use_reasoning</code> روی <code>true</code> تنظیم شود، حداقل مقدار برای <code>max_output_tokens</code> برابر <code>1025</code> است"
          },
          "temperature": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>تصادفی‌بودن پاسخ هوش مصنوعی</em><br>فیلد اختیاری<br>مقادیر بالاتر خروجی را متنوع‌تر می‌کنند; <br>مقادیر پایین‌تر خروجی را متمرکزتر می‌کنند;<br>حداقل مقدار: <code>0</code><br>حداکثر مقدار: <code>1</code><br>مقدار پیش‌فرض: <code>0.7</code><p><strong>توجه:</strong> <code>temperature</code> را نمی‌توان در همان درخواست همراه با <code>top_p</code> استفاده کرد"
          },
          "top_p": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>تنوع پاسخ هوش مصنوعی</em><br>فیلد اختیاری <br>با محدود کردن انتخاب توکن، تنوع پاسخ را کنترل می‌کند;<br>حداقل مقدار: <code>0</code><br>حداکثر مقدار: <code>1</code> <br>مقدار پیش‌فرض: <code>null</code><p><strong>توجه:</strong> <code>top_p</code> را نمی‌توان در همان درخواست همراه با <code>temperature</code> استفاده کرد"
          },
          "web_search": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>فعال‌سازی جستجوی وب برای دریافت اطلاعات روز</em><br>فیلد اختیاری<br>وقتی فعال باشد، مدل هوش مصنوعی می‌تواند به اطلاعات روز وب دسترسی پیدا کند و به آن‌ها استناد کند;<br><strong>توجه:</strong> برای فهرست مدل‌هایی که از <code>web_search</code> پشتیبانی می‌کنند به نقطه پایانی Models مراجعه کنید; <br>مقدار پیش‌فرض: <code>false</code>;<br>هزینه این پارامتر را می‌توان در صفحه قیمت‌گذاری محاسبه کرد"
          },
          "force_web_search": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>اجبار عامل هوش مصنوعی به استفاده از جستجوی وب</em><br>فیلد اختیاری<br>برای فعال‌سازی این پارامتر، <code>web_search</code> نیز باید فعال باشد;<br>وقتی فعال باشد، مدل هوش مصنوعی موظف است به اطلاعات روز وب دسترسی پیدا کند و به آن‌ها استناد کند;<br>مقدار پیش‌فرض: <code>false</code>;<br><strong>توجه:</strong> حتی اگر پارامتر روی <code>true</code> تنظیم شود، تضمینی برای استناد به منابع وب در پاسخ وجود ندارد"
          },
          "web_search_country_iso_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>کد کشور ISO موقعیتی که برای جستجوی وب استفاده می‌شود</em><br>فیلد اختیاری<br>مقادیر ممکن: <code>'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'</code>"
          },
          "web_search_city": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>نام شهر موقعیتی که برای جستجوی وب استفاده می‌شود</em><br>فیلد اختیاری<br>"
          },
          "system_message": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>دستورالعمل‌های رفتار هوش مصنوعی</em><br>فیلد اختیاری<br>نقش، لحن یا رفتار مشخص هوش مصنوعی را تعیین می‌کند;<br>می‌توانید <strong>حداکثر 500 کاراکتر</strong> در فیلد <code>system_message</code> تعیین کنید"
          },
          "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هر شیء باید شامل این موارد باشد:\nرشته role با مقدار user یا ai;\nرشته message با محتوای پیام (حداکثر 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": "<em>فعال‌سازی استدلال برای مدل هوش مصنوعی</em><br>فیلد اختیاری<br>وقتی فعال باشد، مدل پیش از تولید پاسخ استدلال انجام می‌دهد<br>برای فهرست مدل‌هایی که از <code>reasoning</code> پشتیبانی می‌کنند به نقطه پایانی Models مراجعه کنید<br>مقدار پیش‌فرض: <code>false</code><br><strong>توجه:</strong> اگر روی <code>true</code> تنظیم شود، حداقل مقدار برای <code>max_output_tokens</code> برابر <code>1025</code> است<br><strong>توجه 2:</strong> اگر روی <code>true</code> تنظیم شود، <code>force_web_search</code> باید روی <code>false</code> تنظیم شود<br><strong>توجه 3:</strong> اگر روی <code>true</code> تنظیم شود، <code>temperature</code> و <code>top_p</code> قابل استفاده نیستند"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>شناسه وظیفه تعریف‌شده توسط کاربر</em><br>فیلد اختیاری<br><em>محدودیت کاراکتر 255 است</em><br>می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید<br>مقدار <code>tag</code> مشخص‌شده را در شیء <code>data</code> پاسخ پیدا می‌کنید"
          }
        },
        "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 — یک کلید API معتبر Felo لازم است.

### 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": "<em>آرایه‌ای از وظایف</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResultInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "model_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نام مدل هوش مصنوعی استفاده‌شده</em>"
    },
    "input_tokens": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>تعداد توکن‌ها در ورودی</em><br>مجموع توکن‌های پردازش‌شده"
    },
    "output_tokens": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>تعداد توکن‌ها در خروجی</em><br>مجموع توکن‌های تولیدشده در پاسخ هوش مصنوعی"
    },
    "reasoning_tokens": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>تعداد توکن‌های استدلال</em><br>مجموع توکن‌های استفاده‌شده برای تولید محتوای استدلال"
    },
    "web_search": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>نشان می‌دهد آیا از جستجوی وب استفاده شده است</em>"
    },
    "money_spent": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>هزینه توکن‌های هوش مصنوعی، دلار آمریکا</em><br>قیمتی که ارائه‌دهنده مدل هوش مصنوعی ثالث بر اساس قیمت‌گذاری خود دریافت می‌کند"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاریخ و زمانی که نتیجه دریافت شده است</em><br>در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseAiOptimizationLlmResponseElementItem"
          }
        ]
      },
      "description": "<em>آرایه‌ای از آیتم‌های پاسخ</em><br>حاوی داده‌های ساختاریافته پاسخ هوش مصنوعی است"
    },
    "fan_out_queries": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>آرایه‌ای از پرس‌وجوهای انشعابی</em><br>حاوی پرس‌وجوهای جستجوی مرتبط مشتق‌شده از پرس‌وجوی اصلی برای ارائه پاسخ جامع‌تر است"
    }
  }
}
```

### 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": "<em>آرایه‌ای از نتایج</em>"
        }
      }
    }
  ]
}
```

### 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 تعیین کرده‌اید"
    }
  }
}
```
