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 mecanismo de busca de imagens com inteligência artificial que agrega milhões de imagens de uso gratuito de 9 fontes — Unsplash, Pexels, Pixabay, Kaboompics, Burst e mais — em uma única API. Uma requisição ao Pexafy = uma busca semântica em todas as 9 fontes. Com as APIs próprias dos provedores, a mesma busca exige de 3 a 5 chamadas, além da lógica de fusão e a normalização do JSON: código que você escreve, mantém e paga.
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 5K requisições de API por mês.
Preciso ter minha aplicação aprovada?
Não. Sua chave funciona na primeira chamada: sem revisão de aplicativo, sem período de espera e sem necessidade de fazer uma chamada de rastreamento de download a cada download. O Unsplash limita aplicativos não aprovados a 50 requisições/hora até revisar seu app; o Pexels permite 200/hora.
O Pexafy é gratuito?
Sim! Nosso plano Free oferece 5K requisições de API por mês — sem cartão de crédito — e busca em todas as fontes que o Pexafy indexa, como qualquer outro plano. Precisa de mais requisições? Os planos pagos, do Starter ao Enterprise, aumentam os limites: veja nossa página de preços.
Quais fontes de imagens o Pexafy pesquisa?
O Pexafy agrega atualmente 9 fontes, sendo as maiores Unsplash, Pexels, Pixabay, Kaboompics, Burst. Estamos adicionando mais 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, troque de plano quando quiser em Painel → Faturamento. A mudança vale na hora e a Creem, nossa revendedora, calcula o valor proporcional: ao passar para um plano superior, cobra a diferença de preço pelo restante do período atual; ao passar para um inferior, devolve essa diferença.
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. A Creem, nossa revendedora, devolve o valor ao seu meio de pagamento original. Detalhes na nossa Política de Reembolso: pexafy.com/legal/refund/
Quais métodos de pagamento vocês aceitam?
Os pagamentos são processados pela Creem, nossa revendedora e Merchant of Record. Você pode pagar com cartão de crédito ou débito, ou com os outros meios de pagamento que a Creem oferece no checkout do seu país. Nunca vemos nem armazenamos os dados do seu cartão.
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 até 18%: o Pro custa $199/ano ($17/mês) em vez de $19/mês. O Business custa $2599/ano ($217/mês) em vez de $249/mês. Mude para o plano anual em Painel → Faturamento.
Vocês oferecem planos empresariais personalizados?
Sim! Se suas necessidades ultrapassam o plano Enterprise — 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 estão em USD, e a Creem, nossa revendedora, cobra em USD. Dependendo do seu país, impostos como o IVA podem ser adicionados no checkout. Se o seu cartão usa outra moeda, o seu banco converte o valor e pode cobrar uma pequena taxa de câmbio.
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 gratuito para a maioria de suas imagens, e as fontes menores que indexamos seguem o mesmo modelo. Sempre verifique o campo de licença na resposta da API e confirme na URL de origem antes de usar uma imagem comercialmente.
Eu pago pelas imagens?
Não. O Pexafy não vende imagens. Cada resultado vem de uma biblioteca de uso livre — Unsplash, Pexels, Pixabay, Kaboompics, Burst e outras — e leva de volta a ela, sob a licença própria dessa biblioteca. Seu plano paga apenas pelo serviço de busca: requisições de API, limites de taxa, chaves de API e suporte. Confira a licença de cada imagem na fonte antes de usá-la.
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. 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 9M+ 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.
Nenhuma pergunta corresponde à sua busca. Tente outro termo.
Pergunte diretamenteAinda tem dúvidas?
Não encontrou o que procura? Nossa equipe terá prazer em ajudar.
Contatar o suporte Leia a documentação da API