1. Separe as contas e os custos
A assinatura da plataforma e a carteira da API são separadas. Entre no console da API para consultar saldo, chaves e preços. Não estime o custo por geração a partir da mensalidade da plataforma.
2. Configure a chave no servidor
Guarde BIZIVA_API_KEY em um gerenciador de segredos ou configuração privada do backend. Não cole a chave no ChatGPT, no navegador, em URLs ou em código público. O cliente web chama seu servidor; seu servidor chama a Biziva.
3. Consulte antes de executar
Use a base https://api.biziva.com.br/v1. Com sua credencial, consulte GET /models e GET /pricing. Confira modelo, parâmetros, limites e unidade de cobrança disponíveis para sua conta.
4. Prepare e teste
O MCP da Biziva prepara exemplos de requisição de texto, imagem e vídeo sem executá-los. Revise o corpo e faça primeiro testes simulados no projeto. Ao executar uma chamada real de geração, confirme operação e orçamento.
5. Preserve o identificador da operação
Use uma Idempotency-Key estável para a mesma operação conforme o contrato da rota. Guarde request_id ou task_id e consulte o estado de tarefas. Uma criação com envio ou resultado incerto não deve ser repetida como uma geração nova.
6. Leia os erros
400 indica parâmetros inválidos; 401/403 exigem rever credenciais e permissões; 402 exige conferir saldo/plano; 409 pode indicar conflito; 429 exige respeitar o limite. Não repita indiscriminadamente chamadas pagas após timeout ou 5xx.