Felo API PlatformFelo API Platform
כל ה-endpoints של Perplexity
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 פעולות

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 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[]

      רשימת כתובות 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
Request Example for 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
  }
}

תגובה מוצלחת עם תשובת AI וציטוטים

Perplexity Sonar Pro