Créditos y límites: precios, retenciones, concurrencia y límites de tasa

curl https://api.querying.ai/v1/capabilities

​

Créditos por tarea

​

Medición de Citation Analysis

​

Retención, cobro y liberación

​

Consulta tu saldo

curl https://api.querying.ai/v1/credits \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "remaining": 1879939,
  "perCycle": 1000000,
  "cycleResetsAt": "2026-11-14T07:37:57.000Z",
  "reserved": 61,
  "plan": "max",
  "topUpBalance": { "credits": 1000000, "nextExpiresAt": "2027-01-19T10:01:57.000Z", "nextCredits": 1000000 }
}

• remaining es lo que puedes gastar ahora. Las tareas que ya enviaste retienen su precio en reserved, así que no lo restes otra vez.
• perCycle es lo que tu plan otorga en cada ciclo y cycleResetsAt es cuándo termina el ciclo actual. Ambos son null sin un plan activo.
• topUpBalance indica los créditos de recarga incluidos en remaining, con la fecha en que caducan los siguientes y cuántos son. Es null si no tienes ninguno. Los créditos de recarga duran tres meses desde la compra, se conservan al renovar y se gastan después de los créditos del plan.

​

Consulta tu uso

curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&groupBy=engine" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "from": "2026-10-01",
    "to": "2026-10-20",
    "groupBy": ["engine"],
    "credits": 66.25,
    "tasks": 65,
    "rows": [
      { "taskType": "CHATGPT", "credits": 49, "tasks": 49 },
      { "taskType": "GEMINI", "credits": 6.25, "tasks": 5 },
      { "taskType": "PERPLEXITY", "credits": 11, "tasks": 11 }
    ]
  }
}

• from y to son fechas UTC y se incluyen los dos días. Por defecto son el primer día del mes UTC actual y hoy. Un rango abarca como máximo 366 días.
• groupBy acepta day, engine y key, separados por comas, y por defecto es day,engine. Cada fila tiene los campos de los desgloses que elegiste, y una combinación sin cobros no tiene fila. credits y tasks en la parte superior suman todas las filas.
• groupBy=key muestra quién gastó los créditos. Una tarea enviada con una clave de API tiene "source": "api" y un apiKey con su id, keyPrefix, name y subAccountId. El gasto sin clave de API tiene source con el valor monitor (las ejecuciones de un monitor), playground o dashboard, y apiKey es null.
• El uso suma lo que se cobró a las tareas, y una tarea fallida cuesta 0. La lectura de competidores de un monitor se cobra sin una tarea, así que baja tu saldo pero no aparece en el uso.
• Las tareas de tus subcuentas están en tu uso, y apiKey.subAccountId indica la subcuenta propietaria de una clave. GET /v1/sub-accounts/{id}/usage lee una sola subcuenta. La clave de una subcuenta recibe 403 SUB_ACCOUNT_FORBIDDEN.

​

Consulta tu cola

curl https://api.querying.ai/v1/async/status \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "queuedTasks": 19,
  "processingTasks": 6,
  "priorityBreakdown": [{ "priority": 8, "count": 3 }, { "priority": 1, "count": 16 }],
  "concurrency": { "used": 25, "max": 200 }
}

• concurrency.used es queuedTasks más processingTasks, los dos recuentos que suma el límite de concurrencia de tu plan. max es ese límite, así que max - used es el margen que queda para tareas nuevas.
• priorityBreakdown enumera las tareas en cola según la priority con la que se enviaron, de mayor a menor.
• Los recuentos incluyen las tareas de tus subcuentas, que comparten tu límite. La clave de una subcuenta recibe 403 SUB_ACCOUNT_FORBIDDEN y lee sus propios recuentos en GET /stats.

​

Planes

​

Concurrencia del plan

​

Límites por clave y por subcuenta

​

Tasa de solicitudes y contrapresión

​

Dosifica los envíos grandes