La migración
Qué está implementado
Todos los motores funcionan de forma asíncrona; no hay ningún endpoint que se bloquee hasta que llegue una respuesta.
Dónde difiere el comportamiento
1. Los límites son por credencial, por cuenta y por clave
1. Los límites son por credencial, por cuenta y por clave
Las claves API comparten la concurrencia de la cuenta. Los envíos de tareas y el polling con clave API no tienen un límite fijo de RPM. Estos límites siguen vigentes:
- La sobrecarga de la API devuelve
503 SERVER_OVERLOADEDconRetry-After. Reintenta después de ese plazo. - Tu plan limita cuántas tareas de tu cuenta pueden ejecutarse a la vez. Las tareas por encima del límite esperan en la cola y empiezan cuando terminan las que están en curso. Una cuenta puede tener 1.000.000 tareas en espera; por encima, el envío devuelve
429 QUEUE_LIMIT_EXCEEDED. - Una clave puede tener un límite diario de créditos. Por encima de él, el envío devuelve
429 KEY_DAILY_CREDIT_LIMIThasta la próxima medianoche UTC.
2. Los créditos son por motor y el sondeo los informa
2. Los créditos son por motor y el sondeo los informa
Cada motor tiene su propio precio: por ejemplo, 1 crédito para ChatGPT y Perplexity, 1,25 para Gemini y Google AI Overviews. El catálogo de motores recoge todos los precios.Las respuestas de envío informan
{ "creditsToCharge": 0, "creditsCharged": 0 }. Cuando una tarea está COMPLETED, el sondeo y el webhook informan el cargo cobrado. Las tareas fallidas no se cobran.3. Algunas combinaciones de motor y región se rechazan al enviar
3. Algunas combinaciones de motor y región se rechazan al enviar
Un motor y un país sin ruta devuelven
422 REGION_UNSUPPORTED de inmediato, en lugar de aceptar una tarea que va a fallar. Reintentar la misma combinación no sirve.Un cliente que asume que todo envío bien formado se acepta necesita una rama para 422. Consulta Regiones y ubicación.4. Los flags include no admitidos se ignoran o se rechazan
4. Los flags include no admitidos se ignoran o se rechazan
No todos los motores respetan los flags de
payload.include. Un flag markdown, rawResponse o searchQueries no admitido se ignora. Un flag html o analysis no admitido devuelve 422, y un flag citationAnalysis no admitido devuelve 400. Revisa la matriz de compatibilidad antes de enviarlos.5. Los webhooks van firmados
5. Los webhooks van firmados
Cada webhook lleva los encabezados
querying-webhook-id, querying-webhook-timestamp y querying-webhook-signature. Tu receptor actual sigue funcionando si los ignora, pero deberías verificarlos. Consulta Webhooks.6. Una tarea fallida añade una cadena error de nivel superior
6. Una tarea fallida añade una cadena error de nivel superior
GET /v1/async/task/{id} sobre una tarea FAILED devuelve un campo error de nivel superior. Es una cadena simple, no el objeto { code, message, timestamp } de los errores de solicitud.body.error verdadero como una solicitud fallida malinterpretará una tarea fallida. Ramifica por task.status.Relaciona motores con tipos de tarea
GOOGLE_AIO devuelve un sobre de página de resultados con el AI Overview en un miembro anulable aioverview. Consulta Google AI Overviews.
Verifica el cambio
Ejecuta en paralelo tu integración actual y querying.ai durante un tiempo y compara los campos que consumes, normalmenteresponse.text, response.sources[] y response.markdown. Una comparación en sombra detecta diferencias que un chequeo de esquema no ve, como una lista de fuentes en otro orden.