Truncar texto

Um comprimento menor que um é rejeitado com um erro claro de invalid_input, para que a validação de formulários e o CI nunca tratem um teto zero ou negativo como sucesso. O caminho é pura lógica determinística de strings — sem rede, sem sementes aleatórias, sem dependência de relógio — então o executor gratuito no navegador e a API pré-paga retornam o mesmo JSON a cada chamada.

O que significa truncar com reticências em comparação com reescrever ou aparar

Se não cabe, o resolvedor calcula um orçamento de conteúdo igual ao comprimento menos o tamanho das reticências, pega um prefixo até esse orçamento, opcionalmente recua até o espaço em branco anterior quando word_boundary é true, remove espaços finais do prefixo mantido para que as reticências não fiquem após uma lacuna solta e concatena as reticências.

Como chamar a API e o que a resposta contém

Envie um corpo JSON com o campo obrigatório text (aliases input, value, string, s, content e body) e o obrigatório length (aliases max_length, max, n, limit e max_len). O comprimento deve ser um inteiro de um a cem mil, inclusive; valores abaixo de um, não inteiros e limites excessivos são invalid_input. O opcional word_boundary (aliases word, soft, on_word) tem false como padrão e aceita booleano true ou false. O opcional ellipsis (aliases suffix, ending, marker) tem como padrão três pontos ASCII e pode ser qualquer string de até trinta e dois caracteres; quando o truncamento é necessário, as reticências não podem ser maiores que length, senão a requisição falha em vez de inventar um marcador cortado. O texto deve ficar dentro de cem mil caracteres para que uma única requisição não esgote a memória do Worker ou do navegador. Em caso de sucesso, a resposta ecoa input como a string original, text como a string final a exibir, length como o máximo solicitado, original_length e result_length como contagens de caracteres, truncated como booleano, word_boundary como o flag enviado (ou o padrão), ellipsis como o sufixo usado, used_word_boundary quando um corte suave foi aplicado, e message como um resumo curto em inglês. Uma validação malsucedida — falta de text ou length, um text que não é string, um length não inteiro ou menor que um, um payload grande demais ou reticências que não cabem no limite quando o corte é necessário — retorna invalid_input e nunca é cobrada. O preço é um valor fixo de US$ 0,002 por requisição bem-sucedida, com item unitário e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Use esta capacidade quando a intenção de busca for truncar texto, adicionar reticências no comprimento máximo ou fazer corte suave no limite de palavra online. Reticências personalizadas, como um único caractere Unicode de reticências horizontais ou um rótulo «mais» entre colchetes, funcionam quando seu tamanho ainda cabe no orçamento. Esta landing não é um resumidor de IA, não é um contador de parágrafos ou palavras, não é um conversor para caixa de título e não é um aparador apenas das bordas das linhas. Verificações de ida e volta para testes são fáceis: forneça uma frase longa com comprimento vinte e espere truncated true e result_length no máximo vinte; ative word_boundary em uma frase de várias palavras e espere que o último caractere mantido não fique dentro de uma palavra quando havia um espaço anterior; envie comprimento zero ou um inteiro negativo e espere invalid_input mencionando comprimento abaixo de um. Prefira o corte rígido quando precisar de uma grade fixa de caracteres, como logs monoespaçados; prefira word_boundary para títulos e pré-visualizações voltados a pessoas, onde quebras no meio da palavra parecem erradas. Prefira text.shorten quando precisar de compressão que preserve o significado sob um orçamento de palavras com um modelo de linguagem; prefira str.trim_lines quando precisar apenas de limpeza de espaços por linha; prefira esta capacidade quando o produto já decidiu um comprimento máximo rígido de exibição e precisa mostrar um prefixo fiel. Tarefas malsucedidas que retornam invalid_input não consomem saldo pré-pago, o que mantém baratos a validação de formulários e os testes negativos de CI. Ao ensinar revisores, mostre a mesma frase nos modos rígido e suave para que vejam que apenas a posição do corte e o flag used_word_boundary mudam, enquanto a regra das reticências permanece a mesma.