> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# Como vetorizar imagens no Make com um cenário HTTP

> Envie uma imagem do Google Drive pelo Make a uma API de vetorização. Mapeie os dados, trate respostas pendentes ou com erro e salve o SVG em outra pasta.

Source: https://perfectvector.com/pt-BR/blog/make-com-vectorize-image-automation

Language: pt-BR
Author: Jay
Published: 2026-11-13T08:00:00+09:00

Este guia mostra como mapear os campos do arquivo e da resposta em um cenário HTTP v4 do Make que lê uma imagem do Google Drive. Ele cobre a requisição, o ID de conversão e o SVG. Verificamos a troca com a API usando uma chave de teste. O mapeamento dos campos do Make e do Drive segue a documentação oficial dos módulos.

## Comece com um arquivo e uma chave de teste

Conecte o Google Drive ao Make. Coloque um PNG, JPEG ou WebP de quadro único em uma pasta de teste, escolha uma pasta separada para a saída e obtenha uma [chave de teste do PerfectVector](https://perfectvector.com/account/developers). Escolha um arquivo de até 5 MiB com 100 a 4096 pixels de cada lado. Uma conversão de teste bem-sucedida retorna um SVG fixo de exemplo. [Modo de teste do PerfectVector](https://perfectvector.com/docs/api/test-mode)

Adicione **Google Drive → Download a File** e escolha a origem pelo ID. Se adicionar um gatilho de pasta depois, mapeie o ID desse gatilho para o módulo. Na primeira execução, use um arquivo conhecido para inspecionar o nome e os dados na saída do módulo. [Guia do Make sobre arquivos](https://help.make.com/working-with-files)

## Mapeie o arquivo na requisição HTTP

Use **HTTP → Make a request** no aplicativo HTTP v4 do Make. Guarde a chave de teste em **Credentials** com autenticação **API key**. No chaveiro, informe em **Key** o valor completo começando com `Bearer `, escolha a opção de envio no cabeçalho, defina o nome do parâmetro como `Authorization` e restrinja o uso à origem `https://api.perfectvector.com`. Use o mesmo chaveiro para o download. [Configurar chave de API no Make](https://apps.make.com/api-key-authentication-type)

Use `https://api.perfectvector.com` como origem de cada endpoint abaixo.

| Configuração do HTTP v4   | Valor na primeira execução                                                                         |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| URL e método              | `POST /v1/vectorizations`                                                                          |
| Tipo de conteúdo do corpo | `multipart/form-data`                                                                              |
| Campo do corpo            | Tipo **File**, nome `image`. Mapeie o nome do arquivo e os dados de **Download a File**.           |
| Cabeçalho                 | `Idempotency-Key`: escolha um valor estável para a operação, como `drive-logo-test-0001`.          |
| Cabeçalho                 | `Prefer: wait=10`                                                                                  |
| Parse response            | **Yes**. Execute uma vez para obter campos de saída que possam ser mapeados, como `id` e `status`. |
| Tempo limite              | 30 segundos para esta requisição.                                                                  |

O Make cria o separador multipart quando você escolhe o tipo do corpo. Mantenha a resposta do POST em JSON. Assim, você usa o mesmo formato tanto se a conversão terminar na hora quanto se precisar de mais tempo. Os dois segundos indicados pelo PerfectVector são o intervalo entre consultas de status. [Módulos HTTP do Make](https://apps.make.com/http) · [Espera e requisições assíncronas no PerfectVector](https://perfectvector.com/docs/api/waiting-and-async)

**Diagrama do fluxo**

![Uma imagem sai da pasta de origem, passa pela requisição HTTP e pelo registro de conversão e chega como arquivo vetorial à pasta de destino.](https://perfectvector.com/blog/make-com-vectorize-image-automation/workflow.webp)

*Mapeie os dados da imagem na requisição. Use o ID de conversão para consultar o status e baixar o SVG para a pasta de saída.*

## Baixe após a conversão terminar com sucesso

Filtre a rota antes de **HTTP → Download a file** para executá-la só quando o status for `succeeded`. Use a mesma origem da API e o caminho `/v1/vectorizations/{id}/result`. Substitua `{id}` pelo ID de conversão mapeado. Use o chaveiro da API e selecione **Yes** em **Return error if HTTP request fails**. O módulo de download fornece os dados ao próximo módulo. [Módulos HTTP do Make](https://apps.make.com/http) · [Resultados do PerfectVector](https://perfectvector.com/docs/api/results)

Adicione **Google Drive → Upload a File** e escolha a pasta de saída. Selecione o arquivo de **HTTP → Download a file** como origem. Para alterar o nome, escolha **Map** no campo de arquivo, mantenha os dados baixados e indique um nome como `logo-test.svg`. Deixe **Convert a File** desativado para preservar o formato SVG. [Módulos do Google Drive no Make](https://apps.make.com/google-drive-modules) Abra o arquivo enviado e procure a marca “TEST MODE”. Assim você confere o mapeamento em todo o cenário.

| Resposta ao POST                 | Rota ou recuperação                                                                                                                                                                                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `201` e `succeeded`              | Baixe o SVG e envie os dados do arquivo ao Drive.                                                                                                                                                                                                                     |
| `202` e `queued` ou `processing` | Salve o ID para consultar o status. Mantenha o filtro de download fechado.                                                                                                                                                                                            |
| `201` e `failed`                 | Registre o ID e o erro. Interrompa essa rota antes do download.                                                                                                                                                                                                       |
| `4xx` ou `5xx`                   | Confira o erro do módulo e o código de erro da API, quando houver. Para `429` ou `503`, respeite `Retry-After` quando informado e use a mesma chave e os mesmos dados dentro do prazo de repetição. Se uma conversão em produção estiver em andamento, aguarde o fim. |

## Confira uma conversão pendente antes do download

A execução única cobre um arquivo de teste. Se um envio em produção retornar `202`, consulte-o com outro módulo **HTTP → Make a request** usando **GET**, o mesmo chaveiro e **Yes** em **Parse response**. Use a mesma origem da API e o caminho `/v1/vectorizations/{id}`. Mapeie o ID salvo no caminho. Encaminhe `succeeded` para o download, deixe `queued` e `processing` pendentes e registre o ID e o erro para `failed`. Espere cerca de dois segundos antes de consultar um ID pendente de novo. [Espera e requisições assíncronas no PerfectVector](https://perfectvector.com/docs/api/waiting-and-async)

Quando o cliente atinge o tempo limite, o envio pode continuar em execução. Use o ID salvo. Se não houver ID, repita a requisição com a mesma chave e os mesmos dados em até 24 horas. Uma conversão com estado final `failed` e erro `timeout` ou `provider_unavailable` exige outra chave para tentar novamente. No último caso, aguarde a volta do serviço. Guarde a chave com a versão do arquivo antes de agendar execuções automáticas e registre os IDs pendentes para que a próxima execução consulte o status antes de reenviar. [Repetições seguras no PerfectVector](https://perfectvector.com/docs/api/idempotency) · [Erros da API do PerfectVector](https://perfectvector.com/docs/api/errors)

Usamos cURL com uma chave de teste do PerfectVector para enviar o multipart, consultar a conversão pelo ID e baixar o SVG fixo. As etapas do Make e do Google Drive seguem a documentação oficial do Make para módulos e mapeamento de arquivos. Execute uma vez no seu espaço de trabalho para conferir os campos.

## Perguntas frequentes

### Por que meu cenário retorna um erro de tipo de mídia incompatível?

Confira o tipo de conteúdo do corpo e o mapeamento do arquivo. Selecione `multipart/form-data`, dê ao campo o nome `image` e mapeie os dados da saída do módulo de download. Abra o original para confirmar que é um PNG, JPEG ou WebP compatível. [Limites da API do PerfectVector](https://perfectvector.com/docs/api/limits)

### O que o SVG de teste mostra sobre a minha arte?

Ele verifica a requisição e a transferência do arquivo. O PerfectVector retorna um exemplo fixo com uma chave de teste. Para avaliar sua imagem, converta em produção e examine as formas e cores obtidas. [Modo de teste do PerfectVector](https://perfectvector.com/docs/api/test-mode)

## Fontes

1. [Make — Trabalhar com arquivos](https://help.make.com/working-with-files) — Mapeamento de nome e dados no download e no upload do Google Drive.
2. [Make — HTTP](https://apps.make.com/http) — Upload multipart, leitura de JSON e download de arquivos no HTTP v4.
3. [Make — Autenticação por chave de API](https://apps.make.com/api-key-authentication-type) — Armazenamento de credenciais Bearer e restrição à origem.
4. [PerfectVector — Limites](https://perfectvector.com/docs/api/limits) — Formatos compatíveis e campos multipart.
5. [PerfectVector — Espera e requisições assíncronas](https://perfectvector.com/docs/api/waiting-and-async) — Cabeçalho de espera e respostas imediatas ou pendentes.
6. [PerfectVector — Resultados](https://perfectvector.com/docs/api/results) — Download autenticado do SVG.
7. [PerfectVector — Modo de teste](https://perfectvector.com/docs/api/test-mode) — SVG fixo de teste e conclusão imediata esperada.
8. [Make — Módulos do Google Drive](https://apps.make.com/google-drive-modules) — Campos de download e upload e opção de conversão de arquivo.

***

[Obtenha uma chave de teste na página da API do PerfectVector](https://perfectvector.com/pt-BR/api) e use o exemplo de resposta JSON do [guia de início rápido](https://perfectvector.com/docs/api/quickstart) com uma imagem compatível. Confirme que o upload retorna um ID e que o SVG baixado abre.

## Explore

- [Read the HTML article](https://perfectvector.com/pt-BR/blog/make-com-vectorize-image-automation)
- [Melhores vetorizadores com IA em 2026: escolhas por uso](https://perfectvector.com/pt-BR/blog/best-ai-vectorizers-2026.md)
- [Como converter uma pasta em SVGs com o Claude Code](https://perfectvector.com/pt-BR/blog/batch-vectorize-images-claude-code-mcp.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
