Consulta tu uso de créditos y tu cola desde la API

Tu clave de API lee lo que gastó cada motor y cada clave, y cuánto margen tiene tu plan para tareas nuevas.

Qué obtienes

• GET /v1/usage: los créditos y las tareas cobrados en un rango de fechas UTC, por día, motor y clave de API.
• GET /v1/async/status: tus tareas en cola y en ejecución, las tareas en cola por prioridad y tu límite de concurrencia.
• Ambas se leen con la misma clave vt_ con la que envías tareas.

Cómo funciona

El uso suma lo que se cobró por las tareas. Los créditos se cobran al completarse una tarea, y una tarea fallida cuesta 0. credits y tasks en el nivel superior suman todas las filas, y una combinación sin cobro no tiene fila.

Divide por key para ver quién gastó los créditos. Las tareas de tus subcuentas entran en tu uso, y apiKey.subAccountId indica la subcuenta dueña de una clave.

La cola cuenta juntas las tareas QUEUED y PROCESSING, igual que el límite de concurrencia de tu plan. Un envío que lo supera recibe 429 PLAN_CONCURRENCY_LIMIT, así que leer concurrency primero mantiene un lote dentro del límite.

Para qué sirve

• Cobra a tus propios clientes por uso: da a cada cliente una clave o una subcuenta y lee groupBy=key a fin de mes.
• Marca el ritmo de un lote grande: envía solo las tareas que permite max - used.
• Grafica el gasto diario por motor en tu propio panel o en tus alertas.

Cómo empezar

Lee el uso de este mes por motor:

curl "https://api.querying.ai/v1/usage?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, tostring

Fechas UTC en formato YYYY-MM-DD, ambas incluidas. Por defecto son el primer día del mes UTC en curso y hoy. Un rango abarca hasta 366 días.

groupBystring

Cualquiera de day, engine y key, separados por comas. El valor por defecto es day,engine. Cada fila lleva los campos de los cortes elegidos.

rows[].apiKeyobject

Con groupBy=key, la clave que gastó los créditos: id, keyPrefix, name y subAccountId. El gasto de monitores, el Playground y el panel tiene source igual a monitor, playground o dashboard.

Lee 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 }
}

queuedTasks, processingTasksnumber

Tus tareas en cola y en ejecución, incluidas las de tus subcuentas.

priorityBreakdownarray

Las tareas en cola por la priority con la que se enviaron, de mayor a menor.

concurrencyobject

used suma las tareas en cola y en ejecución, como las cuenta tu plan. max es tu límite de concurrencia, así que max - used es el margen para tareas nuevas.

Errores

VALIDATION_ERRORHTTP 400

Falta un campo o su valor está fuera de rango. details indica el campo.

MISSING_API_KEYHTTP 401

Falta la cabecera Authorization, o su clave es desconocida, caducó o fue revocada.

SUB_ACCOUNT_FORBIDDENHTTP 403

La clave es de una subcuenta. La clave de la cuenta principal lee el uso y la cola de ambas.

Precio

Consultar el uso y el estado de la cola cuesta 0 créditos.