# Planos, cobrança e limites

Existem duas formas de pagar por APIs no Zyla API Hub. Use a que combina com o seu jeito de trabalhar; você pode usar as duas na mesma conta.

## Duas formas de pagar

| | Pague por chamada | Plano mensal |
|---|---|---|
| **Melhor para** | Agentes de IA e uso ocasional | Uso constante de uma API a partir do seu próprio software |
| **Como funciona** | Seu agente chama qualquer API através do [servidor Zyla MCP](https://zylalabs.com/pt/docs/mcp). Cada chamada bem-sucedida é cobrada pelo preço por chamada daquela API | Você assina um plano na página da API: um número de chamadas por mês por um preço fixo |
| **Assinatura** | Nenhuma. Você paga só pelas chamadas que têm sucesso | Uma por API. Renova automaticamente até você cancelar |
| **Você precisa de** | Um cartão de crédito cadastrado | Um plano para cada API que você usa |

**Pague por chamada.** Sem taxa mensal e sem mínimo. Se faltar o cartão, seu agente recebe um link de pagamento (`402`) para abrir e adicioná-lo. Peça ao seu agente o seu *status da conta* para ver o que você gastou neste ciclo.

**Planos mensais.** Cada API tem seus próprios planos, definidos pelo seu provedor: preço, chamadas por mês e um limite de requisições por minuto. Algumas APIs oferecem um teste gratuito com algumas chamadas. Você pode fazer upgrade, downgrade ou cancelar na página da API a qualquer momento; os planos renovam automaticamente no fim de cada período até você cancelar. Faturas e formas de pagamento estão em **Billing**, no menu da conta. Reembolsos seguem a [política de reembolso](https://zylalabs.com/pt/refund).

## Limites

- **Requisições por minuto.** Cada plano permite 60, 120 ou 240 requisições por minuto. Acima disso, as chamadas são rejeitadas até o início do próximo minuto.
- **Chamadas por mês.** Quando você usa todas as chamadas do seu plano, as chamadas são rejeitadas até você fazer upgrade ou até o início do próximo ciclo.
- **Faturas não pagas.** Se uma fatura ficar sem pagamento por 72 horas, a assinatura é pausada até que seja paga no Billing Portal.

Desenvolvedores podem acompanhar o uso pelos headers de resposta; veja [Chame uma API via HTTP](https://zylalabs.com/pt/docs/calling-apis).

## Quando algo dá errado

Erros do hub vêm com uma `message` que diz o que aconteceu:

| Status | O que significa | O que fazer |
|---|---|---|
| `401` | Chave ausente ou errada, sem assinatura para esta API, método HTTP errado, ou um teste gratuito complementar expirado | Verifique a chave e a assinatura; os agentes assinam automaticamente |
| `402` | Sem cartão de crédito cadastrado (agentes, pague por chamada) | Abra o link de pagamento e adicione um cartão |
| `403` | A conta está bloqueada, ou a chave está limitada a outras APIs | Use uma chave permitida para esta API |
| `404` | A API ou o endpoint não existe ou não é público | Verifique a API e o endpoint |
| `410` | O endpoint foi descontinuado | Use a alternativa listada na página da API |
| `422` | Um parâmetro tem o tipo ou formato errado | Corrija o parâmetro indicado na mensagem |
| `429` | Muitas requisições por minuto, chamadas do plano ou do teste esgotadas, ou uma assinatura pausada | Espere, faça upgrade do plano ou pague a fatura pendente |

Qualquer outro status (por exemplo, um `400` ou `500` com a mensagem própria do provedor) vem da própria API. Se persistir, escreva para nossa equipe com o nome da API e o horário da chamada.


---
Source: https://zylalabs.com/pt/docs/plans-and-limits