Chaves e permissões

Use a chave do Infinity Flow no header:

Authorization: Bearer SUA_CHAVE_PRIVADA

Crie chaves em Integrações, com um nome que identifique o serviço. O segredo completo aparece uma única vez; as consultas posteriores mostram apenas metadados e prefixo. A validade padrão é 90 dias, configurável entre 1 e 365 dias. A conta admite até 10 chaves válidas e não revogadas.

Cada requisição verifica conta, permissões, assinatura base e automação atuais. Uma chave existente não mantém acesso depois de suspensão, expiração do plano ou perda do adicional.

Escopos

Permissão	Operações
account:read	Conta, capacidades e modelos
usage:read	Saldo e reset de uso
generations:read	Histórico, geração e lote
generations:write	Criar geração/lote e cancelar antes da submissão
projects:read	Listar e ler projetos
projects:write	Criar, renomear e excluir projetos
references:read	Listar e consultar referências privadas
references:write	Enviar/remover referências não utilizadas
media:read	Autorizar playback, thumbnail e download

Conceda somente os escopos necessários. Uma integração que consulta resultados não precisa de permissão para criar ou excluir.

Rotação

Crie uma chave nova, atualize o segredo no seu serviço, valide uma consulta e revogue a chave anterior em Integrações. Revogar uma chave não apaga os pedidos aceitos nem permite reenviá-los como novos. Consulte os IDs salvos com uma credencial válida.

Limites de requests

A camada de automação limita atualmente 180 requisições por minuto por credencial e 360 por minuto por conta. O servidor pode rejeitar antes por cota diária, fila, pacing ou manutenção. Respeite o Retry-After e o código do erro; aumentar o número de chaves não amplia a capacidade da conta.

Não envie cookie de sessão como chave de API. Cookies e CSRF continuam sendo mecanismos das páginas do produto. Nunca encaminhe seu Bearer a um host de armazenamento ao seguir um download privado.