API do PerfectVectorBeta

De imagem a SVG, em uma chamada de API

Envie uma imagem PNG, JPEG ou WebP e receba um SVG limpo e editável, a partir do seu servidor, script ou ferramenta de automação.

Adicione a conversão de imagem para SVG ao seu produto ou às suas ferramentas internas
Converta logotipos, ícones e ilustrações nos seus próprios pipelines
Pague só pelas conversões que dão certo

Pegue uma chave de teste grátis Leia o guia de início rápido

A partir de US$ 0,08 por SVG · chaves de teste grátis

Conversão em produção concluída
→ POST /v1/vectorizations · Idempotency-Key: logo-0001← 201 · "status": "succeeded"X-Credits-Charged: 1
Conversão com falha
→ POST /v1/vectorizations · Idempotency-Key: logo-0002← "status": "failed"X-Credits-Charged: 0
Mesma solicitação repetida
→ POST /v1/vectorizations · Idempotency-Key: logo-0001← Idempotent-Replayed: trueX-Credits-Charged: 0
Chave de teste, mesma solicitação
→ POST /v1/vectorizations · Bearer pv_test_…← 201 · test keyX-Credits-Would-Charge: 1

Por que equipes escolhem a API do PerfectVector

Cobrança só quando dá certo: Um crédito de API por SVG entregue. Conversões com falha ou que excedem o tempo limite, consultas de status e downloads repetidos não custam nada.
Modo de teste grátis que funciona como o de produção: As chaves de teste usam as mesmas verificações, limites e respostas das chaves de produção e devolvem um SVG de exemplo, para você concluir a integração antes de pagar.
Repita solicitações com segurança: Envie um Idempotency-Key e, ao repetir a solicitação, você recebe a mesma conversão, sem executá-la nem pagar duas vezes.

Casos de uso

O que você pode criar com a API do PerfectVector

Crie um novo serviço com ela, adicione ao produto que você já oferece ou integre aos seus pipelines.

Lance um novo serviço
Venda produtos feitos com as imagens dos seus clientes.
- Adesivos personalizados e arquivos de corte
- Pedidos de gravação personalizada
- Ferramentas de processamento em lote para lojistas
order.png → API → product.svg
Adicione ao seu produto
Ofereça um botão de vetorização aos seus usuários sem precisar desenvolver o motor.
- Editores de design e modelos
- Impressão sob demanda e produtos personalizados
- Softwares para máquinas de corte e comunicação visual
upload.png → API → editable.svg
Automatize seu pipeline
Converta os arquivos assim que chegarem, sem ninguém precisar clicar.
- Bibliotecas de arquivos de marca
- Trabalhos acumulados em agências e estúdios
- Ferramentas de automação sem código
inbox/*.png → API → library/*.svg

Seu agente de programação pode criar a integração com a referência da API para agentes, que cabe em uma página. Abrir a referência para agentes

Ver preços da API

Recursos da API

Tudo para colocar a conversão de imagem para SVG em produção.

Início rápido

Da chave ao primeiro SVG em minutos

Crie uma chave de teste
Entre na sua conta, abra a página API para desenvolvedores e crie uma chave no modo de teste. É grátis.
Envie uma imagem
Envie a imagem por POST como dados de formulário multipart. Solicite image/svg+xml e receba o SVG na mesma chamada.
Troque por uma chave de produção
Compre um pacote de créditos, troque pela chave de produção e comece a converter imagens reais. Todo o resto continua igual.

curl https://api.perfectvector.com/v1/vectorizations \
  -H "Authorization: Bearer $PERFECTVECTOR_API_KEY" \
  -H "Idempotency-Key: logo-0001" \
  -H "Accept: image/svg+xml" \
  -F image=@logo.png \
  -o logo.svg

import os
import requests

with open("logo.png", "rb") as image:
    response = requests.post(
        "https://api.perfectvector.com/v1/vectorizations",
        headers={
            "Authorization": f"Bearer {os.environ['PERFECTVECTOR_API_KEY']}",
            "Idempotency-Key": "logo-0001",
            "Accept": "image/svg+xml",
        },
        files={"image": ("logo.png", image)},
        timeout=130,
    )

if response.headers["Content-Type"].startswith("image/svg+xml"):
    with open("logo.svg", "wb") as file:
        file.write(response.content)

import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image", new Blob([await readFile("logo.png")]), "logo.png");

const response = await fetch("https://api.perfectvector.com/v1/vectorizations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PERFECTVECTOR_API_KEY}`,
    "Idempotency-Key": "logo-0001",
    Accept: "image/svg+xml",
  },
  body: form,
  signal: AbortSignal.timeout(130_000),
});

if (response.headers.get("content-type")?.startsWith("image/svg+xml")) {
  await writeFile("logo.svg", Buffer.from(await response.arrayBuffer()));
}

O guia de início rápido traz exemplos completos com consultas periódicas de status e tratamento de erros.

Preços

Pacotes de créditos, sem assinatura

Compre uma vez e use por 12 meses. Um crédito de API equivale a um SVG gerado com sucesso.

Starter
10 créditos de API
~~Preço normal US$ 5, preço beta US$ 4~~
US$ 0,40 por SVG
Bulk 100
100 créditos de API
~~Preço normal US$ 20, preço beta US$ 16~~
US$ 0,16 por SVG
Bulk 1.000
1.000 créditos de API
~~Preço normal US$ 100, preço beta US$ 80~~
US$ 0,08 por SVG

Preço beta, 20% de desconto

Ver preços da API

Precisa de 10.000 créditos de API ou mais? Fale com vendas

Perguntas sobre a API

A API do PerfectVector já está disponível?

Sim. Ela está em beta pública, aberta a todos desde 3 de novembro de 2026. Crie uma chave de teste grátis para começar sua integração hoje.

Quais imagens posso converter?

Imagens PNG, JPEG e WebP de até 5 MiB, com cada lado entre 100 e 4.096 pixels. Logotipos, ícones e ilustrações com formas bem definidas geram os SVGs mais limpos. Cada solicitação converte uma imagem com as configurações padrão.

Como funcionam os preços?

Uma conversão em produção usa um crédito de API quando dá certo. Você compra créditos em pacotes avulsos, sem assinatura nem recarga automática. Conversões com falha, consultas de status e downloads repetidos são grátis.

Posso testar antes de pagar?

Sim. As chaves de teste são grátis, executam a solicitação inteira, incluindo verificações da chave, do arquivo e dos limites de solicitações, e devolvem um SVG de exemplo. Quando sua integração estiver funcionando, troque por uma chave de produção.

Os créditos de API são os mesmos créditos do site?

Não. Os créditos de API são separados dos créditos que você usa no site e nos assistentes de IA, e nunca se convertem uns nos outros. Os planos do site não incluem créditos de API.

O que acontece com as imagens que envio?

Suas imagens e seus SVGs ficam disponíveis por 24 horas e são excluídos do armazenamento em até 48 horas. Você pode excluir uma conversão imediatamente pela API. Suas imagens nunca são usadas para treinar modelos de IA nem vendidas.

Devo usar a API ou o PerfectVector MCP?

Use a API quando seu próprio software converter imagens, com uma chave de API. Use o PerfectVector MCP quando quiser converter imagens pedindo ao ChatGPT, Claude ou outro assistente compatível, sem código.

Comece com uma chave de teste grátis

Sem custo até sua integração funcionar. Depois, um crédito por SVG que você receber.

Pegue uma chave de teste grátis Leia a documentação da API

Prefere pedir a um assistente de IA? Experimente o PerfectVector MCP

De imagem a SVG, em uma chamada de API

Por que equipes escolhem a API do PerfectVector

O que você pode criar com a API do PerfectVector

Lance um novo serviço

Adicione ao seu produto

Automatize seu pipeline

Recursos da API

Converta

Aguarde ou consulte o status

Resultados

Idempotência

Modo de teste

Erros e limites

Da chave ao primeiro SVG em minutos

Crie uma chave de teste

Envie uma imagem

Troque por uma chave de produção

Pacotes de créditos, sem assinatura

Perguntas sobre a API

Comece com uma chave de teste grátis