ForHosting KIT · Imagens

Tags automáticas para fotos

Capacidade de API que analisa uma imagem e devolve tags — palavras-chave sobre o que aparece nela: objetos, cenário, cores, estilo. É o caminho para transformar milhares de fotos soltas em um acervo pesquisável, sem ninguém digitando etiqueta por etiqueta.

● Estávelpor imagemUS$ 0,010

Executar — US$ 0,010 + US$ 0,0575/imagem Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Acervo sem tag é acervo perdido

Todo mundo tem uma pasta — ou um servidor — com milhares de fotos que ninguém consegue achar. O fotógrafo procura “a foto do bolo de três andares”, o e-commerce procura “as fotos de camiseta vermelha”, e a resposta é rolar miniaturas por vinte minutos. Sem metadados, imagem não se busca. A marcação automática ataca exatamente isso: cada foto ganha um conjunto de palavras-chave e passa a ser encontrável por texto, no seu próprio sistema.

Que tipo de tag a IA devolve

As tags cobrem o que é visível e útil para busca: objetos (bolo, camiseta, notebook), cenário (praia, escritório, cozinha), atributos (vermelho, vintage, minimalista) e composição (close, vista aérea, fundo branco). Você pode orientar a marcação para o seu vocabulário — pedir tags voltadas a moda, gastronomia ou imóveis — e o resultado chega estruturado, pronto para gravar no banco, no DAM ou numa planilha.

Encaixando no que você já usa

Não é preciso trocar de sistema: a API recebe a imagem e devolve as tags, e o seu script grava onde fizer sentido — campos do WordPress, atributos do produto na loja, colunas de uma planilha de controle. O processamento é assíncrono, então lotes grandes rodam sem pressa: envie as fotos à noite, colete os resultados de manhã. Cada arquivo pode ter até 15 MB e 12 megapixels.

O preço para etiquetar tudo de uma vez

US$ 0,0575 por imagem, mais US$ 0,010 por chamada — marcar um acervo de 10.000 fotos custa US$ 675, uma única vez. Depois disso, só as fotos novas geram custo. Não há mensalidade nem contrato: é o modelo certo para um trabalho que, na maioria das empresas, se faz uma vez e se mantém aos poucos.

Casos de uso

Fotógrafo de eventos com HD lotado

Thiago Barbosa Lima fotografa casamentos em Porto Alegre e acumula 60 mil fotos. Com as tags geradas, ele encontra “buquê”, “pista de dança” ou “pôr do sol” em segundos quando monta portfólio ou atende um pedido de cliente antigo.

Catálogo que o cliente encontra

A loja virtual da Distribuidora Horizonte Verde tinha fotos boas e busca ruim. As tags automáticas viraram atributos de filtro — cor, ambiente, tipo — e o cliente passou a achar o produto sem saber o nome exato dele.

Arquivo de redação com décadas de fotos

Um jornal do interior digitalizou seu arquivo fotográfico. Marcado automaticamente, o acervo respondeu pela primeira vez a buscas como “enchente centro 1997” combinando as tags com a data da pasta.

Perguntas frequentes

Posso restringir as tags ao meu próprio vocabulário?

Dá para orientar a marcação indicando o domínio e os termos que interessam — útil quando o acervo é de nicho, como moda ou arquitetura. O resultado fica mais consistente do que tags totalmente livres.

Quantas tags vêm por foto?

Varia com a riqueza da imagem: uma foto de produto em fundo branco rende poucas tags precisas; uma cena de evento rende mais. O objetivo é cobrir o que alguém digitaria para encontrar aquela foto.

Qual o custo real para um acervo de 60 mil fotos?

60.000 × US$ 0,0575 = US$ 3.450, mais as chamadas a US$ 0,010. É investimento único — dali em diante, só o fluxo de fotos novas. Sem plano, sem fidelidade, preço publicado.

Meu acervo tem fotos de clientes. Isso é problema?

As imagens são analisadas para gerar as tags e não são retidas para outros fins nem cedidas a terceiros. O serviço não identifica pessoas — a tag diz “noiva dançando”, nunca quem é a noiva. Documentação para a LGPD disponível a pedido.

Funciona com prints de tela e imagens de redes sociais?

Funciona: prints, memes e artes com texto recebem tags sobre o que mostram. Para extrair o texto escrito dentro da imagem, porém, o caminho é OCR — marcação e leitura de texto são tarefas distintas.

Preciso abrir conta para começar?

Não existe cadastro por enquanto: a compra é direta. Você fala com a gente por WhatsApp ou e-mail, paga via PayPal e recebe o acesso — quem atende é gente de verdade, em espanhol ou inglês.

Para desenvolvedores — acesso via API

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.

Endpoint

POSThttps://api.kit.forhosting.com/image/tag

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

Chame do seu código

curl -X POST https://api.kit.forhosting.com/image/tag \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/tag", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/tag",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/tag", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/tag", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.tag",
  "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.

Preço

por chamadaUS$ 0,010

por imagemUS$ 0,0575

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

Limites

`max_mb`	15
`max_megapixels`	12

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.
`422`	`task_failed`	A tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →