Consulta el saldo de créditos contabilizado y el consumo bruto registrado en la cuenta.
Un desarrollador de aplicaciones comprueba el saldo de crédito de la cuenta comprometida antes de planificar más pagado API El resultado muestra el saldo de la cuenta y el consumo registrado para el período solicitado.
Un analista financiero recupera el consumo de crédito para una ventana de tiempo definida y lo compara con registros internos. El analista utiliza los campos de balance documentados para distinguir los saldos del consumo.
Un desarrollador llama al punto final de Créditos de Cuenta desde un panel interno usando un usuario API clave. El panel muestra la información de la cuenta devuelta sin necesidad de una exportación manual.
Devuelve el saldo de créditos de Nexscope y el consumo registrado en la cuenta. Los resultados corresponden al período solicitado. Consulta las tablas para conocer el significado de cada campo. Los cargos pendientes pueden aparecer más tarde y cada consulta usa su propia instantánea.
La consulta es gratuita y cuesta 0 créditos. Lee los datos contabilizados sin registrar una llamada de negocio. Puedes usar este GET gratuito con un saldo de cero o negativo. Los dos endpoints de cuenta comparten un límite de 60 solicitudes por cuenta cada 60 segundos.
Envía una solicitud GET a /api/skill-api/v1/account/credits con una clave API de usuario GENERAL en el encabezado Authorization: Bearer. Introduce las fechas opcionales como parámetros de consulta. La tabla describe el intervalo de tiempo en UTC. La consulta requiere una clave API de usuario. Los tokens de sesión y las claves de complementos carecen de autorización.
Consulta el saldo de créditos contabilizado y el consumo bruto registrado en la cuenta.
GET /api/skill-api/v1/account/creditsEnvía una clave de API de usuario GENERAL en la cabecera Authorization Bearer. Los JWT del sitio web, las claves de plugins y los tokens de instalación no pueden llamar a este endpoint. Un saldo cero o negativo no bloquea este GET gratuito.
Authorization: Bearer YOUR_API_KEYLee datos confirmados de la cuenta sin consumir créditos ni añadir una llamada de API de negocio. Ambas consultas comparten un límite de 60 solicitudes por cuenta cada 60 segundos.
/api/skill-api/v1/account/credits| Método | GET |
| Ruta | /api/skill-api/v1/account/credits |
| Autenticación | Bearer API key |
| Cuerpo de la solicitud | Ninguno. Los parámetros opcionales son campos de consulta. |
2026-04-28T20:26:40.000Z → 1777408000000; 2026-05-28T20:26:40.000Z → 1780000000000.
curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.nexscope.ai/api/skill-api/v1/account/credits?startTime=1777408000000&endTime=1780000000000"La API usa milisegundos desde la época UTC. En la prueba en línea, introduce la fecha y hora UTC; el área de pruebas convierte esos campos UTC a milisegundos sin usar la zona horaria del navegador. Sin fechas, se usan los 30 días anteriores. Si se proporciona un solo límite, el otro se completa con un intervalo de 30 días o la hora actual. La ventana es [startTime, endTime), no puede superar 180 días ni terminar en el futuro.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
endTime | string | opcional | Opcional UTC milisegundos, exclusiva. La ventana debe terminar a más tardar en el momento de la solicitud. |
startTime | string | opcional | Opcional UTC milisegundos época, inclusive. Introduzca fecha y hora UTC en el probador; el API recibe una cadena decimal de milisegundos. |
Sobre ResponseData completo. cost es el tiempo de procesamiento en milisegundos, no los créditos cobrados.
{
"code": 0,
"msg": null,
"data": {
"scope": "ACCOUNT",
"observedAt": "1780000000000",
"startTime": "1777408000000",
"endTime": "1780000000000",
"permanentCredit": "120",
"cycleCredit": "30",
"debt": "5",
"netCredit": "145",
"grossConsumedCredit": "40",
"quota": null
},
"ts": "1780000000000",
"time": "2026-05-28 20:26:40",
"cost": "13",
"traceId": null
}Los créditos Int64, los ID, los totales de páginas y las horas desde la época son cadenas decimales; los estados enteros y los campos de latencia siguen siendo números JSON. Los campos opcionales pueden ser null o estar ausentes si hay un error.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | opcional | Código de resultado de negocio. Sólo 0 significa éxito, incluso cuando HTTP es 200. |
cost | string | opcional | Solicitar duración del procesamiento en milisegundos, no créditos. -1 significa contexto no-Web. |
data | object | null | opcional | Cuenta de crédito comprometida instantánea sobre el éxito; null en un error. |
data.cycleCredit | string | opcional | Créditos de ciclo válidos en el saldo comprometido; cadena decimal. |
data.debt | string | opcional | Deuda de crédito pendiente, cadena decimal. |
data.endTime | string | opcional | Exclusivo UTC actual de época-millisegundo final de la ventana. |
data.grossConsumedCredit | string | opcional | Consumo de cuenta-ledger liquidado antes de reembolsos; excluye recargas, ajustes de administración, vencimiento y reembolso de deuda. |
data.netCredit | string | opcional | permanentCredit + cycleCredit - la deuda; puede ser negativa y no garantiza una llamada pagada. |
data.observedAt | string | opcional | UTC milisegundos época cuando se observó este dato-comprometido leído. |
data.permanentCredit | string | opcional | Créditos permanentes en el saldo de la cuenta comprometida; cadena decimal. |
data.quota | null | opcional | Siempre nula: no hay una cuota unificada de negocios-llamada. |
data.scope | string | opcional | Alcance del libro de cuentas. Permitidos: ACCOUNT |
data.startTime | string | opcional | Actual incluido UTC época-millisegundo inicio ventana. |
msg | string | null | opcional | Mensaje comercial opcional; puede ser nulo u omitido en el éxito. |
time | string | opcional | Tiempo de respuesta con formato de servidor (aaaa-mm-dd HH:mm:ss); su zona no está especificada por este campo. |
traceId | string | null | opcional | ID opcional de seguimiento de errores; puede ser nulo u omitido en caso de éxito. |
ts | string | opcional | Marca de tiempo de respuesta del servidor, milisegundos de época UTC como cadena decimal. |
| HTTP 200 | Comprueba ResponseData.code: solo 0 indica un resultado de negocio correcto. Un código distinto de cero puede llegar con HTTP 200. |
| HTTP 400 | Una ventana de tiempo o parámetros de paginación no válidos devuelven un error de parámetros. |
| HTTP 401 / 403 | La clave falta, no es válida o no tiene acceso. |
| HTTP 429 | Protección de frecuencia compartida para consultas de cuenta; Retry-After: 60 segundos. |
| HTTP 5xx | Error del servicio o de una dependencia; reintenta según el estado devuelto. |
netCredit = permanentCredit + cycleCredit − debt y puede ser negativo; no garantiza una llamada de pago. grossConsumedCredit es el consumo liquidado del libro de cuenta antes de reembolsos, excluyendo recargas, ajustes administrativos, caducidad y devolución de deuda. quota es null porque no existe una cuota unificada de llamadas de negocio.
observedAt indica la hora de lectura. Solo aparecen resultados confirmados; los cargos en curso pueden aparecer más tarde. Las consultas independientes no comparten una instantánea y las páginas de uso pueden cambiar al completarse las llamadas.
Envía una solicitud GET real y gratuita de tu cuenta con tu clave de API de usuario. No se envía ninguna solicitud hasta que selecciones Ejecutar API.