ForHosting KIT · Texto e IA

Primeira palavra do texto

De «Hello, world — this is a preview.» você recebe Hello, com 5 caracteres, e o resto da linha separado. Um título entre aspas como «Autumn notes» dá Autumn, e ...first-word! dá first-word. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Texto
Hello, world — this is a preview.
Você obtém
Primeira palavra
Hello
Comprimento
5
Original
Hello, world — this is a preview.
Índice inicial
0

Obter a primeira palavra de uma string bagunçada é um trabalho pequeno que aparece em todo lugar: slugs de título, prévias de notificação, analisadores de log e o primeiro token de uma linha de comando. Esta capacidade lê o seu texto, ignora os espaços e a pontuação que tantas vezes envolvem um cabeçalho ou uma frase citada, e devolve a primeira palavra de verdade junto com o comprimento e o restante. Espaços iniciais, tabulações, reticências, aspas e vírgulas finais não entram na resposta, de modo que Hello, world produz Hello e não um token preenchido ou pontuado.

Como a extração da primeira palavra funciona e o que conta como palavra

A intenção de busca de extrair a primeira palavra de um texto é mais estreita do que um tokenizador completo ou uma lista de palavras únicas: as pessoas querem o token de abertura de um título, uma notificação, uma linha de log ou um comando, limpo da decoração que costuma cercá-lo. Esta capacidade define uma palavra como uma sequência máxima de letras Unicode, marcas combinantes e dígitos, unida de forma opcional por um apóstrofo ou hífen internos para que contrações como don't e compostos como well-known continuem um único token.

Espaços, tabulações, quebras de linha, aspas, vírgulas, reticências, colchetes e o restante da pontuação nunca fazem parte desse token. Podem aparecer antes da palavra, depois ou dos dois lados; são cortados em vez de devolvidos. A frase Hello, world produz portanto Hello, um título entre aspas como "Autumn notes" produz Autumn, e uma linha que começa com reticências como ...first-word!

more text produz first-word. O comprimento é o comprimento em caracteres da forma de superfície encontrada, de modo que café conta quatro caracteres; se o acento vem pré-composto ou não é outro problema de busca: o motor devolve o recorte que de fato estava na entrada. Após a primeira correspondência, o resto da string aparece como remainder, com espaços cortados, assim uma segunda análise ou uma prévia da cláusula restante fica a um campo de distância.

Prévias de notificação e cartões

Interfaces de produto colam um título ou mensagem e mostram a primeira palavra limpa como distintivo compacto, em vez de um token preenchido ou pontuado.

Sementes de slugs e nomes de arquivo

Editores pegam a palavra de abertura de um título como semente de slug ou radical de arquivo e depois aplicam as próprias regras de minúsculas ou hífens.

Analisadores de comando e log

Scripts leem o primeiro token de uma linha de comando ou mensagem de log após aspas envolventes e roteiam conforme esse verbo ou nome de nível.

A pontuação ao redor permanece na primeira palavra?

Não. Pontuação e espaços iniciais e finais são cortados. Hello, vira Hello, e um Autumn entre aspas vira Autumn. Hífens e apóstrofos internos permanecem.

O que conta como uma palavra?

Uma sequência de letras Unicode, marcas combinantes ou dígitos, unida de forma opcional por um apóstrofo ou hífen internos. Assim don't e well-known continuam um único token.

O que o resultado mostra além da palavra?

O tamanho dela em caracteres e o restante, ou seja, o texto que vem depois da palavra, sem espaços nas pontas. Para Hello, world é «, world — this is a preview.», pronto para uma segunda leitura ou uma prévia.

O que acontece se o texto não tiver nenhuma palavra?

Ele é recusado com uma mensagem clara. Um texto vazio, só com espaços ou só com pontuação não gera palavra, porque uma palavra precisa de pelo menos uma letra ou um dígito.

Como usar com linhas de log ou comandos?

Scripts leem a primeira palavra de um comando ou de uma mensagem de log, mesmo entre aspas, e decidem o que fazer com base nesse verbo ou nível. As aspas e os espaços ao redor nunca entram na resposta.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/str/first-word

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/str/first-word \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, world — this is a preview."}'
{
  "text": "Hello, world — this is a preview."
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.first_word",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_chars100000
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

A mesma função determinística alimenta a ferramenta gratuita do navegador e a API pré-paga, assim uma prévia de CMS, um ajudante de slugs e um teste unitário fixam o mesmo JSON para a mesma entrada. Strings sem palavras — vazias, só espaços ou só pontuação — falham com invalid_input e não são cobradas. Chamadas API bem-sucedidas custam US$ 0,002 por item.

Contrato de entrada, campos da resposta e texto vazio ou sem palavras

Uma string vazia, só espaços ou só pontuação também falha, porque nenhuma palavra com letras ou dígitos foi encontrada: a mensagem indica que text deve conter ao menos uma palavra e que espaços e pontuação sozinhos não bastam. Remainder é omitido quando a entrada é uma só palavra, nunca enviado como null. Envie por POST um corpo JSON com o campo de string obrigatório text definido para o trecho que deseja analisar. Os aliases input, value, s, content e body são aceitos para que geradores de formulário e clientes antigos publiquem com nomes familiares. O valor deve ser uma string; objetos, arrays, booleanos e números falham com invalid_input nomeando o problema. Cargas maiores que o teto de caracteres documentado falham do mesmo modo para que um único pedido não monopolize a memória do Worker. Essas falhas de validação não são cobradas na API pré-paga. Em sucesso a resposta informa first_word como o token de abertura limpo, length como a contagem de caracteres, original como eco da entrada para tabelas de interface, start_index e end_index como os deslocamentos desse token dentro de original, remainder como a string restante após a palavra com espaços externos removidos, e method sempre em first_word para que os clientes ramifiquem sem farejar formas. Exemplo: Hello, world — this is a preview. produz first_word Hello, length cinco, start_index zero e um remainder que começa com uma vírgula e o resto da frase. Uma linha preenchida com dois espaços, três pontos, well-known e uma frase produz first_word well-known porque o hífen é interno e a pontuação inicial não é.

Prévias, slugs, pipelines de análise, preço e limites práticos

Chame a ferramenta gratuita no navegador para obter a primeira palavra quando precisar de um token de abertura limpo para a prévia de um cartão, o radical de um nome de arquivo, um distintivo de chat ou um analisador de comandos que deve ignorar aspas envolventes. Pipelines editoriais usam a mesma chamada para transformar um título em um rótulo curto sem arrastar a vírgula ou o travessão para o distintivo. Não espere stemming, remoção de stopwords nem detecção de idioma: são buscas e contratos diferentes. Desenvolvedores ligam a API pré-paga KIT quando um CMS, um cliente móvel ou um job em lote precisa do mesmo contrato com saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo depois que o motor rejeita o pedido. Um fluxo típico cola um título, lê first_word e passa para minúsculas no local se um ajudante de slugs precisa de uma semente. Combine este endpoint com uma ferramenta de slug ou de palavra mais longa quando o próximo passo for uma URL ou uma checagem tipográfica, mas conserve get-first-word como página própria para não misturar a intenção do token de abertura com a conversão de slugs de toda a string, contagens de palavras ou extração de palavras-chave.

Como obter a primeira palavra de uma string de texto?

Envie JSON com text definido para o seu trecho. A resposta inclui first_word, o comprimento, os deslocamentos inicial e final, e remainder com o que segue essa palavra.

O que acontece se o texto não tiver palavras?

O pedido falha com invalid_input. Strings vazias e entrada só de pontuação são rejeitadas e não são cobradas na API pré-paga.

Quanto custa o extrator da primeira palavra?

A ferramenta do navegador é gratuita. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →