v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Pro

Felo API Support

MIT

الخادم

https://openapi.felo.ai

مكتبات العملاء

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API العمليات

post/v1/beta/perplexity/sonar-pro

Perplexity Sonar Pro

أنشئ إجابة لسؤال متعدّد الأجزاء باستخدام البحث على الويب والاستشهادات. model وmessages مطلوبان؛ استخدم النموذج sonar-pro لنقطة النهاية هذه. يغطّي هذا العقد العام استجابات JSON غير متدفقة مع stream false. اقرأ choices[].message.content وcitations وsearch_results للحصول على الإجابة ومصادرها. يبلّغ usage عن استهلاك الموارد، لا عن رسم على أرصدة Felo.

مرجع التسعير

القياس: تكلفة الاستجابة المُبلَّغ عنها.
تقدير الطلب المرجعي: 0.11273 دولار أمريكي.
مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم

مطلوب

application/json

messages
النوع: array object[]
مطلوب

قائمة رسائل تتكون منها المحادثة حتى الآن.
- content
  النوع: string
  مطلوب
  
  محتوى الرسالة.
- role
  النوع: string تعداد
  مطلوب
  
  دور مؤلف الرسالة.
  
  القيم
  system
  user
  assistant
model
النوع: string تعداد
مطلوب

نموذج Sonar المراد استخدامه.
القيم
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
النوع: number
الحد الأدنى:
0
الحد الأقصى:
2

يعاقب الرموز الجديدة بناءً على تكرارها الحالي في النص حتى الآن. القيم الموجبة تقلل احتمال تكرار السطر نفسه حرفيًا.
max_tokens
النوع: integer

الحد الأقصى لعدد الرموز المراد توليدها في الاستجابة.
presence_penalty
النوع: number
الحد الأدنى:
-2
الحد الأقصى:
2

يعاقب الرموز الجديدة بناءً على ظهورها في النص حتى الآن. القيم الموجبة تزيد احتمال التحدث في مواضيع جديدة.
return_citations
النوع: boolean

هل تُعاد الاستشهادات ونتائج البحث في الاستجابة.
search_context
النوع: string تعداد

يتحكم في مقدار سياق البحث المستخدم. يؤثر على تكلفة كل طلب.
القيم
- low
- medium
- high
search_domain_filter
النوع: array string[]

تقييد البحث بنطاقات محددة.
search_recency_filter
النوع: string تعداد

تصفية نتائج البحث حسب الحداثة.
القيم
- month
- week
- day
- hour
stream
النوع: boolean

هل تُبَث الاستجابة باستخدام أحداث مرسلة من الخادم.
temperature
النوع: number
الحد الأدنى:
0
الحد الأقصى:
2

درجة حرارة أخذ العينات بين 0 و2. القيم الأقل تجعل المخرجات أكثر تركيزًا وحتمية.
top_k
النوع: integer
الحد الأدنى:
0
الحد الأقصى:
2048

عدد الرموز المراد الاحتفاظ بها لترشيح top-k.

top_p
النوع: number
الحد الأدنى:
0
الحد الأقصى:
1

معامل أخذ العينات النووي. ينظر النموذج في الرموز ذات كتلة الاحتمال top_p.

الاستجابات

200
النوع: object · ResponseD5E2470Dd28B_ChatCompletionResponse

استجابة ناجحة مع إجابة بالذكاء الاصطناعي واستشهادات
choices
النوع: array object[]
finish_reason
النوع: string تعداد
القيم
stop
length
index
النوع: integer

Integer numbers.

message
النوع: object
content
النوع: string

الإجابة المولّدة بالذكاء الاصطناعي، مع مراجع استشهاد مضمنة مثل [1][2].

role
النوع: string
citations
النوع: array string[]

قائمة عناوين URL المصدرية المشار إليها في الإجابة.

created
النوع: integer

طابع وقت Unix لإنشاء الإكمال.

id
النوع: string

معرّف فريد للإكمال.

model
النوع: string

النموذج المستخدم للإكمال.

object
النوع: string
search_results
النوع: array object[]

نتائج بحث مفصّلة مع العناوين والمقتطفات وعناوين URL.

date
النوع: string
snippet
النوع: string
source
النوع: string
title
النوع: string
url
النوع: string
usage
النوع: object
completion_tokens
النوع: integer

Integer numbers.

prompt_tokens
النوع: integer

Integer numbers.

search_context_size
النوع: string
total_tokens
النوع: integer

Integer numbers.
application/json
400

تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
401

مطلوب مفتاح API صالح من Felo.
402

لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
403

الحساب غير مصرّح له بهذه العملية.
429

تم بلوغ حد الطلبات أو حد الإنفاق.
502

تعذّر على الخدمة إكمال الطلب.
503

خدمة API أو الفوترة غير متاحة مؤقتًا.
504

انتهت مهلة الخدمة أثناء معالجة الطلب.
default

استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

application/json

post/v1/beta/perplexity/sonar-pro

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-pro \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar-pro", "messages": [{"role": "user", "content": "Compare Cache-Control no-cache and no-store, citing HTTP documentation."}], "max_tokens": 1024, "stream": false}'

عرض المخطط

{
  "id": "example-sonar-pro-completion",
  "model": "sonar-pro",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "no-cache requires validation before reuse; no-store prohibits storage. [1]"
      },
      "finish_reason": "stop"
    }
  ],
  "citations": [
    "https://www.rfc-editor.org/rfc/rfc9111.html"
  ],
  "search_results": [
    {
      "title": "HTTP Caching",
      "url": "https://www.rfc-editor.org/rfc/rfc9111.html"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 40,
    "total_tokens": 65
  }
}

استجابة ناجحة مع إجابة بالذكاء الاصطناعي واستشهادات

Perplexity Sonar Pro

المصادقةRequired

Perplexity API

Perplexity Sonar Pro

مرجع التسعير