Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ 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; ใช้ model sonar-pro สำหรับ endpoint นี้ สัญญาสาธารณะนี้ครอบคลุมการตอบกลับ JSON แบบไม่สตรีมมิ่งด้วย stream false อ่านคำตอบและแหล่งที่มาจาก choices[].message.content, citations และ search_results usage รายงานการใช้ทรัพยากร ไม่ใช่ค่าบริการเครดิต Felo

ข้อมูลอ้างอิงราคา

  • การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
  • ค่าประมาณคำขออ้างอิง: USD 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

    ว่าจะสตรีมการตอบกลับโดยใช้ server-sent events หรือไม่

  • 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

      เวลาประทับยูนิกซ์เมื่อสร้าง completion

    • id
      ประเภท: string

      ตัวระบุเฉพาะของ completion

    • model
      ประเภท: string

      โมเดลที่ใช้สำหรับ completion

    • 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