v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Deep Research

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API Operasi

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

Perplexity Sonar Deep Research

Hasilkan laporan riset menggunakan beberapa pencarian web dan sumber bersitasi. model dan messages wajib; gunakan model sonar-deep-research untuk endpoint ini. Kontrak publik ini mencakup respons JSON non-streaming dengan stream false. Riset dapat memakan waktu beberapa menit dan melebihi batas waktu gateway atau klien. Baca choices[].message.content, citations, dan search_results untuk laporan dan sumbernya. usage bukan biaya kredit Felo.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.23932.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi

wajib

application/json

messages
Tipe: array object[]
wajib

Daftar message yang membentuk percakapan sejauh ini.
- content
  Tipe: string
  wajib
  
  Konten message.
- role
  Tipe: string enum
  wajib
  
  Peran penulis message.
  
  nilai
  system
  user
  assistant
model
Tipe: string enum
wajib

Model Sonar yang akan digunakan.
nilai
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Tipe: number
min:
0
maks:
2

Menghukum token baru berdasarkan frekuensi kemunculannya dalam teks sejauh ini. Nilai positif menurunkan kemungkinan mengulang baris yang sama secara verbatim.
max_tokens
Tipe: integer

Jumlah maksimum token yang akan dihasilkan dalam respons.
presence_penalty
Tipe: number
min:
-2
maks:
2

Menghukum token baru berdasarkan apakah token tersebut muncul dalam teks sejauh ini. Nilai positif meningkatkan kemungkinan membahas topik baru.
return_citations
Tipe: boolean

Apakah akan mengembalikan kutipan dan hasil pencarian dalam respons.
search_context
Tipe: string enum

Mengontrol berapa banyak konteks pencarian yang digunakan. Memengaruhi biaya per permintaan.
nilai
- low
- medium
- high
search_domain_filter
Tipe: array string[]

Batasi pencarian ke domain tertentu.
search_recency_filter
Tipe: string enum

Filter hasil pencarian berdasarkan kebaruan.
nilai
- month
- week
- day
- hour
stream
Tipe: boolean

Apakah akan melakukan streaming respons menggunakan server-sent events.
temperature
Tipe: number
min:
0
maks:
2

Suhu sampling antara 0 dan 2. Nilai lebih rendah membuat output lebih terfokus dan deterministik.
top_k
Tipe: integer
min:
0
maks:
2048

Jumlah token yang disimpan untuk pemfilteran top-k.

top_p
Tipe: number
min:
0
maks:
1

Parameter sampling nukleus. Model mempertimbangkan token dengan massa probabilitas top_p.

Respons

200
Tipe: object · ResponseD5E2470Dd28B_ChatCompletionResponse

Respons berhasil dengan jawaban AI dan sitasi
choices
Tipe: array object[]
finish_reason
Tipe: string enum
nilai
stop
length
index
Tipe: integer

Integer numbers.

message
Tipe: object
content
Tipe: string

Jawaban yang dihasilkan AI, dengan referensi kutipan inline seperti [1][2].

role
Tipe: string
citations
Tipe: array string[]

Daftar URL sumber yang direferensikan dalam jawaban.

created
Tipe: integer

Stempel waktu Unix saat completion dibuat.

id
Tipe: string

Pengenal unik untuk completion.

model
Tipe: string

Model yang digunakan untuk completion.

object
Tipe: string
search_results
Tipe: array object[]

Hasil pencarian terperinci dengan judul, cuplikan, dan URL.

date
Tipe: string
snippet
Tipe: string
source
Tipe: string
title
Tipe: string
url
Tipe: string
usage
Tipe: object
completion_tokens
Tipe: integer

Integer numbers.

prompt_tokens
Tipe: integer

Integer numbers.

search_context_size
Tipe: string
total_tokens
Tipe: integer

Integer numbers.
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

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}'

Tampilkan Skema

{
  "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
  }
}

Respons berhasil dengan jawaban AI dan sitasi

Perplexity Sonar Deep Research

AutentikasiRequired

Perplexity API

Perplexity Sonar Deep Research

Referensi harga