DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव Perplexity LLM Responses
किसी Perplexity मॉडल को user_prompt भेजता है और उसका उत्तर सिंक्रोनस रूप से लौटाता है। model_name get_dataforseo_ai_perplexity_llm_responses_models से आना चाहिए — sonar, sonar-pro और sonar-reasoning-pro। web_search_country_iso_code खोज का दायरा तय करता है, जो अन्य तीन विक्रेता नहीं देते। model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items और fan_out_queries लौटाता है। यह देखने के लिए कि एक प्रॉम्प्ट पर वास्तव में कितना खर्च हुआ, response में money_spent पढ़ें। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत।
- संदर्भ request अनुमान: USD 0.0163
- संदर्भ ग्राहक गुणक: 1.0. अंतिम रूप से निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
केवल संदर्भ मेटाडेटा, खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। Resource credits, Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- maxटाइप: integer | null
_output _tokens AI रिस्पॉन्स में टोकन की अधिकतम संख्या
वैकल्पिक फ़ील्ड
न्यूनतम मान:1
अधिकतम मान:4096;
डिफ़ॉल्ट मान:2048;
नोट: यदि रिक्वेस्ट में reasoning मॉडल निर्दिष्ट है, तो आउटपुट टोकन संख्या निर्दिष्टmax_output_tokensसीमा से अधिक हो सकती है - messageटाइप: array (object | null)[] | null
_chain बातचीत का इतिहास वैकल्पिक फ़ील्ड पिछले बातचीत टर्न को दर्शाने वाले message ऑब्जेक्ट का ऐरे; हर ऑब्जेक्ट में होना चाहिए: role — user या ai भूमिका वाला स्ट्रिंग; message — message सामग्री वाला स्ट्रिंग (अधिकतम 500 अक्षर); ऐरे में अधिकतम 10 message ऑब्जेक्ट निर्दिष्ट कर सकते हैं; नोट: Perplexity मॉडल के लिए message को 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
message टेक्स्ट
- roleटाइप: string | null
उस उपयोगकर्ता की भूमिका जिससे message आता है
- modelटाइप: string
_name AI मॉडल का नाम
आवश्यक फ़ील्डmodel_nameमें वास्तविक मॉडल नाम और वर्ज़न नाम होता है;
यदि केवल आधार मॉडल नाम निर्दिष्ट है, तो डिफ़ॉल्ट रूप से उसका नवीनतम वर्ज़न सेट होगा;
उपलब्ध LLM मॉडल की सूची निम्न endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं:https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models - systemटाइप: string | null
_message AI व्यवहार के लिए निर्देश
वैकल्पिक फ़ील्ड
AI की भूमिका, टोन या विशिष्ट व्यवहार परिभाषित करता है
आपsystem_messageफ़ील्ड में अधिकतम 500 अक्षर निर्दिष्ट कर सकते हैं - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - temperatureटाइप: number | null
AI रिस्पॉन्स की रैंडमनेस
वैकल्पिक फ़ील्ड
अधिक मान आउटपुट को अधिक विविध बनाते हैं
कम मान आउटपुट को अधिक केंद्रित बनाते हैं
न्यूनतम मान:0
अधिकतम मान:1.9
डिफ़ॉल्ट मान:0.77 - topटाइप: number | null
_p AI response की विविधता
वैकल्पिक फ़ील्ड
टोकन चयन सीमित करके response की विविधता नियंत्रित करता है
न्यूनतम मान:0
अधिकतम मान:1
डिफ़ॉल्ट मान:0.9 - userटाइप: string
_prompt AI मॉडल के लिए प्रॉम्प्ट
आवश्यक फ़ील्ड
वह प्रश्न या कार्य जो आप AI मॉडल को भेजना चाहते हैं;
आपuser_promptफ़ील्ड में अधिकतम 500 अक्षर निर्दिष्ट कर सकते हैं - webटाइप: string | null
_search _country _iso _code वेब सर्च लोकलाइज़ेशन के लिए देश कोड
वैकल्पिक फ़ील्ड
लोकलाइज़्ड वेब सर्च परिणाम प्राप्त करने के लिए देश का ISO कोड निर्दिष्ट करें
नोट: केवल Perplexity Sonar मॉडल के लिए उपलब्ध
उदाहरण:US
- टाइप: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- 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टाइप: object | null
_out _queries fan-out क्वेरी का ऐरे
अधिक व्यापक उत्तर देने के लिए मुख्य क्वेरी से निकाली गई संबंधित सर्च क्वेरी शामिल हैं - inputटाइप: integer | null
_tokens input में टोकन की संख्या
प्रोसेस किए गए टोकन की कुल संख्या - itemsटाइप: array (object | null)[] | null
response आइटम का ऐरे
संरचित AI response डेटा शामिल है- टाइप: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- टाइप: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeडिस्क्रिमिनेटरटाइप: string | null
एलिमेंट का प्रकार
- sectionsटाइप: array (object | null)[] | null
रीज़निंग चेन अनुभाग
LLM द्वारा उत्पन्न रीज़निंग चेन अनुभागों वाले ऑब्जेक्ट का ऐरे- annotationsटाइप: array (object | null)[] | null
response उत्पन्न करने के लिए उपयोग किए गए संदर्भों का ऐरे
nullके बराबर यदिweb_searchपैरामीटरtrueपर सेट नहीं है
नोट:annotationsखाली भी लौट सकता है, भले हीweb_searchtrueहो, क्योंकि AI वेब जानकारी प्राप्त करने का प्रयास करेगा लेकिन प्रासंगिक परिणाम नहीं मिल सकते- directटाइप: string | null
_url उद्धृत स्रोत का सीधा URL
वह मूल स्रोत URL शामिल है जिस तकurlफ़ील्ड में Vertex AI रीडायरेक्ट ले जाता है - endटाइप: integer | null
_index एनोटेशन इंडेक्सिंग का अंत
- startटाइप: integer | null
_index एनोटेशन इंडेक्सिंग की शुरुआत
- textटाइप: string | null
रीज़निंग चेन अनुभाग का टेक्स्ट
रीज़निंग चेन अनुभाग का टेक्स्ट जो मॉडल की सोच प्रक्रिया का सारांश देता है - titleटाइप: string | null
उद्धृत स्रोत का डोमेन नाम या शीर्षक
- urlटाइप: string | null
उद्धृत स्रोत का रीडायरेक्ट URL
मूल स्रोत तक ले जाने वाला Vertex AI रीडायरेक्ट शामिल है
- textटाइप: string | null
रीज़निंग चेन अनुभाग का टेक्स्ट
रीज़निंग चेन अनुभाग का टेक्स्ट जो मॉडल की सोच प्रक्रिया का सारांश देता है - typeटाइप: string | null
एलिमेंट का प्रकार
- modelटाइप: string | null
_name उपयोग किए गए AI मॉडल का नाम
- moneyटाइप: number | null
_spent - outputटाइप: integer | null
_tokens output में टोकन की संख्या
AI response में जनरेट किए गए टोकन की कुल संख्या - reasoningटाइप: integer | null
_tokens Integer numbers.
- webटाइप: boolean | null
_search बताता है कि वेब सर्च का उपयोग हुआ या नहीं
नोट: Perplexity Sonar मॉडल में वेब सर्च डिफ़ॉल्ट रूप से सक्षम है
- resultटाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- 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
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/perplexity/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,
"web_search_country_iso_code": "FR",
"model_name": "sonar",
"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": "[Max Depth Exceeded]",
"sections": "[Max Depth Exceeded]"
}
],
"fan_out_queries": null
}
]
}
]
}