Die Änderung
Was umgesetzt ist
Jede Engine läuft asynchron; es gibt keinen Endpunkt, der blockiert, bis eine Antwort eintrifft.
Wo sich das Verhalten unterscheidet
1. Limits gelten pro Zugangsdaten, pro Konto und pro Schlüssel
1. Limits gelten pro Zugangsdaten, pro Konto und pro Schlüssel
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_OVERLOADEDmitRetry-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.
2. Credits gelten pro Engine, und Polling meldet sie
2. Credits gelten pro Engine, und Polling meldet sie
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.3. Manche Paare aus Engine und Region werden beim Einreichen abgelehnt
3. Manche Paare aus Engine und Region werden beim Einreichen abgelehnt
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.4. Nicht unterstützte include-Flags werden ignoriert oder abgelehnt
4. Nicht unterstützte include-Flags werden ignoriert oder abgelehnt
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.5. Webhooks sind signiert
5. Webhooks sind signiert
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.6. Ein fehlgeschlagener Task erhält einen error-String auf oberster Ebene
6. Ein fehlgeschlagener Task erhält einen error-String auf oberster Ebene
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.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, meistresponse.text, response.sources[] und response.markdown. Ein Schattenvergleich erkennt Abweichungen, die eine Schemaprüfung übersieht, etwa eine anders sortierte Quellenliste.