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. 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.
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.
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.
