v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Pro

Felo API Support

MIT

Pelayan

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-pro

Perplexity Sonar Pro

Jana jawapan bagi soalan berbilang bahagian menggunakan carian web dan petikan. model dan messages diperlukan; gunakan model sonar-pro untuk endpoint ini. Kontrak awam ini merangkumi respons JSON tanpa penstriman dengan stream false. Baca choices[].message.content, citations dan search_results untuk jawapan dan sumbernya. usage melaporkan penggunaan sumber, bukan caj kredit Felo.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.11273.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

wajib

application/json

messages
Jenis: array object[]
wajib

Senarai message yang membentuk perbualan setakat ini.
- content
  Jenis: string
  wajib
  
  Kandungan message.
- role
  Jenis: string enum
  wajib
  
  Peranan pengarang message.
  
  nilai
  system
  user
  assistant
model
Jenis: string enum
wajib

Model Sonar untuk digunakan.
nilai
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Jenis: number
min:
0
maks:
2

Menghukum token baharu berdasarkan kekerapan sedia adanya dalam teks setakat ini. Nilai positif mengurangkan kemungkinan mengulang baris yang sama secara verbatim.
max_tokens
Jenis: integer

Bilangan maksimum token untuk dijana dalam respons.
presence_penalty
Jenis: number
min:
-2
maks:
2

Menghukum token baharu berdasarkan sama ada ia muncul dalam teks setakat ini. Nilai positif meningkatkan kemungkinan membincangkan topik baharu.
return_citations
Jenis: boolean

Sama ada untuk memulangkan petikan dan hasil carian dalam respons.
search_context
Jenis: string enum

Mengawal berapa banyak konteks carian untuk digunakan. Mempengaruhi kos setiap permintaan.
nilai
- low
- medium
- high
search_domain_filter
Jenis: array string[]

Hadkan carian kepada domain tertentu.
search_recency_filter
Jenis: string enum

Tapis hasil carian mengikut kebaharuan.
nilai
- month
- week
- day
- hour
stream
Jenis: boolean

Sama ada untuk menstrim respons menggunakan server-sent events.
temperature
Jenis: number
min:
0
maks:
2

Suhu pensampelan antara 0 dan 2. Nilai lebih rendah menjadikan output lebih fokus dan deterministik.
top_k
Jenis: integer
min:
0
maks:
2048

Bilangan token untuk disimpan bagi penapisan top-k.

top_p
Jenis: number
min:
0
maks:
1

Parameter pensampelan nukleus. Model mempertimbangkan token dengan jisim kebarangkalian top_p.

Respons

200
Jenis: object · ResponseD5E2470Dd28B_ChatCompletionResponse

Respons berjaya dengan jawapan AI dan petikan
choices
Jenis: array object[]
finish_reason
Jenis: string enum
nilai
stop
length
index
Jenis: integer

Integer numbers.

message
Jenis: object
content
Jenis: string

Jawapan yang dijana AI, dengan rujukan petikan sebaris seperti [1][2].

role
Jenis: string
citations
Jenis: array string[]

Senarai URL sumber yang dirujuk dalam jawapan.

created
Jenis: integer

Cap masa Unix apabila completion dicipta.

id
Jenis: string

Pengecam unik untuk completion.

model
Jenis: string

Model yang digunakan untuk completion.

object
Jenis: string
search_results
Jenis: array object[]

Hasil carian terperinci dengan tajuk, petikan dan URL.

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

Integer numbers.

prompt_tokens
Jenis: integer

Integer numbers.

search_context_size
Jenis: string
total_tokens
Jenis: integer

Integer numbers.
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

application/json

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

Tunjukkan Skema

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

Respons berjaya dengan jawapan AI dan petikan

Perplexity Sonar Pro

PengesahanRequired

Perplexity API

Perplexity Sonar Pro

Rujukan harga