Zum Hauptinhalt springen
querying.ai setzt den üblichen asynchronen Task-Vertrag von Answer-Engine-APIs um. Für die unten aufgeführten Endpunkte stimmen Anfrage- und Antwortschemata überein, sodass ein funktionierender Client in der Regel nur eine neue Basis-URL und einen neuen Schlüssel braucht.

Die Änderung

Richten Sie Ihre API-Schlüssel-Konstante auf einen querying.ai-Schlüssel von der Seite API-Schlüssel. Webhook-URLs, Idempotenzschlüssel, Task-Typen und das Parsen der Antworten bleiben, wie sie sind.

Was umgesetzt ist

Jede Engine läuft asynchron; es gibt keinen Endpunkt, der blockiert, bis eine Antwort eintrifft.

Wo sich das Verhalten unterscheidet

API-Schlüssel teilen sich die Parallelität des Kontos. Für Task-Einreichungen und Polling mit API-Schlüssel gilt kein festes RPM-Limit. Folgende Grenzen gelten weiterhin:
  • Bei API-Überlastung erhalten Sie 503 SERVER_OVERLOADED mit Retry-After. Wiederholen Sie die Anfrage nach dieser Wartezeit.
  • Ihr Tarif begrenzt, wie viele Tasks Ihres Kontos gleichzeitig laufen können. Tasks über dieser Grenze warten in der Warteschlange und starten, sobald laufende Tasks enden. Ein Konto kann 1.000.000 wartende Tasks haben; darüber liefert die Einreichung 429 QUEUE_LIMIT_EXCEEDED.
  • Ein Schlüssel kann ein tägliches Credit-Limit haben. Darüber liefert die Einreichung bis zur nächsten UTC-Mitternacht 429 KEY_DAILY_CREDIT_LIMIT.
Für große Volumen senden Sie Batches statt vieler Einzelanfragen. Siehe Credits und Limits und Batches und Raster.
Jede Engine hat ihren eigenen Preis, zum Beispiel 1 Credit für ChatGPT und Perplexity, 1,25 für Gemini und Google AI Overviews. Der Engine-Katalog listet alle Preise.Antworten beim Einreichen melden { "creditsToCharge": 0, "creditsCharged": 0 }. Sobald ein Task COMPLETED ist, melden Polling und Webhook den abgebuchten Betrag. Fehlgeschlagene Tasks werden nicht berechnet.
Eine Kombination aus Engine und Land ohne Route liefert sofort 422 REGION_UNSUPPORTED, statt einen Task anzunehmen, der scheitern wird. Dasselbe Paar erneut zu senden hilft nicht.Ein Client, der davon ausgeht, dass jede wohlgeformte Einreichung angenommen wird, braucht eine Verzweigung für 422. Siehe Regionen und Standort.
Nicht jede Engine berücksichtigt die payload.include-Flags. Ein nicht unterstütztes markdown-, rawResponse- oder searchQueries-Flag wird ignoriert. Ein nicht unterstütztes html- oder analysis-Flag liefert 422, ein nicht unterstütztes citationAnalysis-Flag 400. Prüfen Sie die Unterstützungsmatrix, bevor Sie sie senden.
Jeder Webhook trägt die Header querying-webhook-id, querying-webhook-timestamp und querying-webhook-signature. Ihr bestehender Empfänger funktioniert weiter, wenn er sie ignoriert, Sie sollten sie aber prüfen. Siehe Webhooks.
GET /v1/async/task/{id} auf einen FAILED-Task liefert ein error-Feld auf oberster Ebene. Es ist ein einfacher String, nicht das Objekt { code, message, timestamp } der Anfragefehler.
Ein Client, der ein gesetztes body.error als fehlgeschlagene Anfrage deutet, missversteht einen fehlgeschlagenen Task. Verzweigen Sie nach task.status.

Engines den Task-Typen zuordnen

GOOGLE_AIO liefert einen Umschlag der Ergebnisseite mit der AI Overview im nullbaren Element aioverview. Siehe Google AI Overviews.

Die Umstellung prüfen

Lassen Sie Ihre bestehende Integration eine Zeit lang parallel zu querying.ai laufen und vergleichen Sie die Felder, die Sie nutzen, meist response.text, response.sources[] und response.markdown. Ein Schattenvergleich erkennt Abweichungen, die eine Schemaprüfung übersieht, etwa eine anders sortierte Quellenliste.