Solicitação cURL
POST /api/v1/image/profilecurl -X POST "https://avatarlookup.com/api/v1/image/profile" \
-H "X-API-Key: sk_your_api_key" \
-F "file=@avatar.jpg"
product image_profile
Análise de perfil por imagem
Envie qualquer imagem e receba seus atributos de retrato: idade estimada, gênero, tipo de imagem, cor do cabelo e tom de pele.
Custo de uso: $ 0,002 / verificaçãoModo de resposta: Síncrono
POST /api/v1/image/profileContrato da API
Uma solicitação, resultado imediato
Envie uma imagem como campo de arquivo multipart chamado file. A autenticação usa sua chave de API.
Copie o comando curl abaixo e substitua apenas a chave de API de exemplo pela sua.
Resposta
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "image_profile",
"identifier": "img:7013df96c540904a4b7ba295e9162ab2",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Como usar
Três pontos-chave sobre a análise de imagem
Envie a própria imagem
Uma imagem por solicitação, como campo de arquivo multipart chamado file. JPEG, PNG, WebP ou GIF, até 2 MB. Nenhum número ou e-mail é necessário — a resposta descreve a imagem, não uma conta.
Leia category antes do resto
category informa o que a imagem mostra. Imagens de animais, desenhos, paisagens ou objetos são analisadas e cobradas, mas não trazem os campos de idade nem de gênero.
Não guardamos a imagem
A imagem vai direto para a análise e nunca é armazenada. identifier é uma impressão digital derivada do conteúdo da imagem, então a mesma imagem sempre gera o mesmo valor — use-o para eliminar duplicatas do seu lado.
O que verifica
O que a Análise de perfil por imagem retorna?
Campos retornados
identifier· string — Impressão digital da imagem enviada, derivada do seu conteúdo. A mesma imagem sempre gera o mesmo valor.category· string — O que a imagem mostra: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar ou object. unknown quando não foi possível gerar um retrato.age· integer — Idade estimada como número inteiro, com precisão de cerca de 3 anos e limitada a 0-80. Omitida quando não foi possível estimá-la (por exemplo, quando nenhum gênero foi determinado).gender· string — male, female ou unknown.skin_color· string — Tom de pele descritivo, por exemplo white, east_asian ou hispanic. Trate-o como um conjunto aberto; unknown quando não determinado.hair_color· string — Cor do cabelo descritiva, por exemplo black, brown, blond ou gray white. Trate-a como um conjunto aberto; unknown quando não determinada.
Ideal para
Use este produto quando precisar de
Acervos de fotos de perfil existentes
Adicione impressões digitais, tipos de imagem e atributos de retrato consistentes a fotos de perfil e imagens históricas, reduzindo a navegação e a classificação manuais.
Perfil de público
Organize os ativos por tipo de imagem, idade estimada, gênero, cor do cabelo e tom de pele para examinar a composição de um acervo e recuperar registros depois.
Triagem para moderação de conteúdo
Identifique primeiro retratos, fotos em grupo, desenhos, animais, paisagens e objetos e depois encaminhe cada imagem para o fluxo de revisão manual adequado.
Enriquecimento de dados
Grave os resultados da análise nos dados de clientes, conteúdo ou ativos para que registros que tinham apenas uma imagem ganhem campos estruturados para filtragem.
Resposta direta
O que é a Análise de imagem?
Análise de perfil por imagem retorna os atributos da própria imagem: tipo de imagem, gênero, idade estimada, tom de pele e cor do cabelo. Envie uma imagem ao endpoint de imagem como campo de arquivo multipart chamado file e leia os atributos do retrato no nível superior da mesma resposta da API. Nenhum identificador é necessário.
Limites claros
O que não retorna
- Descreve a imagem, não uma pessoa nem uma conta: o resultado não contém nenhuma afirmação sobre registro, alcançabilidade ou identidade.
- Idade, gênero, tom de pele e cor do cabelo são estimativas algorítmicas a partir de uma única imagem. Use-os apenas como sinais complementares — nunca como base para verificação de identidade, filtragem discriminatória ou qualquer decisão de alto impacto.
- Imagens sem pessoas também retornam resultado e também são cobradas. Apenas um erro do serviço, uma imagem que não conseguimos baixar ou ler, ou uma resposta do modelo sem nenhum campo é grátis.
Perguntas frequentes do produto
Perguntas sobre a Análise de imagem
O que a Análise de perfil por imagem retorna?
Retorna os atributos da própria imagem: tipo de imagem, gênero, idade estimada, tom de pele e cor do cabelo, na mesma resposta síncrona.
Como funciona a cobrança da Análise de imagem?
O saldo é cobrado por toda imagem que volta com resultado, incluindo animais, desenhos e paisagens. Apenas um erro do serviço, uma imagem que não conseguimos baixar ou ler, ou uma resposta do modelo sem nenhum campo é grátis.
Quais formatos e tamanhos de imagem são aceitos?
JPEG, PNG, WebP ou GIF, até 2 MB por imagem. O tipo é determinado pelo próprio conteúdo do arquivo, não pela extensão.
Vocês armazenam a imagem?
Não. A imagem vai direto para a análise e nunca é gravada em disco nem em armazenamento de objetos. Apenas a impressão digital derivada do conteúdo é mantida no registro da verificação.
Produtos relacionados
Outros produtos de análise de fotos de perfil
Análise de foto de perfil do WhatsAppVerifique se um número tem foto de perfil no WhatsApp, obtenha a URL da imagem e leia os atributos de retrato dessa foto.
Análise de foto de perfil de e-mailVerifique se uma conta de e-mail tem foto de perfil e leia seus atributos de retrato. Cobre Gmail, Yandex e Mail.ru.Comece a verificar agora
Crie uma conta para usar todos os produtos pelo painel SaaS ou pela API: verificações em tempo real e verificações em massa assíncronas usam o mesmo saldo.