API de saldo

Comprueba cuántos créditos puedes gastar y cuántos de ellos caducan en la próxima renovación mensual.

GET/openapi/v1/balance

Obtener el saldo

Devuelve el saldo de créditos de la cuenta propietaria de la clave de API. En un equipo con un fondo de créditos compartido, los valores son los de ese fondo. Llamar a este endpoint es gratuito.

Request

GET

/openapi/v1/balance

curl https://api.meshy.ai/openapi/v1/balance \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "balance": 1000,
  "monthly_credits": 600,
  "permanent_credits": 400,
  "monthly_resets_at": 1793491200000
}

Devuelve

Name
balance
Type
integer
Description
Cantidad de créditos que puedes gastar. Normalmente es monthly_credits más permanent_credits.
Puede ser menor cuando se te aplica un límite de crédito de miembro o un límite de crédito de espacio de trabajo Enterprise. Los propietarios y administradores de equipos no tienen ese límite.
Name
monthly_credits
Type
integer
Description
Cantidad de créditos restantes que caducan en la próxima renovación mensual, en monthly_resets_at.
Name
permanent_credits
Type
integer
Description
Cantidad de créditos que no caducan, por ejemplo los de paquetes de créditos que compraste y los de recompensas.
Name
monthly_resets_at
Type
timestamp
Description
Momento de la próxima renovación mensual de créditos, en milisegundos Unix. En ese momento, los créditos mensuales restantes caducan, y una suscripción activa los recarga. null cuando no hay ninguna renovación programada.

Modos de error

Name
401 - Unauthorized
Description
Falta la clave de API o no es válida. Revisa el encabezado Authorization.
Name
429 - Too Many Requests
Description
Enviaste demasiadas solicitudes. Espera la cantidad de segundos indicada en Retry-After y vuelve a intentarlo.