A API compatível da 1min.AI não deduplica pedidos: as tentativas automáticas após uma interrupção exigem um desenho próprio

A API Chat Completions compatível com OpenAI da 1min.AI não aceita chaves de idempotência, e reenviar um pedido POST pode gerar outra cobrança. Em resumos em lote ou tarefas automatizadas, é preciso distinguir um resultado incompleto, um custo já incorrido e um processo de negócio ainda por concluir antes de decidir se haverá uma nova tentativa.

Fonte: docs.1min.ai
November 10, 2026
4 min

Ao ligar um processo de resumos em lote à 1min. AI, conseguir enviar pedidos com um SDK conhecido resolve apenas parte da integração. O que realmente afeta a execução sem supervisão é a forma como o sistema reage quando a ligação é interrompida. A documentação oficial da API compatível é explícita: não há deduplicação de pedidos nem chaves de idempotência; repetir um pedido POST constitui uma nova geração e pode gerar outra cobrança. Por isso, as tentativas automáticas habitualmente usadas na aplicação existente precisam de uma verificação específica antes da integração.

Este artigo aborda a API Chat Completions compatível com OpenAI da 1min. AI, com base na documentação oficial. Não estende estas limitações a todas as ferramentas da plataforma, nem foram realizados testes reais de falhas.

Não receber uma resposta completa não significa que não tenha havido custos

A documentação recomenda definir maxRetries ou max_retries como 0 no cliente. Se uma resposta em streaming não incluir [DONE], deve ser considerada incompleta; cancelar o pedido também não garante que seja gratuito, pois a utilização já comunicada pelo fornecedor continua a ser cobrada. Estas regras significam que a aplicação precisa de registar separadamente «se o resultado está completo» e «se é possível que já tenham sido consumidos créditos», em vez de resumir ambos os aspetos num único indicador de falha.

Por exemplo, uma tarefa em segundo plano que resume diariamente documentos de clientes perde a ligação depois de receber parte do texto. Se a fila de trabalho reenviar o pedido imediatamente, o mesmo documento pode gerar uma nova resposta. Entregar depois o segundo resultado completo a um colega não elimina o possível custo da primeira tentativa. Este exemplo ilustra o risco, não é o registo de um incidente ocorrido na plataforma.

A deduplicação do processo de negócio deve ficar na própria camada de tarefas

Uma avaliação mais prudente da integração consiste em atribuir um identificador interno de tarefa a cada entrada, registar o modelo, o número de tentativas e o estado de conclusão, e isolar os resultados incompletos. No processamento seguinte, verifica-se primeiro se a tarefa já tem um resultado utilizável, para depois decidir se se inicia uma nova geração. Este registo interno pode reduzir o processamento duplicado no negócio, mas não confere à API do fornecedor uma idempotência de cobrança que ela não oferece.

Se uma tarefa realmente precisar de uma nova tentativa, devem ser definidos explicitamente o número de tentativas permitido e o orçamento, e deve ser guardado x-request-id para ajudar a equipa de suporte a investigar. Este identificador serve para localizar o pedido e não deve ser tratado como uma chave de deduplicação. Para processos que não aceitam consumo duplicado ou que têm de garantir um processamento exatamente uma vez, este limite pode ser mais importante do que a conveniência de um ponto de acesso unificado aos modelos. Será preciso acrescentar controlos na aplicação ou escolher um serviço mais adequado aos requisitos.

Mesmo quando o fluxo termina, é preciso verificar o resultado do processo

A documentação oficial também indica que saídas recusadas ou truncadas não garantem a estrutura esperada, pelo que é necessário verificar message.refusal e finish_reason antes de as processar. Assim, receber uma transmissão completa é apenas um ponto de verificação: ao produzir resumos estruturados, também é preciso validar se todos os campos estão presentes; se a intenção for executar ações sugeridas pelo modelo, a aplicação deve validar os parâmetros e as permissões. Um JSON que pode ser analisado não deve ser tratado automaticamente como uma instrução executável.

Antes da entrada em produção, podem ser usados exemplos não sensíveis para ensaiar uma resposta completa, uma interrupção a meio, uma recusa e um truncamento, verificando se cada estado da tarefa tem um tratamento definido e se o tratamento de erros não desencadeia pedidos adicionais inadvertidamente. Esta é uma lista de verificações recomendada para aceitação, não uma certificação de compatibilidade já concluída. Se estes estados puderem ser claramente registados e controlados, a API unificada será mais adequada ao processamento em lote; se a única estratégia for «se falhar, tentar outra vez», manter primeiro uma revisão humana é mais prudente do que alargar diretamente a automação.

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.1min.ai