Perplexity Sonar Deep Research

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-deep-research

Perplexity Sonar Deep Research

สร้างรายงานวิจัยโดยใช้การค้นหาเว็บหลายครั้งและแหล่งที่อ้างอิง ต้องระบุ model และ messages; ใช้ model sonar-deep-research สำหรับ endpoint นี้ สัญญาสาธารณะนี้ครอบคลุมการตอบกลับ JSON แบบไม่สตรีมมิ่งด้วย stream false การวิจัยอาจใช้เวลาหลายนาทีและอาจเกิน timeout ของเกตเวย์หรือไคลเอนต์ อ่านรายงานและแหล่งที่มาจาก choices[].message.content, citations และ search_results usage ไม่ใช่ค่าบริการเครดิต Felo

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

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

post/v1/beta/perplexity/sonar-deep-research

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-deep-research \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar-deep-research", "messages": [{"role": "user", "content": "Research HTTP caching strategies for public APIs, with references to standards."}], "max_tokens": 4096, "stream": false}'

แสดงสคีมา

{
  "id": "example-sonar-deep-research-completion",
  "model": "sonar-deep-research",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Public API caching combines freshness controls and conditional requests. [1][2]"
      },
      "finish_reason": "stop"
    }
  ],
  "citations": [
    "https://www.rfc-editor.org/rfc/rfc9111.html",
    "https://www.rfc-editor.org/rfc/rfc9110.html"
  ],
  "search_results": [
    {
      "title": "HTTP Caching",
      "url": "https://www.rfc-editor.org/rfc/rfc9111.html"
    },
    {
      "title": "HTTP Semantics",
      "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    }
  ],
  "usage": {
    "prompt_tokens": 40,
    "completion_tokens": 80,
    "total_tokens": 120
  }
}

การตอบกลับสำเร็จพร้อมคำตอบ AI และการอ้างอิง

Perplexity Sonar Deep Research

การยืนยันตัวตนRequired

Perplexity API

Perplexity Sonar Deep Research

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