Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
حلّل سؤالًا يتطلب استدلالًا مدعومًا بالبحث على الويب والاستشهادات. model وmessages مطلوبان؛ استخدم النموذج sonar-reasoning-pro لنقطة النهاية هذه. يغطّي هذا العقد العام استجابات JSON غير متدفقة مع stream false. اقرأ choices[].message.content وcitations وsearch_results للحصول على الإجابة ومصادرها. usage ليس رسمًا على أرصدة Felo.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.03499 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array object[]messagesمطلوب
قائمة رسائل تتكون منها المحادثة حتى الآن.
- contentالنوع: stringمطلوب
محتوى الرسالة.
- roleالنوع: string تعدادمطلوب
دور مؤلف الرسالة.
القيم- system
- user
- assistant
- النوع: string تعدادmodelمطلوب
نموذج Sonar المراد استخدامه.
القيم- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- النوع: numberfrequency
_penalty الحد الأدنى:0الحد الأقصى:2يعاقب الرموز الجديدة بناءً على تكرارها الحالي في النص حتى الآن. القيم الموجبة تقلل احتمال تكرار السطر نفسه حرفيًا.
- النوع: integermax
_tokens الحد الأقصى لعدد الرموز المراد توليدها في الاستجابة.
- النوع: numberpresence
_penalty الحد الأدنى:-2الحد الأقصى:2يعاقب الرموز الجديدة بناءً على ظهورها في النص حتى الآن. القيم الموجبة تزيد احتمال التحدث في مواضيع جديدة.
- النوع: booleanreturn
_citations هل تُعاد الاستشهادات ونتائج البحث في الاستجابة.
- النوع: string تعدادsearch
_context يتحكم في مقدار سياق البحث المستخدم. يؤثر على تكلفة كل طلب.
القيم- low
- medium
- high
- النوع: array string[]search
_domain _filter تقييد البحث بنطاقات محددة.
- النوع: string تعدادsearch
_recency _filter تصفية نتائج البحث حسب الحداثة.
القيم- month
- week
- day
- hour
- النوع: booleanstream
هل تُبَث الاستجابة باستخدام أحداث مرسلة من الخادم.
- النوع: numbertemperatureالحد الأدنى:0الحد الأقصى:2
درجة حرارة أخذ العينات بين 0 و2. القيم الأقل تجعل المخرجات أكثر تركيزًا وحتمية.
- النوع: integertop
_k الحد الأدنى:0الحد الأقصى:2048عدد الرموز المراد الاحتفاظ بها لترشيح top-k.
- النوع: numbertop
_p الحد الأدنى:0الحد الأقصى:1معامل أخذ العينات النووي. ينظر النموذج في الرموز ذات كتلة الاحتمال top_p.
- النوع: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
استجابة ناجحة مع إجابة بالذكاء الاصطناعي واستشهادات
- النوع: array object[]choices
- finishالنوع: string تعداد
_reason القيم- stop
- length
- indexالنوع: integer
Integer numbers.
- messageالنوع: object
- contentالنوع: string
الإجابة المولّدة بالذكاء الاصطناعي، مع مراجع استشهاد مضمنة مثل [1][2].
- roleالنوع: string
- النوع: array string[]citations
قائمة عناوين URL المصدرية المشار إليها في الإجابة.
- النوع: integercreated
طابع وقت Unix لإنشاء الإكمال.
- النوع: stringid
معرّف فريد للإكمال.
- النوع: stringmodel
النموذج المستخدم للإكمال.
- النوع: stringobject
- النوع: array object[]search
_results نتائج بحث مفصّلة مع العناوين والمقتطفات وعناوين URL.
- dateالنوع: string
- snippetالنوع: string
- sourceالنوع: string
- titleالنوع: string
- urlالنوع: string
- النوع: objectusage
- completionالنوع: integer
_tokens Integer numbers.
- promptالنوع: integer
_tokens Integer numbers.
- searchالنوع: string
_context _size - totalالنوع: integer
_tokens Integer numbers.
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-reasoning-pro \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"model": "sonar-reasoning-pro", "messages": [{"role": "user", "content": "Explain when conditional HTTP requests save bandwidth, citing the standards."}], "max_tokens": 2048, "stream": false}'
{
"id": "example-sonar-reasoning-pro-completion",
"model": "sonar-reasoning-pro",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A successful cache validation can avoid transferring an unchanged body. [1]"
},
"finish_reason": "stop"
}
],
"citations": [
"https://www.rfc-editor.org/rfc/rfc9110.html"
],
"search_results": [
{
"title": "HTTP Semantics",
"url": "https://www.rfc-editor.org/rfc/rfc9110.html"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 50,
"total_tokens": 80
}
}