Images API
API REST pública para converter e otimizar imagens. Aceita imagens rasterizadas e SVG e gera PNG, JPG, WebP e AVIF — formatos modernos que o Google adora.
Uma API REST pública e gratuita para converter e otimizar imagens rasterizadas e vetoriais. Envio de um arquivo, processamento rápido e, como resposta, uma URL de download.
# Convert SVG to WebP
curl -X POST https://jinero.online/api/v1/images/convert \
-F "[email protected]" \
-F "format=webp" \
-F "preset=balanced"const form = new FormData();
form.append("image", file);
form.append("format", "webp");
form.append("preset", "balanced");
const r = await fetch("https://jinero.online/api/v1/images/convert", { method: "POST", body: form });
const { download_url, new_size } = await r.json();
console.log(download_url);Todos os endpoints são públicos — sem chave. Conversão e otimização exigem muito da CPU, por isso têm limites mais rígidos que os da Fonts API. Os limites abaixo são por IP.
# Anonymous limits (per IP):
# POST /convert 5 req/min
# POST /optimize 5 req/min
# GET /download/* 10 req/min
# GET /formats 60 req/min
# All responses include:
# X-RateLimit-Limit: 5
# X-RateLimit-Remaining: N
# Retry-After: seconds (on 429)Envie uma imagem e receba-a em outro formato. Ideal para migrar para formatos modernos (WebP, AVIF) na web.
https://jinero.online/api/v1/images/convert
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Arquivo de entrada. Aceita jpg, jpeg, png, gif, bmp, webp, avif, heic, svg. Até 10 MB. |
format |
string | Formato de saída: png, jpeg, webp ou avif. |
preset |
string | Predefinição de qualidade: light, balanced (padrão) ou strong. |
curl -X POST https://jinero.online/api/v1/images/convert \
-F "[email protected]" \
-F "format=webp" \
-F "preset=balanced"// Browser FormData example
const fileInput = document.getElementById("file");
const form = new FormData();
form.append("image", fileInput.files[0]);
form.append("format", "webp");
form.append("preset", "balanced");
const res = await fetch("https://jinero.online/api/v1/images/convert", {
method: "POST",
body: form,
});
const data = await res.json();
window.location = data.download_url;$response = Http::attach(
"image",
file_get_contents("photo.png"),
"photo.png"
)->post("https://jinero.online/api/v1/images/convert", [
"format" => "webp",
"preset" => "balanced",
]);
$result = $response->json();
$webpUrl = $result["download_url"];{
"success": true,
"session_id": "1d2e3f...",
"original_name": "photo.png",
"original_format": "png",
"output_format": "webp",
"original_size": 1024512,
"new_size": 156320,
"savings_percent": 84.7,
"dimensions": "1920x1080",
"preset": "balanced",
"download_url": "https://jinero.online/api/v1/images/download/1d2e3f...",
"expires_in_minutes": 60
}Comprime sem mudar o formato. Útil para reduzir arquivos PNG/JPG que já estão no formato certo, mas grandes demais.
https://jinero.online/api/v1/images/optimize
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Imagem rasterizada (PNG, JPG, GIF, BMP, WebP, AVIF, HEIC). SVG não é aceito aqui — rasterize antes com /convert. |
preset |
string | light = quase sem perdas, balanced = recomendado, strong = compressão máxima. |
curl -X POST https://jinero.online/api/v1/images/optimize \
-F "[email protected]" \
-F "preset=strong"const form = new FormData();
form.append("image", file);
form.append("preset", "balanced");
const r = await fetch("https://jinero.online/api/v1/images/optimize", { method: "POST", body: form });
const { new_size, savings_percent } = await r.json();
console.log(`Saved ${savings_percent}%`);$res = Http::attach("image", file_get_contents("big.jpg"), "big.jpg")
->post("https://jinero.online/api/v1/images/optimize", ["preset" => "strong"]);
$data = $res->json();{
"success": true,
"session_id": "...",
"original_format": "jpeg",
"output_format": "jpeg",
"original_size": 2354821,
"new_size": 612491,
"savings_percent": 74.0,
"download_url": "https://jinero.online/api/v1/images/download/..."
}Converte imagens rasterizadas em SVG limpo com o VTracer. Ideal para logotipos, ícones e ilustrações chapadas. Retorna o código SVG puro e também um ZIP.
https://jinero.online/api/v1/images/vectorize
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Imagem rasterizada (jpg, jpeg, png, gif, bmp, webp). Até 10 MB. |
preset |
string | logo (padrão) · illustration · photo · sketch. Define a quantização de cores e a simplificação dos paths. |
curl -X POST https://jinero.online/api/v1/images/vectorize \
-F "[email protected]" \
-F "preset=logo"
# Then fetch the SVG:
curl https://jinero.online/api/v1/images/vectorize/svg/SESSION_ID > out.svgconst form = new FormData();
form.append("image", file);
form.append("preset", "logo");
const r = await fetch("https://jinero.online/api/v1/images/vectorize", { method: "POST", body: form });
const { svg_url } = await r.json();
const svg = await fetch(svg_url).then(x => x.text());{
"success": true,
"session_id": "...",
"output_format": "svg",
"preset": "logo",
"dimensions": "1024x1024",
"svg_url": "https://jinero.online/api/v1/images/vectorize/svg/...",
"download_url": "https://jinero.online/api/v1/images/vectorize/download/..."
}Remoção de fundo com IA (família rembg / u2net). Retorna um PNG com fundo transparente. Entrada de até 5 MB, para manter a latência razoável.
https://jinero.online/api/v1/images/remove-background
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Imagem rasterizada. Até 5 MB. |
preset |
string | standard (padrão, rápido) · portrait (melhores bordas de cabelo) · quality · ultra (mais lento, melhor resultado). |
curl -X POST https://jinero.online/api/v1/images/remove-background \
-F "[email protected]" \
-F "preset=quality"const form = new FormData();
form.append("image", file);
form.append("preset", "portrait");
const r = await fetch("https://jinero.online/api/v1/images/remove-background", { method: "POST", body: form });
const { download_url } = await r.json();{
"success": true,
"session_id": "...",
"output_format": "png",
"preset": "quality",
"dimensions": "1920x1080",
"download_url": "https://jinero.online/api/v1/images/remove-background/download/..."
}Ampliação 2× com IA via Real-ESRGAN. Só o 2× está disponível publicamente — escalas maiores (4×) e outros modos (restauração de rostos, remoção de ruído, auto) por enquanto ficam só na interface web, por causa do custo de GPU.
https://jinero.online/api/v1/images/upscale
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Imagem rasterizada. Até 15 MB. Formatos: jpg, jpeg, png, webp, bmp. |
scale |
integer | No momento, só "2" é suportado. Os outros modos (face, denoise, auto) estão temporariamente disponíveis apenas na interface web. |
curl -X POST https://jinero.online/api/v1/images/upscale \
-F "[email protected]" \
-F "scale=2"const form = new FormData();
form.append("image", file);
form.append("scale", "2");
const r = await fetch("https://jinero.online/api/v1/images/upscale", { method: "POST", body: form });
const { download_url, dimensions } = await r.json();{
"success": true,
"session_id": "...",
"mode": "upscale",
"scale": 2,
"output_format": "png",
"dimensions": "3840x2160",
"download_url": "https://jinero.online/api/v1/images/upscale/download/..."
}Obtenha o resultado binário. As sessões ficam válidas por 60 minutos após a criação; depois disso, o arquivo é apagado. Cada endpoint de IA tem o seu próprio caminho de download (veja os exemplos de resposta).
https://jinero.online/api/v1/images/download/{session_id}
curl -L -o output.webp https://jinero.online/api/v1/images/download/1d2e3f...// Trigger browser download
window.location.href = data.download_url;Descubra os formatos de saída, as predefinições e os limites disponíveis em tempo de execução — útil para interfaces dinâmicas que reconhecem novos formatos automaticamente.
https://jinero.online/api/v1/images/formats
curl https://jinero.online/api/v1/images/formatsconst r = await fetch("https://jinero.online/api/v1/images/formats");
const { output_formats, presets } = await r.json();{
"output_formats": [
{"key": "png", "name": "PNG", "extension": ".png", "supports_alpha": true},
{"key": "jpeg", "name": "JPEG", "extension": ".jpg", "supports_alpha": false},
{"key": "webp", "name": "WebP", "extension": ".webp", "supports_alpha": true},
{"key": "avif", "name": "AVIF", "extension": ".avif", "supports_alpha": true}
],
"presets": [
{"key": "light", "name": "Light", "description": "Near lossless, minimal compression"},
{"key": "balanced", "name": "Balanced", "description": "Best quality/size ratio"},
{"key": "strong", "name": "Strong", "description": "Maximum compression, smaller files"}
],
"supported_inputs": ["jpg","jpeg","png","gif","bmp","webp","avif","heic","svg"],
"max_file_size_bytes": 10485760,
"max_file_size_mb": 10,
"session_ttl_minutes": 60
}Semântica HTTP padrão. Os erros retornam JSON com o campo "message".
// 422 — validation (invalid format / unsupported file)
{ "message": "The image field must be a file of type: jpg, jpeg, png..." }
// 404 — download session not found or expired
{ "message": "Conversion result not found or expired" }
// 429 — rate limit exceeded
{ "message": "Too Many Attempts." }
// 500 — conversion failed (rare; details in error)
{ "message": "Failed to rasterize SVG. Make sure the file is valid." }Sobre a Images API do jinero.online
API REST pública para converter e otimizar imagens — converta SVG, JPG, PNG e HEIC em WebP ou AVIF modernos e comprima sem perder qualidade, de graça.
Formatos modernos
Saída em PNG, JPG, WebP ou AVIF. Converta as imagens hero antigas em PNG/JPG para WebP e veja as métricas de LCP melhorarem.
SVG → raster
A rasterização de SVG no servidor, com o rsvg-convert, processa arquivos vetoriais com precisão — até SVGs com muitos filtros.
Sem chave
Endpoint público, 5 req/min por IP para conversões. Gere um token de API quando precisar de limites maiores.
Contrato JSON simples
Envie via multipart e receba uma URL de download válida por 60 minutos. Sem assinaturas, callbacks ou SDKs.
Perguntas frequentes
Não. A API é pública e tem limite de uso por IP. /convert e /optimize são limitados a 5 requisições por minuto; os endpoints de download e de metadados têm limites maiores.
JPG, JPEG, PNG, GIF, BMP, WebP, AVIF, HEIC e SVG. Os SVGs são rasterizados no servidor com o rsvg-convert antes da codificação. Tamanho máximo do arquivo: 10 MB.
PNG, JPEG, WebP e AVIF. O WebP tem a melhor relação entre tamanho e qualidade para a web; o AVIF é ainda menor, mas demora mais para decodificar. O PNG mantém a transparência; o JPEG, não.
Os originais são processados e descartados imediatamente. Os resultados convertidos ficam em um armazenamento temporário por 60 minutos (tempo suficiente para acessar a download_url) e depois são excluídos. Não treinamos nenhum modelo com os seus arquivos.
Esses serviços são especializados em uma tarefa (remoção de fundo ou compressão de PNG). A nossa API foca em conversão de formatos e compressão com ou sem perdas, com uma interface única e consistente, e é totalmente gratuita, sem cobrança por imagem nem paywall.