v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar

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

Perplexity Sonar

ویب حوالہ جات کے ساتھ مختصر جواب تیار کریں۔ model اور messages درکار ہیں؛ اس endpoint کے لیے sonar ماڈل استعمال کریں۔ یہ عوامی کنٹریکٹ stream false کے ساتھ غیر اسٹریمنگ JSON جوابات کا احاطہ کرتا ہے۔ جواب choices[].message.content سے اور ماخذ citations اور search_results سے پڑھیں۔ usage ریسورس کی کھپت بتاتا ہے، Felo کریڈٹ چارج نہیں۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: USD 0.12783۔
حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی

لازمی

application/json

messages
قسم: array object[]
لازمی

اب تک کی گفتگو پر مشتمل پیغامات کی فہرست۔
- content
  قسم: string
  لازمی
  
  پیغام کا مواد۔
- role
  قسم: string enum
  لازمی
  
  پیغام کے مصنف کا کردار۔
  
  اقدار
  system
  user
  assistant
model
قسم: string enum
لازمی

استعمال کرنے کے لیے 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 enum

کنٹرول کرتا ہے کہ کتنا سرچ کانٹیکسٹ استعمال ہوگا۔ فی درخواست لاگت پر اثر ڈالتا ہے۔
اقدار
- low
- medium
- high
search_domain_filter
قسم: array string[]

تلاش کو مخصوص ڈومینز تک محدود کریں۔
search_recency_filter
قسم: string enum

سرچ نتائج کو تازگی کے مطابق فلٹر کریں۔
اقدار
- 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

AI جواب اور حوالہ جات کے ساتھ کامیاب جواب
choices
قسم: array object[]
finish_reason
قسم: string enum
اقدار
stop
length
index
قسم: integer

Integer numbers.

message
قسم: object
content
قسم: string

AI سے تیار کردہ جواب، جس میں [1][2] جیسے اندرونی حوالہ جات شامل ہیں۔

role
قسم: string
citations
قسم: array string[]

جواب میں حوالہ دیے گئے ماخذ URLs کی فہرست۔

created
قسم: integer

completion بنانے کے وقت کا Unix ٹائم اسٹیمپ۔

id
قسم: string

completion کے لیے منفرد شناخت کنندہ۔

model
قسم: string

completion کے لیے استعمال ہونے والا ماڈل۔

object
قسم: string
search_results
قسم: array object[]

عنوانات، اسنیپٹس اور URLs کے ساتھ تفصیلی سرچ نتائج۔

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

درست Felo API کلید درکار ہے۔
402

درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
403

اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
429

درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
502

سروس درخواست مکمل نہیں کر سکی۔
503

API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
504

درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
default

خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

application/json

post/v1/beta/perplexity/sonar

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar", "messages": [{"role": "user", "content": "What is HTTP caching? Cite the relevant documentation."}], "max_tokens": 512, "stream": false}'

اسکیما دکھائیں

{
  "id": "example-sonar-completion",
  "model": "sonar",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "HTTP caching reuses stored responses when permitted by cache rules. [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": 20,
    "completion_tokens": 30,
    "total_tokens": 50
  }
}

AI جواب اور حوالہ جات کے ساتھ کامیاب جواب

Perplexity Sonar

توثیقRequired

Perplexity API

Perplexity Sonar

قیمت کا حوالہ