Unmarkr logoUnmarkr

API para remover marca d'água de IA: exemplos em curl, Python e Node.js

· 5 min de leitura

Se você ainda está decidindo se precisa de uma API, comece pela visão geral da remoção em lote (em inglês). Aqui é o código. A API da Unmarkr tem um endpoint e dois modos: standard tira os metadados e responde na hora, e full também tira o logo visível e o SynthID num job em segundo plano que você consulta.

O que você precisa

  • Uma chave de API, criada no seu painel. Ela começa com unmarkr_live_ e vai num cabeçalho Authorization: Bearer.
  • Créditos. Uma limpeza standard custa 1 crédito e uma remoção completa custa 4. Se uma remoção completa falhar, os créditos voltam automaticamente.
  • Arquivos PNG, JPG ou WebP de até 25 MB.

Tirar os metadados (modo standard)

É a chamada barata. Ela remove as Content Credentials C2PA, a tag “Made with AI” e os dados EXIF/XMP, não mexe nos pixels e devolve a imagem limpa no corpo da resposta.

curl -X POST https://unmarkr.io/api/remove \
  -H "Authorization: Bearer $UNMARKR_KEY" \
  -F image=@foto.png \
  -F mode=standard \
  -o foto-limpa.png

O cabeçalho X-Unmarkr-Removed da resposta lista o que saiu, ou diz none se o arquivo já estava limpo.

Tirar o SynthID também (modo full)

O modo full leva de 15 a 90 segundos, então a requisição não espera. Você recebe na hora um 202 com o id do job. Consulte /api/jobs/<id> até o status ficar done e baixe a imagem em /api/jobs/<id>/result. A mesma chave serve para as três chamadas.

Python

import os, time, requests

API = "https://unmarkr.io"
H = {"Authorization": "Bearer " + os.environ["UNMARKR_KEY"]}

with open("gemini.png", "rb") as f:
    r = requests.post(API + "/api/remove", headers=H,
                      files={"image": f}, data={"mode": "full"})
r.raise_for_status()
job = r.json()  # {"jobId", "status": "processing", "poll", "result"}

while True:
    s = requests.get(API + job["poll"], headers=H).json()
    if s["status"] == "done":
        break
    if s["status"] == "error":
        raise RuntimeError(s.get("error"))  # créditos devolvidos
    time.sleep(5)

out = requests.get(API + job["result"], headers=H)
with open("gemini-limpa.png", "wb") as f:
    f.write(out.content)

Node.js (18 ou mais recente)

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

const API = "https://unmarkr.io";
const headers = { Authorization: "Bearer " + process.env.UNMARKR_KEY };

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

const res = await fetch(API + "/api/remove", { method: "POST", headers, body: form });
const job = await res.json();

let status = "processing";
while (status === "processing") {
  await new Promise((r) => setTimeout(r, 5000));
  const s = await (await fetch(API + job.poll, { headers })).json();
  status = s.status;
  if (status === "error") throw new Error(s.error); // créditos devolvidos
}

const out = await fetch(API + job.result, { headers });
await writeFile("gemini-limpa.png", Buffer.from(await out.arrayBuffer()));

Os erros que você vai ver de verdade

  • 401: chave ausente, digitada errado ou revogada.
  • 402: créditos insuficientes. O modo full precisa de 4.
  • 413: o arquivo passa de 25 MB.
  • 429: você passou do limite de requisições da chave. Espere os segundos indicados em Retry-After. O cabeçalho RateLimit de cada resposta mostra quanto falta.

Todos os campos estão na documentação da API (em inglês), e existe uma especificação OpenAPI se você preferir gerar um cliente. Envie só imagens que são suas ou que você tem direito de editar.

Teste uma imagem no navegador primeiro

Solte uma imagem na Unmarkr para ver o que ela carrega antes de ligar a API. A verificação é grátis.

Verificar uma imagem — grátis