メインコンテンツへスキップ
querying.ai は、回答エンジンAPIで一般的な非同期タスク契約を実装しています。以下のエンドポイントではリクエストとレスポンスのスキーマが一致するため、動作しているクライアントは通常、ベースURLとキーを変えるだけで済みます。

変更点

APIキーの定数を、APIキー で発行した querying.ai のキーに変更します。Webhook URL、冪等キー、タスク種別、レスポンスの解析はそのままで構いません。

実装範囲

すべてのエンジンは非同期で実行されます。回答が届くまでブロックするエンドポイントはありません。

挙動が異なる箇所

APIキーはアカウントの同時実行枠を共有します。APIキーによるタスク送信とポーリングに固定の毎分上限はありません。次の制限は適用されます。
  • APIの処理容量が不足すると、Retry-After 付きの 503 SERVER_OVERLOADED を返します。指定された時間後に再試行してください。
  • プランによって、アカウントで同時に実行できるタスク数が決まります。上限を超えたタスクはキューで待機し、実行中のタスクが終わり次第開始します。1アカウントで待機できるタスクは1,000,000件までで、それを超えると送信は 429 QUEUE_LIMIT_EXCEEDED を返します。
  • キーには1日のクレジット上限を設定できます。超えると、次のUTC午前0時まで送信は 429 KEY_DAILY_CREDIT_LIMIT を返します。
大量に送る場合は、単発リクエストを多数送るのではなくバッチを使ってください。クレジットと上限とバッチとグリッドを参照してください。
エンジンごとに料金が異なります。たとえば ChatGPT と Perplexity は1クレジット、Gemini と Google AIによる概要は1.25クレジットです。すべての料金はエンジン一覧に記載しています。送信のレスポンスは { "creditsToCharge": 0, "creditsCharged": 0 } を報告します。タスクが COMPLETED になると、ポーリングとWebhookが請求額を報告します。失敗したタスクには課金しません。
経路のないエンジンと国の組み合わせは、失敗するタスクを受け付ける代わりに、すぐに 422 REGION_UNSUPPORTED を返します。同じ組み合わせで再試行しても解決しません。正しい形式の送信はすべて受け付けられると想定しているクライアントには、422 の分岐が必要です。地域と位置を参照してください。
payload.include フラグには、すべてのエンジンが対応しているわけではありません。未対応の markdown、rawResponse、searchQueries は無視されます。未対応の html と analysis は 422、未対応の citationAnalysis は 400 を返します。送信する前に対応表を確認してください。
すべてのWebhookに querying-webhook-id、querying-webhook-timestamp、querying-webhook-signature ヘッダーが付きます。既存の受信側はこれらを無視しても動作しますが、検証することを推奨します。Webhookを参照してください。
FAILED タスクに GET /v1/async/task/{id} を呼ぶと、トップレベルの error フィールドが返ります。これはリクエストエラーが使う { code, message, timestamp } オブジェクトではなく、プレーンな文字列です。
body.error が真ならリクエストが失敗したとみなすクライアントは、失敗したタスクを誤解します。task.status で分岐してください。

エンジンとタスク種別の対応

GOOGLE_AIO は、AIによる概要をnullableな aioverview メンバーに持つ検索結果ページのエンベロープを返します。Google AIによる概要を参照してください。

切り替えの検証

しばらく既存の連携と querying.ai を並行稼働させ、実際に使うフィールド(通常は response.text、response.sources[]、response.markdown)を比較してください。シャドー比較は、ソース一覧の順序の違いのように、スキーマチェックでは捉えられない差異を捉えます。