ForHosting KIT · Imagens

Detectar objetos em imagem

Capacidade de API que examina uma foto e devolve a lista de objetos presentes nela: produtos, móveis, veículos, equipamentos, pessoas. Transforma imagem em dado estruturado — o primeiro passo para automatizar conferências, vistorias e qualquer processo que hoje depende de alguém olhando foto por foto.

● 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.

Da foto solta ao dado estruturado

Uma foto diz muito para um humano e nada para um sistema — até virar lista. A detecção de objetos faz essa ponte: entra a imagem, sai a relação do que há nela, em formato que o seu software consegue comparar, filtrar e auditar. Com isso, perguntas operacionais ganham resposta automática: a foto da entrega mostra os volumes? A vaga do estacionamento tem carro? O equipamento aparece na foto da vistoria?

O que dá para detectar (e o que pedir com cautela)

Objetos do cotidiano — móveis, eletrônicos, veículos, embalagens, EPIs, alimentos — são o terreno forte. Itens muito pequenos no quadro, parcialmente encobertos ou fotografados no escuro saem com confiabilidade menor. Distinções finas entre objetos quase iguais (dois modelos parecidos do mesmo produto) também pedem cautela. A regra prática: se uma pessoa atenta identifica o item na foto em um segundo, a detecção tende a ir bem; se ela hesita, desconfie também do automático.

Montando o fluxo no seu sistema

A chamada é assíncrona: você envia a foto, recebe um task_id e coleta o resultado com a lista de objetos. No sistema, isso vira regra de negócio — “se a lista não contém capacete, marcar a foto para revisão”, “se contém mais de dez volumes, conferir com o romaneio”. Envie imagens de até 15 MB e 12 megapixels; para fotos de operação, a câmera de um celular comum resolve.

Preço por foto, sem pacote

US$ 0,010 por chamada mais US$ 0,0575 por imagem. Uma operação que analisa 300 fotos de vistoria por semana gasta cerca de US$ 81 ao mês — sem contrato, sem franquia, e o custo acompanha o volume real. Se a operação parar na baixa temporada, a conta para junto.

Casos de uso

Conferência de entrega com foto

Os motoristas da Distribuidora Horizonte Verde fotografam a carga na doca do cliente. O sistema detecta os volumes na imagem e compara com o pedido — divergência vira alerta antes de o caminhão ir embora.

EPI no canteiro de obras

Uma construtora de Curitiba recebe fotos diárias das frentes de trabalho. A detecção verifica a presença de capacete e colete nas imagens e encaminha para o técnico de segurança só as fotos em que algo parece faltar.

Vistoria de imóvel na devolução

Uma administradora de imóveis compara as fotos de entrada e saída do inquilino. A lista de objetos detectados em cada cômodo ajuda a conferir o inventário — o armário que aparecia na entrada aparece na saída?

Perguntas frequentes

O resultado diz onde o objeto está na foto?

O retorno padrão é a lista do que foi identificado na imagem. Se o seu caso exige localização precisa dos itens no quadro, descreva o cenário para a gente antes de integrar — assim você confirma se a capacidade atende do jeito que precisa.

Serve para contar quantos itens aparecem?

Para contagens pequenas e itens bem visíveis, funciona razoavelmente; para contar dezenas de unidades empilhadas ou sobrepostas, a margem de erro cresce. Teste com fotos reais da sua operação antes de confiar a conferência ao automático.

Foto tirada de celular, com luz ruim, resolve?

Foto de celular resolve bem — o limite de 12 megapixels cobre qualquer aparelho atual. Luz ruim é outra história: penumbra e contraluz derrubam a detecção. Se puder padronizar o registro (flash ligado, objeto enquadrado), o ganho é grande.

Aparecem pessoas nas fotos. O serviço as identifica?

Não: quando há alguém na cena, o resultado aponta que existe uma pessoa, nunca quem ela é. Não há reconhecimento facial nem geração de dado biométrico, o que simplifica a análise de LGPD do seu jurídico.

Qual o custo em volume de operação?

Linear e publicado: US$ 0,0575 por imagem mais US$ 0,010 por chamada. Dez mil fotos analisadas custam US$ 675. Sem pacote mínimo — quem define a conta é o seu volume.

Como começo sem ter certeza de que atende?

Separe um lote de fotos reais e rode um teste pago pequeno — algumas dezenas de imagens custam menos de US$ 5. Com o resultado na mão, você decide a integração. Para falar antes com alguém, chame no WhatsApp: respondemos em espanhol ou inglês, e português escrito a gente entende bem.

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/detect-objects

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/detect-objects \
  -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/detect-objects", {
  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/detect-objects",
    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/detect-objects", 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/detect-objects", 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.detect_objects",
  "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 →