aisplice

Referencia de la API

Saldo

GET/v1/balance

Devuelve el saldo de la cuenta y lo que la clave de API que hace la llamada aún puede gastar, en USD. Gratis y de solo lectura: sin llamada a modelos y sin cargos. Las claves agotadas o caducadas pueden seguir llamándolo; solo se rechazan las claves desactivadas.

#Parámetros de la solicitud

  • Authorizationheaderobligatorio

    Bearer sk-YOUR_KEY. No hay cuerpo ni parámetros de query.

balance es toda la billetera de la cuenta y puede quedar por debajo de cero cuando se liquida un trabajo grande. available es lo que esta clave puede gastar ahora mismo: el menor entre balance y el límite restante propio de la clave, nunca por debajo de cero. key.remaining es null cuando la clave no tiene límite propio; expires_at 0 significa que nunca caduca.

Los clientes B2B pueden consultarlo antes de enviar trabajo y avisar a su equipo cuando available esté bajo. Con la firma de solicitudes activada, fírmalo como cualquier otra llamada con esa clave, usando la ruta /v1/balance.

#Errores relacionados

  • 401Clave ausente, no válida o desactivada — o, con la firma de solicitudes activada, una firma ausente o incorrecta.
  • 403La cuenta está desactivada.
  • 500No se pudo leer el saldo. Reintenta en unos segundos.

Tabla completa de códigos de error →

#Ejemplo de solicitud

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#Respuesta

response.json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.

AnteriorPolítica de subida de archivosSiguienteLista de modelos