> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions. # API de vetorização de imagens ou Potrace: qual usar? > Compare uma API de vetorização hospedada com o Potrace local. Use um teste monocromático e uma imagem de duas cores para decidir o que atende ao seu fluxo de SVG. Source: https://perfectvector.com/pt-BR/blog/image-vectorization-api-vs-potrace Language: pt-BR Author: Jay Published: 2026-11-12T08:00:00+09:00 O Potrace serve para um fluxo local em que cada imagem pode ser reduzida a uma cor de primeiro plano e um fundo. Uma API de vetorização hospedada serve para um aplicativo que pode enviar imagens e precisa obter os resultados por HTTP. Se a arte precisa manter várias cores distintas, confira essas cores no resultado antes de escolher. ## Compare onde a imagem é processada | Decisão | Potrace no seu computador ou servidor | API para desenvolvedores do PerfectVector | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Entrada | A ferramenta de linha de comando lê formatos bitmap como PBM, PGM, PPM e BMP. Prepare um PNG ou JPEG com outra ferramenta de imagem. | A API v1 aceita PNG, JPEG e WebP compatíveis em um upload multipart. | | Vetorização | A ferramenta usa um limiar para separar os pixels entre primeiro plano e fundo. Guarde a preparação e o limiar no controle de versão para reproduzir o resultado. | Envie a imagem original e receba um SVG. O serviço faz a vetorização. | | Operação | Instale as ferramentas, disponibilize recursos de computação e registre o resultado de cada execução local. | Gerencie a chave de API, respeite o limite padrão de conversões simultâneas em produção e salve os SVGs antes que os links expirem. | | Custo de operação | Planeje os gastos com computação, implantação e manutenção. | Conversões bem-sucedidas em produção usam créditos de API. Chaves de teste retornam um SVG fixo de exemplo. | A coluna do Potrace descreve a ferramenta padrão de linha de comando e sua vetorização monocromática. A coluna da API se refere ao PerfectVector v1. Outros serviços hospedados podem ter limites, regras de cobrança e downloads diferentes. [Manual do Potrace](https://potrace.sourceforge.net/potrace.1.html) · [Limites da API do PerfectVector](https://perfectvector.com/docs/api/limits) · [Resultados do PerfectVector](https://perfectvector.com/docs/api/results) · [Créditos da API do PerfectVector](https://perfectvector.com/docs/api/credits) ## O que uma passada do Potrace fez com dois PNGs Preparamos duas imagens de teste de 256 × 256 pixels. Uma era uma forma arredondada e escura com um vazado transparente. A outra tinha painéis vermelho e azul encostados. Colocamos cada PNG sobre um fundo branco, convertemos para PGM em tons de cinza e vetorizamos com Potrace 1.16 usando um nível de preto de 0,5. Esse limiar separa os pixels escuros do primeiro plano dos claros do fundo. | Origem | O que observamos no SVG do Potrace | Quando esse resultado serve | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | Forma escura com vazado transparente | Um traçado preto com dois subtraçados. No resultado renderizado com ImageMagick, o exterior e o centro ficaram transparentes e a forma ficou opaca. | Uma silhueta monocromática que precisa preservar o vazado. | | Painéis vermelho e azul encostados | Um traçado preto com um subtraçado. O centro dos dois painéis ficou preto. | Uma silhueta única. Se a separação de cores for importante, será preciso preparar a imagem de outro jeito. | **Teste local do Potrace** ![Dois PNGs originais e seus SVGs gerados pelo Potrace local. A forma arredondada mantém o vazado. Os painéis azul e vermelho viram uma silhueta preta.](https://perfectvector.com/blog/image-vectorization-api-vs-potrace/potrace-fixtures.webp) *Os PNGs originais estão à esquerda. Os SVGs da direita vieram da mesma passada do Potrace em tons de cinza.* Os dois resultados continham traçados e nenhuma imagem rasterizada incorporada. As observações vêm de duas conversões locais. Veja os comandos completos em [como preparar um PNG para o Potrace](https://perfectvector.com/pt-BR/blog/potrace-png-to-svg). ## Compare as duas opções com seus arquivos Escolha uma forma monocromática com um vazado importante e uma imagem com cores adjacentes que precisam ficar separadas. Registre os requisitos antes de vetorizar. Por exemplo, o fundo precisa aparecer pelo vazado e as duas cores devem ser visíveis como regiões distintas no tamanho de uso. 1. Use os mesmos originais nos dois fluxos. Registre o fundo, a conversão para tons de cinza e o limiar usados no Potrace. Salve o bitmap preparado junto com o SVG. 2. Use uma chave de teste do PerfectVector para verificar o upload, o processamento da resposta e o download do SVG. O exemplo fixo verifica a integração. Use uma chave de produção com os mesmos arquivos para avaliar a qualidade do resultado. [Modo de teste do PerfectVector](https://perfectvector.com/docs/api/test-mode) 3. Abra os dois conjuntos de resultados no mesmo visualizador ou editor de destino. Confira a silhueta, a separação das cores, os vazados e as imagens rasterizadas incorporadas. Registre onde é preciso corrigir manualmente. Executamos o Potrace local e conferimos o contrato da API hospedada na documentação. A tabela mostra o que observamos na saída local. Com o teste acima, você pode medir a qualidade do serviço hospedado usando as mesmas imagens no seu fluxo. ## Perguntas frequentes ### O Potrace consegue preservar uma paleta inteira em uma passada? Uma passada padrão separa o primeiro plano do fundo. Para trabalhar com cores, prepare uma máscara para cada cor e reúna os traçados, ou avalie um vetorizador que aceite cores com a mesma imagem. [Manual do Potrace](https://potrace.sourceforge.net/potrace.1.html) ### Uma chave de teste do PerfectVector mostra como meu logo vai ficar? Ela retorna o mesmo SVG de exemplo para imagens compatíveis. Use-a para verificar a requisição e o download. Uma conversão em produção vetoriza a imagem enviada. [Modo de teste do PerfectVector](https://perfectvector.com/docs/api/test-mode) ## Fontes 1. [Potrace — Manual](https://potrace.sourceforge.net/potrace.1.html) — Entradas da ferramenta padrão, limiar e saída em SVG. 2. [PerfectVector — Limites da API](https://perfectvector.com/docs/api/limits) — Arquivos aceitos e limite padrão de conversões simultâneas. 3. [PerfectVector — Resultados](https://perfectvector.com/docs/api/results) — Downloads de SVG e validade. 4. [PerfectVector — Créditos da API](https://perfectvector.com/docs/api/credits) — Conversões bem-sucedidas em produção e uso de créditos. 5. [PerfectVector — Modo de teste](https://perfectvector.com/docs/api/test-mode) — SVG fixo e diferença entre teste e produção. *** [Abra a API para desenvolvedores do PerfectVector](https://perfectvector.com/pt-BR/api) e experimente um arquivo seu com uma chave de teste. Quando o download do exemplo funcionar, faça uma conversão em produção e compare os vazados e as cores importantes com o resultado local. ## Explore - [Read the HTML article](https://perfectvector.com/pt-BR/blog/image-vectorization-api-vs-potrace) - [ImageMagick de PNG para SVG: confira o motor de traçado](https://perfectvector.com/pt-BR/blog/imagemagick-png-to-svg.md) - [VTracer de PNG para SVG: confira cores e pequenos detalhes](https://perfectvector.com/pt-BR/blog/vtracer-png-to-svg.md) - [Product facts](https://perfectvector.com/product-facts.md) - [FAQ](https://perfectvector.com/faq.md) - [Pricing and credits](https://perfectvector.com/pricing.md)