Limites e regras das chaves

Defina os limites de cada chave de API conforme sua finalidade: quanto pode gastar, em que ritmo, quais modelos pode usar, de onde e por quanto tempo. Configure esses limites ao criar uma chave ou a qualquer momento em Chaves de API → Editar.

As regras

Requisições recusadas nunca são cobradas. Os orçamentos consideram os valores reservados pelas requisições em andamento da chave (veja Faturamento), então uma requisição que possa ultrapassar um orçamento é recusada antes de começar, e uma resposta que atinja o limite durante a geração para ali com o erro desse orçamento. As alterações passam a valer em até 15 segundos, em todos os lugares. O saldo do seu workspace vale para todas as chaves: quando ele não cobre uma requisição, ela recebe 402 insufficient_quota.

Modelos permitidos

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

Endereços IP permitidos

Endereços individuais e intervalos CIDR, IPv4 e IPv6, até 100 por chave. O endereço verificado é aquele de onde sua requisição chega pela internet (se estiver atrás de um proxy ou NAT, será o endereço do proxy).

203.0.113.7          one address
198.51.100.0/24      a range of 256 addresses
2001:db8::/32        an IPv6 range

Orçamentos na prática

• Dê a cada app ou ambiente sua própria chave e seu próprio orçamento, para que um loop fora de controle não esgote o saldo.
• Um orçamento diário contém um bug no mesmo dia; um mensal limita a conta.
• A página Chaves de API mostra os gastos de cada chave hoje e neste mês ao lado dos respectivos orçamentos.