Plataforma

Limites e regras das chaves

Limite cada chave de API à sua finalidade: quanto gasta, a que ritmo, que modelos usa, a partir de onde e durante quanto tempo. Defina estas regras ao criar uma chave ou, a qualquer momento, em Chaves de API → Editar.

As regras

RegraO que acontece ao excedê-laErro
Orçamento mensal (USD)Os pedidos são recusados até ao mês seguinte (UTC)402 key_budget_exceeded
Orçamento diário (USD)Pedidos recusados até à meia-noite UTC402 key_daily_budget_exceeded
Limite de pedidos (pedidos por minuto)Pedidos recusados temporariamente, com retry-after429 rate_limit_exceeded
ValidadeA chave deixa de funcionar401 expired_api_key
Modelos permitidosOs outros modelos são recusados403 model_not_allowed
Endereços IP permitidosOs pedidos de outras origens são recusados403 ip_not_allowed

Os pedidos recusados nunca são cobrados. Os orçamentos têm em conta o montante reservado pelos pedidos em curso da chave (consulte Faturação), pelo que um pedido que possa exceder um orçamento é recusado antes de começar, e uma resposta que atinja esse limite a meio é interrompida com o erro desse orçamento. As alterações são aplicadas em todo o lado no prazo de 15 segundos. O saldo do seu espaço de trabalho aplica-se a todas as chaves: quando não chega para cobrir um pedido, este recebe 402 insufficient_quota.

Modelos permitidos

Escolha quaisquer modelos, de texto, imagem ou vídeo. Uma chave limitada, por exemplo, a gpt-6-sol e gemini-3.7-flash não pode chamar nenhum outro modelo, e o encaminhamento inteligente só usa alternativas dessa lista. Permitir Zurelay Auto permite que a chave use qualquer modelo que o Auto escolha.

Endereços IP permitidos

Endereços individuais e intervalos CIDR, IPv4 e IPv6, até 100 por chave. O endereço verificado é aquele de onde o pedido chega pela Internet (por trás de um proxy ou NAT, é o endereço do proxy).

Exemplos
203.0.113.7 one address
198.51.100.0/24 a range of 256 addresses
2001:db8::/32 an IPv6 range
Como plataformas serverless e alguns serviços de cloud enviam pedidos a partir de endereços variáveis. Use um intervalo que o seu fornecedor publique para tráfego de saída ou deixe os IPs sem restrições nessas chaves e recorra às outras regras.

Orçamentos na prática

  • Atribua a cada aplicação ou ambiente a sua própria chave e orçamento, para que um ciclo descontrolado não esgote o saldo.
  • Um orçamento diário deteta um erro no próprio dia; um mensal limita a fatura.
  • A página Chaves de API mostra os gastos de cada chave hoje e neste mês, junto dos respetivos orçamentos.

Tem dúvidas ou falta alguma coisa? Contacte a nossa equipa de apoio e responderemos por email, normalmente num minuto.