Perplexity Batch APIとは?Agent APIで最大5万件を非同期処理する方法・料金・注意点

AI脆弱性診断
そのAIシステム、従来の診断だけで十分ですか?
外部・内部の弱点に加え、プロンプトインジェクションや過剰な権限などAI固有の攻撃面も診断します。
Perplexity Batch APIは、すぐに回答が要らない大量のAgent APIリクエストを、JSONLファイルでまとめて投入し、処理完了後に結果ファイルを取得する機能です。企業リストの情報補完、オフライン評価、大量分類、Web検索を伴う調査の一括実行などに向きます。
2026年11月10日時点で、1ファイルあたり最大5万リクエスト、ファイルサイズは最大200MBです。通常の同期APIと違い、投入順に結果が返ることを前提にせず、custom_idで入力行と結果行を結合します。Perplexity公式 Batch APIガイド
なお、「Batch API」は一般的な名称であり、他社APIの一括処理機能を指す場合もあります。本記事では、PerplexityのAgent API向けBatch APIに限定して説明します。
結論:Perplexity Batch APIを選ぶ判断基準
状況 | 向き・不向き | 理由 |
|---|---|---|
数千〜5万件の分類・抽出・調査を夜間に実行したい | 向く | JSONLでまとめて投入し、非同期で完了を待てるため |
各行でWeb検索やURL取得も使いたい | 向く |
|
ユーザー操作中に数秒で結果を返す必要がある | 向かない | 完了目標は24時間であり、即時応答用の仕組みではないため |
外部ツールの承認付き実行が必要 | 向かない | function・connector・advisorツールはバッチで使えず、MCPも承認を求める設定にはできないため |
入力・出力を30日間保持できない | 向かない | Zero Data Retention(ZDR)組織では利用できず、バッチ関連ファイルは30日間保持されるため |
APIを使ったAI機能全体の選定軸は、生成AI APIとは?種類・選び方・料金・開発手順を整理も参照してください。Batch APIは「モデル」ではなく、非同期で大量実行するための実行方式です。
Perplexity Batch APIでできること
Batch APIでは、通常のAgent APIリクエストを1行ずつJSONLへ書き込みます。各行は同じモデルを使う必要がありますが、通常のAgent APIで使える入力、instructions、出力形式、推論設定などを指定できます。組み込みツールも利用できるため、単なるテキスト分類だけでなく、Webを根拠にした企業情報の補完やリリース情報の収集も対象にできます。Perplexity公式 Batch APIガイド
想定しやすい業務
- 企業データの補完:企業名・URLの一覧から、事業概要、所在地、直近ニュースなどを構造化して取得する
- 評価データの一括採点:質問集をモデルへ渡し、期待する形式・根拠・安全性を一括確認する
- 問い合わせの一次分類:過去チケットをカテゴリ、緊急度、担当部署候補へ振り分ける
- コンテンツ監査の下書き:URLや原稿の一覧に対して、指定した観点で確認結果をJSON形式にそろえる
ただし、検索・生成結果の正しさは、バッチ化したから保証されるわけではありません。大量処理ほど、結果を使う前の評価基準と例外処理が重要です。評価ケースの設計は、LLM評価の進め方|モデル選定を導入判断につなげる比較基準・手順・チェックリスト、RAGを含む回答評価ではAIの評価とは?評価指標や評価方法、その費用についてが参考になります。
利用条件と日本での提供状況
- 利用対象:Zero Data RetentionではないPerplexity API組織
- APIキーとクレジット:バッチ作成にはAPIクレジットが必要
- データ保持:入力、出力、エラーファイルは作成後30日で期限切れ
- 日本での提供:公式ドキュメントでは国・地域別の提供可否は明記されていません。日本からの契約・利用可否、所属組織のZDR設定、データ取り扱い条件は、実際の管理画面・契約条件で確認してください。
特に個人情報、顧客情報、営業秘密を含むCSVをそのまま投入する前に、30日間保持されることと、自社の契約・情報管理ルールが両立するかを確認してください。生成AIの未承認利用を防ぎながら利用範囲を設計する方法は、シャドーAIのリスクと対策|全面禁止に頼らない可視化・公式代替・監査の進め方で解説しています。
料金:バッチ専用の一律料金・一律割引はない
Perplexityは、Batch API自体に別料金はないと案内しています。請求は、選んだモデルのトークン料金と、利用したツール料金で決まります。OpenAIモデルのうちflex対応モデルは、バッチ内でflex tierが使われる場合、掲載トークン単価の0.5倍です。一方で、バッチ作成から20〜24時間後に開始・再開するリクエストは、期限までに完了させるため標準tierで実行されます。OpenAI以外のモデルは通常料金です。ツール呼び出しも通常料金で請求されます。Perplexity公式 Batch APIガイド Perplexity公式 Agent API Models
したがって、「バッチなら必ず半額」とは判断できません。モデル、実際に処理されたtier、入力・出力トークン数、検索・URL取得などのツール呼び出し回数で総額が変わります。
Mojiによる費用見積もりテンプレート
以下は一般的な設計上の目安です。実際の請求額は出力長、推論量、検索回数、失敗・再実行率で変わります。
想定総額(米ドル)
= 完了件数 × 1件あたりの入力トークン × 入力単価
+ 完了件数 × 1件あたりの出力トークン × 出力単価
+ web_search回数 × 0.0025ドル(標準検索)または0.001ドル(Fast Search)
+ fetch_url回数 × 0.0005ドル
+ 再実行対象の同様の費用
見積もりでは、最初から5万件を送らず、100〜300件程度の代表サンプルで、1件あたりのトークン数・ツール回数・エラー率を計測してから全量へ拡大することをMojiでは提案します。Agent APIのモデル料金とツール料金は、Perplexity公式 Pricingで確認できます。
始め方:JSONL作成から結果回収までの5ステップ
1. 1行1リクエストのJSONLを作る
JSONLは、JSON配列ではなく「1行に1つのJSONオブジェクト」を置く形式です。空行、行間のカンマ、重複したキーは使えません。custom_idはファイル内で一意にし、1〜64バイトに収めます。methodはPOST、urlは/v1/responsesに固定です。Perplexity公式 Batch APIガイド
架空の例:企業情報を補完する3件のJSONLです。実務では、出力を後段システムで扱いやすいよう、response_formatでJSON Schemaを指定する設計を検討します。
{"custom_id":"company-001","method":"POST","url":"/v1/responses","body":{"model":"openai/gpt-6-luna","instructions":"公開情報を根拠に、指定形式のJSONだけを返してください。","input":"会社名: 架空商事\n公式サイト: https://example.invalid\n本社所在地と事業概要を調べてください。","tools":[{"type":"web_search"}],"max_output_tokens":500}}
{"custom_id":"company-002","method":"POST","url":"/v1/responses","body":{"model":"openai/gpt-6-luna","instructions":"公開情報を根拠に、指定形式のJSONだけを返してください。","input":"会社名: 架空製作所\n公式サイト: https://example.invalid\n本社所在地と事業概要を調べてください。","tools":[{"type":"web_search"}],"max_output_tokens":500}}
ファイル内の全行で同じmodelを指定する必要があります。また、stream: trueは使えません。function、connector、advisorツールはアップロード時に拒否されます。MCPツールを使う場合も、人の承認を求める設定にはできません。AIエージェントが外部システムを操作する設計では、Batch APIの制約だけでなく、権限・承認・停止条件を別途設計してください。AIエージェントのガードレール設計|暴走を防ぎながら自動化を進める権限・承認・停止・監視の実務ガイド
2. POST /v1/filesへアップロードする
purpose=batchを指定してJSONLをアップロードし、返却されたfile_idを保存します。アップロード時にはJSONLの形式が検証され、不正な行があればHTTP 400と最初の不正行の情報が返ります。ただし、モデルIDの誤りなど、実行時に初めて分かる問題はこの時点では検出されず、後でエラーファイルに記録されます。Perplexity公式 Batch APIガイド
3. POST /v1/batchesでバッチを作る
input_file_idとendpoint: /v1/responsesを指定してバッチを作成します。completion_windowは現在24hのみで、完了保証ではなく目標時間です。重複作成を避けるため、作成リクエストにはIdempotency-Keyを付けることを推奨します。同じキーで24時間以内に同じ作成要求を再送すると、重複バッチではなく元のバッチが返ります。Perplexity公式 Batch APIガイド
4. 30〜60秒間隔で状態を確認する
GET /v1/batches/{batch_id}で状態を取得します。主な最終状態はcompleted、expired、cancelled、failedです。通常は30〜60秒間隔でのポーリングで足ります。Tier 0では組織のリクエスト上限が毎秒1件のため、短い間隔でのポーリングは避けます。Perplexity公式 Batch APIガイド
5. 出力・エラーファイルを両方取得し、custom_idで結合する
最終状態になっても、全リクエストの成功は意味しません。output_file_idとerror_file_idの両方を確認し、各行のcustom_idで元データと結合します。出力行の順番に依存せず、response.body.statusがcompletedか、incompleteまたはfailedかを判定してください。Perplexity公式 Batch APIガイド
失敗・期限切れを前提にした実装ポイント
Batch APIでは、バッチ全体が最終状態になっても、一部の行が失敗することがあります。たとえば、未開始または容量待ちの行は、バッチ作成から48時間の期限でbatch_expiredになります。実行が30分を超えた行はpoll_timeout、保存対象のレスポンスが20MBを超えた行はresponse_too_largeになる場合があります。期限切れで一度も開始されなかったリクエストは課金されませんが、実行中に停止したリクエストは処理済みステップ分が課金される可能性があります。Perplexity公式 Batch APIガイド
Mojiによる再実行設計の最小ルール
- 入力CSVの各行へ永続IDを付ける:行番号だけでなく、元レコードを追跡できるIDを持たせる。
- custom_idは永続IDと対応させる:結果を入力順ではなくIDで結合する。
- 成功・不成功・解析失敗を分ける:API成功でも期待したJSON形式でなければ、業務上は失敗として扱う。
- 再実行ファイルは未完了行だけで作る:全件を再送して二重課金・二重登録を起こさない。
- 出力を30日以内に保管・削除する:必要な結果だけを自社の保存先へ移し、不要な入力・出力ファイルはAPIから削除する。
Perplexity公式の企業情報補完cookbookも、入力行と出力・エラー行をcustom_idで結び、未完了行だけから再試行用JSONLを作る実装例を公開しています。Perplexity公式 Company-enrichment cookbook
導入前チェックリスト
- □ 即時応答ではなく、最大24時間程度の非同期処理として業務要件を満たすか
- □ 入力・出力を30日間保持できるか。ZDR組織ではないか
- □ 1ファイル5万件、200MB、1行4MBの上限に収まるか
- □ 全行が同一モデルであり、JSONLに空行・重複キーがないか
- □
custom_idで入力と出力を確実に結合できるか - □ モデル料金、検索・URL取得などのツール料金、再実行費を含めて予算を試算したか
- □ エラーファイル、
incomplete、解析失敗を再実行または人手確認へ渡す仕組みがあるか - □ APIキーをクライアント側へ埋め込まず、サーバー側の秘密情報管理に置いているか
- □ 人事評価、与信、採否、価格決定など影響の大きい判断で使う場合、人による確認と根拠確認を設けたか
まとめ
Perplexity Batch APIは、Agent APIの大量処理を非同期化するための機能です。最大5万件のJSONLを投入でき、Web検索やURL取得も各リクエストで使えます。一方で、即時応答用ではなく、入力・出力は30日保持され、実行結果には失敗・期限切れもあり得ます。
導入時は、まず少数サンプルで品質、1件あたりのコスト、ツール呼び出し回数、エラー率、再実行率を測り、custom_idを軸に入力・出力・エラーを結合できる運用を作ってから、対象件数を拡大してください。