4oImageApi.io guarda imagens por apenas 14 dias: a geração assíncrona deve terminar com o arquivamento
As equipes que integram 4oImageApi.io a um backend de design devem separar o sucesso da tarefa da entrega do recurso: acompanhar o estado por taskId e salvar os resultados em armazenamento sob sua gestão dentro do prazo de retenção de 14 dias. Um callback pode avisar sobre a conclusão, mas não substitui o arquivamento do arquivo.
Depois de conectar o backend de design ao 4oImageApi.io, é possível encerrar a tarefa assim que chega a notificação de geração concluída? Não, se a imagem for necessária para uma campanha no mês seguinte. A documentação oficial informa que as imagens geradas são mantidas por apenas 14 dias. A geração assíncrona permite que o backend trate separadamente “enviar a solicitação” e “obter o resultado”, mas a equipe ainda precisa acrescentar uma etapa de arquivamento sob sua responsabilidade.
Esta é uma análise, baseada na documentação, de uma tarefa interna de criação de recursos, não um teste real da API. Suponha que um designer peça uma imagem para uma campanha. O que o desenvolvedor deve entregar é uma imagem que possa ser reaberta na biblioteca de recursos da própria equipe, e não apenas uma tarefa exibida como bem-sucedida no servidor.
O callback avisa sobre a conclusão; a consulta de estado ajuda a confirmar o resultado
A documentação explica que, quando uma tarefa é concluída, uma notificação POST é enviada à URL de callback indicada. O endpoint de detalhes permite consultar o estado da geração, os parâmetros e os resultados usando taskId. Durante a integração, a solicitação de imagem deve ser associada ao seu taskId no registro de tarefas da equipe, para que consultas posteriores permitam localizar a solicitação original.
A interface também deve distinguir “em geração” de “pronto para o designer verificar”. Os estados documentados incluem GENERATING, SUCCESS, CREATE_TASK_FAILED e GENERATE_FAILED. Após receber uma notificação, é preciso conferir o estado e o resultado antes de decidir se é melhor continuar esperando, tratar uma falha ou passar à inspeção da imagem. Nem toda notificação deve ser interpretada como a chegada de um recurso utilizável.
Se forem usadas consultas periódicas, a documentação estabelece um máximo de 3 consultas por segundo por tarefa. Trata-se de um limite de consulta, não de uma frequência recomendada nem de uma promessa de gerar 3 imagens por segundo. A equipe deve definir o intervalo conforme a experiência de espera pretendida e interromper as consultas repetidas quando a tarefa atingir um estado final. Monitorar o estado não deve ser confundido com a capacidade de geração de imagens.
A retenção de 14 dias torna o arquivamento parte da integração
Para uma imagem que será usada apenas no mês seguinte, anotar somente a URL do resultado do fornecedor em uma planilha não é uma medida suficientemente segura. Como as imagens expiram após 14 dias, o resultado selecionado deve ser salvo, dentro desse prazo, em armazenamento gerenciado pela própria equipe. Depois, a localização interna do recurso deve ser registrada na tarefa. Esse arquivamento é uma responsabilidade que a solução de integração precisa implementar. “Suporte a callbacks” não significa que o produto guardará os arquivos permanentemente por você.
A aceitação pode ser verificada a partir da mesma solicitação: confirmar que o resultado abre, que a imagem atende aos requisitos de design e que a cópia interna pode ser lida de forma independente; só então marcar a tarefa como entregue. Se a geração for bem-sucedida, mas o arquivamento falhar, os estados devem permanecer separados para que o salvamento possa ser concluído depois, sem levar o designer a acreditar que o recurso já está na biblioteca. Este é um modelo sugerido de verificação de aceitação; seu funcionamento real não foi testado aqui.
Em um experimento interno que precise apenas de uma prévia temporária, a equipe pode aceitar resultados de curta duração, mas ainda deve informar os usuários sobre o limite de retenção. Quando os recursos precisarem ser reutilizados a longo prazo, é necessário definir o local de armazenamento e a responsabilidade pelo tratamento de falhas antes de ampliar a integração. A capacidade assíncrona de 4oImageApi.io oferece uma forma de tratar separadamente a espera e as notificações; o critério de entrega da equipe, porém, deve ser um arquivo que ela possa continuar recuperando por conta própria.
Nota sobre o conteúdo:Este artigo foi elaborado com base em informações públicas e serve como referência para a escolha de ferramentas. Os recursos, os preços e as políticas relacionadas podem mudar a qualquer momento; consulte as informações oficiais mais recentes.
Fonte original:docs.4oimageapi.io