Perguntas frequentes

Tudo o que você precisa saber sobre o Pexafy. Não encontrou sua resposta? Fale conosco.

Primeiros Passos

O que é o Pexafy?

O Pexafy é um motor de busca de imagens movido por IA que agrega milhões de imagens gratuitas e premium de diversas fontes — Unsplash, Pexels, Pixabay, Wikimedia Commons e outras — em uma única API. Em vez de integrar dezenas de serviços de imagens, você faz uma única requisição ao Pexafy e obtém os melhores resultados de todas as fontes, classificados por relevância semântica com IA.

Como obtenho uma chave de API?

Crie uma conta gratuita em pexafy.com/auth/register/, depois acesse Painel → Chaves de API → Criar Chave. Sua primeira chave é gerada instantaneamente, sem necessidade de cartão de crédito. O plano gratuito inclui 1K requisições de API por mês.

O Pexafy é gratuito?

Sim! Nosso plano Gratuito oferece 1K requisições de API por mês — sem necessidade de cartão de crédito. Você pode realizar buscas por texto e acessar todas as fontes de imagens gratuitas. Precisa de mais requisições, imagens premium ou busca por imagem? Confira nossa página de Preços para os planos Pro e Business.

Quais fontes de imagens o Pexafy pesquisa?

O Pexafy agrega imagens atualmente do Unsplash, Pexels, Pixabay, Wikimedia Commons e Openverse. Estamos adicionando novas fontes continuamente. Você pode filtrar os resultados por fonte usando o parâmetro source na API.

Em que o Pexafy se diferencia do Google Imagens?

O Pexafy é uma API focada em desenvolvedores, não um motor de busca para consumidores. Agregamos apenas fontes de uso gratuito e Creative Commons, portanto todos os resultados são seguros para uso em seu produto. Nosso modelo de IA compreende significado semântico — pesquise 'clima aconchegante de outono' e obtenha imagens relevantes, não apenas correspondências por palavra-chave. Além disso, você recebe respostas JSON estruturadas, paginação, filtros e análises de uso — tudo via uma única API REST.

Vocês oferecem SDKs ou bibliotecas de cliente?

Atualmente fornecemos uma API REST com documentação abrangente. SDKs oficiais para Python, JavaScript/TypeScript e PHP estão em nosso roadmap. Enquanto isso, a API é simples de integrar — basta uma única requisição HTTPS com um cabeçalho de chave de API. Consulte nossa documentação para exemplos de código em diversas linguagens.

API & Técnico

Qual é o limite de requisições da API?

Os limites de requisições dependem do seu plano: Gratuito — 20 requisições/minuto, Pro — 60 requisições/minuto, Business — 300 requisições/minuto. Se você ultrapassar o limite, receberá uma resposta 429 Too Many Requests com um cabeçalho Retry-After indicando quando poderá tentar novamente.

Quais formatos são retornados pela API?

Todas as respostas são JSON com um envelope padrão: {success, data, meta, pagination, error}. Cada objeto de foto inclui: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors e relevance score.

Como faço para lidar com a paginação?

O Pexafy utiliza paginação baseada em cursor. Cada resposta inclui um valor pagination.next_cursor. Passe-o como parâmetro cursor na próxima requisição para obter a página seguinte. Quando next_cursor for null, você chegou ao fim.

Posso filtrar os resultados da busca?

Sim! Você pode filtrar por: color_name (red, blue, green…), color_hex (ex.: #FF5733 com color_tolerance opcional), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) e score_threshold (relevância mínima de 0.0 a 1.0). Combine filtros para resultados mais precisos.

Como faço a autenticação das requisições da API?

Adicione sua chave de API como cabeçalho da requisição: X-Api-Key: pxfy_your_key_here. Alternativamente, use autenticação por token Bearer: Authorization: Bearer <jwt_token>. Nunca compartilhe sua chave de API em código do lado do cliente.

Qual é o número máximo de resultados por requisição?

Você pode solicitar até 80 resultados por página usando o parâmetro per_page (o padrão é 20). Para conjuntos de resultados grandes, use a paginação baseada em cursor para buscar páginas subsequentes. Não há limite para o número total de páginas que você pode paginar.

O Pexafy suporta consultas de pesquisa multilíngues?

Sim! Nosso modelo foi treinado com dados multilíngues, então você pode pesquisar em inglês, francês, espanhol, alemão, português e muitos outros idiomas. A compreensão semântica funciona melhor em inglês, mas a maioria das consultas comuns em outros idiomas produz resultados precisos. Recomendamos o inglês para máxima precisão.

Faturamento e Planos

Posso mudar meu plano?

Sim, você pode fazer upgrade ou downgrade a qualquer momento em Painel → Faturamento. Upgrades entram em vigor imediatamente com cobrança proporcional. Downgrades entram em vigor no final do seu período de faturamento atual. Tudo é gerenciado automaticamente pelo Stripe.

O que acontece se eu ultrapassar minha cota?

As requisições à API são bloqueadas assim que você atinge seu limite mensal — você receberá uma resposta 429 com uma mensagem de erro informativa. Para continuar usando a API, faça upgrade para um plano superior em Painel → Faturamento.

Vocês oferecem reembolsos?

Oferecemos uma garantia de reembolso de 14 dias em todos os planos pagos. Se você não estiver satisfeito nos primeiros 14 dias após a assinatura, entre em contato pelo [email protected] e emitiremos um reembolso integral, sem perguntas.

Quais métodos de pagamento vocês aceitam?

Aceitamos todos os principais cartões de crédito e débito (Visa, Mastercard, American Express), além de Apple Pay e Google Pay — todos processados com segurança pelo Stripe. Não armazenamos nenhuma informação de pagamento em nossos servidores.

Existe contrato de longo prazo?

Sem contratos, sem compromissos. Todos os planos são mensais (ou com desconto anual, se preferir). Cancele a qualquer momento em Painel → Faturamento com um único clique. Seu acesso continua até o final do período de faturamento atual.

Existe desconto para pagamento anual?

Sim! Pagar anualmente economiza aproximadamente 17%: o Pro custa $290/ano ($24/mês) em vez de $29/mês. O Business custa $2990/ano ($249/mês) em vez de $299/mês. Mude para o plano anual em Painel → Faturamento.

Vocês oferecem planos empresariais personalizados?

Sim! Se suas necessidades ultrapassam o plano Business — limites de taxa mais altos, infraestrutura dedicada, SLA personalizado ou implantação on-premise — entre em contato pelo [email protected] com seus requisitos. Elaboraremos um plano sob medida para a sua organização.

Quais moedas vocês aceitam para pagamento?

Todos os preços são exibidos em USD. O Stripe, nosso processador de pagamentos, converte automaticamente para a sua moeda local no momento do checkout. Seu banco pode cobrar uma pequena taxa de câmbio dependendo do tipo de cartão e do país.

Imagens e Licenciamento

O Pexafy é dono das imagens?

Não. O Pexafy é um mecanismo de busca — indexamos e pesquisamos imagens hospedadas em plataformas de terceiros (Unsplash, Pexels, Pixabay, etc.). Não armazenamos, hospedamos nem redistribuímos os arquivos de imagem originais. Todas as imagens permanecem propriedade de seus respectivos fotógrafos e plataformas.

Posso usar as imagens para fins comerciais?

Depende da licença da fonte. Unsplash, Pexels e Pixabay oferecem licenças de uso comercial gratuitas para a maioria de suas imagens. O Wikimedia Commons e o Openverse utilizam diversas licenças Creative Commons — algumas permitem uso comercial, outras não. Sempre verifique o campo de licença na resposta da API e confirme na URL de origem antes de usar uma imagem comercialmente.

Como as imagens premium são diferentes?

As imagens premium aparecem nos resultados de busca, mas podem exigir uma assinatura ou compra na fonte para download em resolução completa. A API retorna pré-visualizações/miniaturas para todas as imagens. Nos planos Free e Pro, a URL de origem na resposta indicará onde acessar a imagem completa.

Posso baixar imagens via API?

O Pexafy retorna URLs de imagens hospedadas em suas plataformas originais — não fornecemos arquivos de imagem diretamente pela API. Para imagens gratuitas (Unsplash, Pexels, Pixabay), você pode baixar a imagem em resolução completa a partir da URL de origem fornecida na resposta. Sempre respeite os termos de serviço da plataforma de origem.

Com que frequência o índice de imagens é atualizado?

Nosso pipeline de indexação é executado diariamente para todas as principais fontes. Novas imagens enviadas ao Unsplash, Pexels, Pixabay e outras plataformas geralmente ficam disponíveis para busca no Pexafy em 24–48 horas. Nosso índice contém atualmente mais de 5 milhões de imagens e cresce todos os dias.

Conta e Segurança

Como excluo minha conta?

Acesse Dashboard → Configurações → Zona de Perigo → Excluir Conta. A exclusão da conta é permanente e remove todas as suas chaves de API, histórico de uso e dados pessoais. Você também pode nos enviar um e-mail para [email protected] para solicitar a exclusão com base no GDPR/direito ao apagamento.

Meus dados estão seguros?

Sim. Usamos HTTPS em todos os lugares, bcrypt para hash de senhas e armazenamos sessões no Redis com tokens JWT de curta duração. Não vendemos nem compartilhamos seus dados com terceiros. As chaves de API são armazenadas com hash. Leia nossa Política de Privacidade para obter detalhes completos sobre as práticas de dados.

Posso ter várias chaves de API?

Sim, dependendo do seu plano: Free (1 chave), Pro (5 chaves), Business (∞ chaves). Várias chaves permitem separar o uso por aplicação, ambiente (dev/staging/prod) ou membro da equipe, e revogar chaves individuais sem afetar as demais.

O que acontece se minha chave de API for comprometida?

Revogue imediatamente a chave comprometida em Dashboard → Chaves de API e crie uma nova. A revogação entra em vigor instantaneamente — qualquer requisição usando a chave antiga será rejeitada com erro 401. Nunca inclua chaves de API no controle de versão; use variáveis de ambiente.

Qual é a garantia de disponibilidade do serviço?

Nosso objetivo é 99,9% de disponibilidade para a API. Clientes do plano Business recebem um SLA com compromissos de uptime. Você pode monitorar o status do serviço em tempo real e histórico em nossa página de Status, acessível pelo rodapé deste site.

O Pexafy está em conformidade com o GDPR?

Sim. Coletamos apenas os dados mínimos necessários para operar o serviço (e-mail, senha com hash, logs de uso). Não vendemos dados a terceiros. Você pode solicitar exportação completa dos seus dados ou exclusão a qualquer momento em Dashboard → Configurações ou enviando um e-mail para [email protected]. Consulte nossa Política de Privacidade para mais detalhes.

Ainda tem dúvidas?

Não encontrou o que procura? Nossa equipe terá prazer em ajudar.

Contatar o suporte Leia a documentação da API

Sobre o Pexafy Blog