Créditos da API
Entenda como chamadas da Rivya API usam créditos da conta, checagens de saldo, créditos reservados, reembolsos de tarefas com falha e solução de problemas de créditos.
Última revisão em 2026/05/10
A Rivya API usa a mesma carteira de créditos da conta que o Studio.
Use GET /api/v1/credits para ler o saldo atual da conta vinculada à chave de API.
Endpoint
GET https://rivya.ai/api/v1/creditsHeader obrigatório:
Authorization: Bearer rvya_sk_...Resposta
{
"current_credits": 123
}Cobrança de Geração
Quando você envia uma geração, a Rivya verifica se a conta tem créditos suficientes.
Para trabalhos de imagem, vídeo e áudio, os créditos normalmente são reservados ou consumidos no início da tarefa. A resposta de geração inclui:
reserved_creditsfinal_credits
final_credits pode permanecer 0 enquanto o trabalho ainda está na fila ou em processamento.
Trabalhos com Falha
Se uma tarefa falhar dentro das regras de falha existentes da Rivya, o tratamento de reembolso segue a mesma política de produto do Studio.
Use Status de Geração para confirmar o status final e Tarefas com Falha e Reembolsos de Créditos para o modelo de falhas em nível de produto.
Erros Comuns de Créditos
insufficient_credits: a conta não tem créditos suficientesapi_key_invalid: a chave de API não consegue identificar uma contapublic_api_disabled: a API pública está temporariamente desativada
Páginas Relacionadas
Chat API
Use a Rivya Chat API para turnos sem streaming ou com SSE, sessões criadas pela API, anexos de imagem por file_id e liquidação de créditos baseada em tokens.
Erros e Limites da API
Lide com códigos de erro públicos da Rivya API, status HTTP, limites de taxa, conflitos de idempotência e decisões de nova tentativa.