Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Pro
ウェブ検索と引用を使って複数パートの質問に回答を生成します。model と messages は必須で、このエンドポイントではモデル sonar-pro を使用します。この公開契約は stream が false の非ストリーミング JSON レスポンスを対象とします。回答とその出典は choices[].message.content、citations、search_results から読み取ります。usage はリソース消費量を報告するもので、Felo クレジットの請求ではありません。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：USD 0.11273。
- 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。
参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array object[]messages必須
これまでの会話を構成するメッセージのリスト。
- content型: string必須
メッセージの内容。
- role型: string 列挙値必須
メッセージ作成者のロール。
値- system
- user
- assistant
- 型: string 列挙値model必須
使用する Sonar モデル。
値- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- 型: numberfrequency
_penalty 最小値:0最大値:2これまでのテキストにおける出現頻度に基づいて新しいトークンにペナルティを課します。正の値は、同じ行をそのまま繰り返す可能性を下げます。
- 型: integermax
_tokens レスポンスで生成するトークンの最大数。
- 型: numberpresence
_penalty 最小値:-2最大値:2これまでのテキストに出現しているかどうかに基づいて新しいトークンにペナルティを課します。正の値は、新しい話題について話す可能性を高めます。
- 型: booleanreturn
_citations レスポンスに引用と検索結果を含めるかどうか。
- 型: string 列挙値search
_context 使用する検索コンテキストの量を制御します。リクエストあたりのコストに影響します。
値- low
- medium
- high
- 型: array string[]search
_domain _filter 検索を特定のドメインに限定します。
- 型: string 列挙値search
_recency _filter 鮮度で検索結果をフィルターします。
値- month
- week
- day
- hour
- 型: booleanstream
サーバー送信イベントを使ってレスポンスをストリーミングするかどうか。
- 型: numbertemperature最小値:0最大値:2
0 から 2 の間のサンプリング温度。値が低いほど、出力はより焦点が絞られ決定論的になります。
- 型: integertop
_k 最小値:0最大値:2048top-k フィルタリングで保持するトークン数。
- 型: numbertop
_p 最小値:0最大値:1核サンプリングのパラメータ。モデルは top_p の確率質量に達するトークンのみを考慮します。
- 型: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
AI 回答と引用を含む成功レスポンス
- 型: array object[]choices
- finish型: string 列挙値
_reason 値- stop
- length
- index型: integer
Integer numbers.
- message型: object
- content型: string
[1][2] のようなインライン引用参照を含む、AI が生成した回答。
- role型: string
- 型: array string[]citations
回答で参照されるソース URL のリスト。
- 型: integercreated
コンプリーションが作成されたときの Unix タイムスタンプ。
- 型: stringid
コンプリーションの一意の識別子。
- 型: stringmodel
コンプリーションに使用されたモデル。
- 型: stringobject
- 型: array object[]search
_results タイトル、スニペット、URL を含む詳細な検索結果。
- date型: string
- snippet型: string
- source型: string
- title型: string
- url型: string
- 型: objectusage
- completion型: integer
_tokens Integer numbers.
- prompt型: integer
_tokens Integer numbers.
- search型: string
_context _size - total型: integer
_tokens Integer numbers.
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
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
}
}