API de Saldo

A API de Saldo permite-lhe obter o saldo de créditos atual da sua conta. Este endpoint fornece uma forma simples de verificar os seus créditos disponíveis, que são utilizados para vários serviços da Meshy.

GET/openapi/v1/balance

Obter Saldo

Este endpoint obtém o saldo de créditos atual do utilizador autenticado.

Retornos

Retorna um objeto que contém o saldo de créditos atual. Para membros de equipa, estes valores refletem o conjunto de créditos partilhado da equipa.

Name
balance
Type
integer
Description
O número de créditos atualmente disponíveis na sua conta.
Name
monthly_credits
Type
integer
Description
O número de créditos restantes que expiram na próxima renovação mensal, conforme especificado por monthly_resets_at.
Name
permanent_credits
Type
integer
Description
O número de créditos que não expiram, tais como créditos de pacotes de créditos adquiridos ou recompensas obtidas.
Name
monthly_resets_at
Type
timestamp
Description
A hora da próxima renovação mensal de créditos, expressa como um carimbo de data/hora Unix em milissegundos. Nesse momento, os créditos mensais atuais expiram e são repostos, desde que a subscrição esteja ativa. Retorna null se não houver nenhuma renovação agendada.

Normalmente, balance é igual a monthly_credits + permanent_credits. Se se aplicar um limite de créditos de membro ou de espaço de trabalho ao autor do pedido, balance pode ser inferior.

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
}