Search docs

Search the TryOnCloud API docs

Referência da API

Verificar créditos

GET /api/v1/credits: número de experimentações restantes na sua conta.

Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.

GET https://www.tryoncloud.com/api/v1/credits

Devolve o número de «experiências» que a sua conta ainda pode realizar, a partir do mesmo conjunto de recursos que a chamada POST /generate utiliza.

Pedido

bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Resposta

json
{
  "credits_remaining": 4870,
  "purchased_remaining": 4870,
  "purchased_total": 5000,
  "free_remaining": 0,
  "spends_from": "purchased"
}
CampoSignificado
credits_remainingExperimentações que podes fazer agora mesmo. Usa esta aqui
purchased_remainingCréditos adquiridos restantes (não têm prazo de validade)
purchased_totalTodos os créditos adquiridos até à data
free_remainingCrédito gratuito restante (utilizável apenas antes da sua primeira compra)
spends_frompurchased, assim que tiver comprado créditos; caso contrário, free_allowance

Dicas

  • Verifique antes de processar um lote grande e esteja atento caso o credits_remaining desça para um nível inferior a alguns dias de utilização.
  • Limite de requisições: 60 por minuto por chave. Não o chame antes de cada tentativa; um código de erro 402 da API /generate já indica quando atingiu o limite.
  • Compre créditos na página «Faturação» do painel de controlo.

Erros

HTTPcódigoSignificado
401NO_KEY, INVALID_KEYChave em falta ou errada
429RATE_LIMITEDMais de 60 pedidos por minuto
500CREDITS_UNAVAILABLEProblema temporário, tente novamente