Saltar al contenido principal
querying.ai implementa el contrato estándar de tareas asíncronas de las API de motores de respuesta. En los endpoints siguientes, los esquemas de solicitud y respuesta coinciden, así que un cliente que funciona normalmente solo necesita una URL base y una clave nuevas.

La migración

Apunta tu constante de clave de API a una clave de querying.ai de Claves de API. Las URL de webhook, las claves de idempotencia, los tipos de tarea y el parseo de respuestas se quedan como está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

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_OVERLOADED con Retry-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_LIMIT hasta la próxima medianoche UTC.
Para grandes volúmenes, envía lotes en lugar de muchas solicitudes individuales. Consulta Créditos y límites y Lotes y cuadrículas.
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.
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.
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.
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.
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.
Un cliente que interprete un 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, normalmente response.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.