Favicon API
Transforme uma única imagem em um pacote completo de favicons — todos os tamanhos, todas as plataformas, um trecho HTML pronto e um ZIP para publicar — com uma requisição POST.
Envie uma imagem e receba um pacote completo de favicons: todos os tamanhos que os navegadores modernos pedem, além de um site.webmanifest, o trecho HTML pronto para colar no <head> e a URL de download do ZIP.
# Generate a favicon package
curl -X POST https://jinero.online/api/v1/favicon/generate \
-F "[email protected]" \
-F "app_name=My App" \
-F "theme_color=#0ea5e9"const form = new FormData();
form.append("image", file);
form.append("app_name", "My App");
form.append("theme_color", "#0ea5e9");
const r = await fetch("https://jinero.online/api/v1/favicon/generate", { method: "POST", body: form });
const { download_url, html_snippet } = await r.json();Todos os endpoints são públicos — sem chave. A geração de favicons executa ferramentas Node (sharp) para cada tamanho solicitado, por isso o limite é rígido.
# Anonymous limits (per IP):
# POST /favicon/generate 3 req/min
# GET /favicon/download/{id} 10 req/min
# Max source image: 10 MB
# Session TTL after generation: 60 minutesEnvie a imagem de origem e as opções de cada plataforma. Retorna um ID de sessão, miniaturas de prévia, um trecho HTML e a URL de download do ZIP. Os favicons da Apple, do Android e os padrão são gerados por padrão; Windows e Yandex são opcionais.
https://jinero.online/api/v1/favicon/generate
| Parâmetro | Tipo | Descrição |
|---|---|---|
image |
arquivo (multipart) | Imagem de origem — png, jpg, jpeg, svg ou webp. Até 10 MB. Imagens quadradas dão os melhores resultados. |
app_name |
string | Nome do aplicativo gravado no site.webmanifest. Até 100 caracteres. |
theme_color |
string | Cor CSS (hex ou rgb) usada na barra de endereço / metatag theme-color. |
background |
string | Cor de fundo usada nos blocos PNG opacos, onde não há suporte a transparência. |
display |
string | Modo de exibição no manifesto: standalone (padrão), browser, fullscreen ou minimal-ui. |
orientation |
string | Orientação no manifesto: any (padrão), portrait ou landscape. |
apple_icon |
boolean | Gerar apple-touch-icon-*.png. Padrão: true. |
android |
boolean | Gerar android-chrome-*.png. Padrão: true. |
windows |
boolean | Gerar mstile-*.png + browserconfig.xml. Padrão: false. |
yandex |
boolean | Gerar yandex-browser-50x50.png + yandex-browser-manifest.json. Padrão: false. |
curl -X POST https://jinero.online/api/v1/favicon/generate \
-F "[email protected]" \
-F "app_name=Jinero" \
-F "theme_color=#0ea5e9" \
-F "background=#ffffff" \
-F "apple_icon=true" \
-F "android=true" \
-F "windows=true"const form = new FormData();
form.append("image", logoFile);
form.append("app_name", "Jinero");
form.append("theme_color", "#0ea5e9");
form.append("background", "#ffffff");
form.append("apple_icon", "true");
form.append("android", "true");
const r = await fetch("https://jinero.online/api/v1/favicon/generate", { method: "POST", body: form });
const data = await r.json();
document.querySelector("head").insertAdjacentHTML("beforeend", data.html_snippet);
window.location = data.download_url;$response = Http::attach(
"image",
file_get_contents("logo.png"),
"logo.png"
)->post("https://jinero.online/api/v1/favicon/generate", [
"app_name" => "Jinero",
"theme_color" => "#0ea5e9",
"apple_icon" => true,
"android" => true,
]);
$package = $response->json();{
"success": true,
"session_id": "8c1f2e7a-4b5d-4dca-9c3e-1d6f7a0b2c5e",
"file_count": 27,
"html_snippet": "<link rel=\"icon\" type=\"image/x-icon\" href=\"/favicon.ico\">\n<link rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicon-32x32.png\">\n<link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"/apple-touch-icon.png\">\n<link rel=\"manifest\" href=\"/site.webmanifest\">\n<meta name=\"theme-color\" content=\"#0ea5e9\">",
"preview": [
{"label": "favicon-16x16", "url": "..."},
{"label": "favicon-32x32", "url": "..."},
{"label": "apple-touch-icon", "url": "..."},
{"label": "android-chrome-192", "url": "..."}
],
"download_url": "https://jinero.online/api/v1/favicon/download/8c1f2e7a-…",
"expires_in_minutes": 60
}Envia o favicon-package.zip gerado. As sessões ficam válidas por 60 minutos; depois disso, o arquivo é apagado do armazenamento temporário.
https://jinero.online/api/v1/favicon/download/{session}
curl -L -o favicon-package.zip https://jinero.online/api/v1/favicon/download/8c1f2e7a-…// Trigger a browser download
window.location.href = data.download_url;Um pacote típico com as opções padrão (apple + android ativados, windows + yandex desativados) tem 16–18 arquivos; com tudo ativado, ~27.
favicon.ico # classic multi-resolution ICO
favicon-16x16.png # browser tabs
favicon-32x32.png # browser tabs (retina)
favicon-48x48.png # taskbar
favicon-96x96.png # Chrome desktop shortcut
favicon-192x192.png # PWA / android
favicon-512x512.png # PWA splash
apple-touch-icon.png # iOS home screen (180×180)
apple-touch-icon-152x152.png # iPad
apple-touch-icon-120x120.png # iPhone retina
apple-touch-icon-precomposed.png
android-chrome-192x192.png
android-chrome-512x512.png
android-chrome-maskable-512x512.png
mstile-150x150.png # Windows Start tile (windows=true)
browserconfig.xml # Windows config (windows=true)
yandex-browser-50x50.png # Yandex.Browser (yandex=true)
yandex-browser-manifest.json # Yandex meta (yandex=true)
site.webmanifest # PWA manifest
snippet.html # paste-into-<head> markupSemântica HTTP padrão. Os erros retornam JSON com o campo "message", que descreve a falha.
// 400 — malformed session id on /download
{ "message": "Invalid session id" }
// 404 — session expired or unknown
{ "message": "Result not found or expired" }
// 422 — validation (unsupported file type, oversize image, invalid color)
{ "message": "The image field must be a file of type: png, jpg, jpeg, svg, webp." }
// 429 — rate limit exceeded (/generate = 3 req/min)
{ "message": "Too Many Attempts." }
// 422 — generator crashed (rare; original error is forwarded)
{ "message": "Failed to load source image (corrupt input?)" }Sobre a Favicon API do jinero.online
API REST gratuita que transforma uma única imagem em um pacote de favicons pronto para publicar — todos os tamanhos de ícone, o manifesto PWA e um trecho HTML pronto, em uma só chamada.
Uma imagem entra, o kit completo sai
Envie PNG/JPG/SVG/WebP e receba todos os tamanhos que os navegadores pedem — o clássico favicon.ico, Apple Touch, Android Chrome, PWA, blocos do Windows, Yandex.
Trecho HTML pronto
A resposta inclui exatamente as tags <link> e <meta>, prontas para colar no <head> do documento — sem adivinhação.
Manifesto pronto para PWA
O site.webmanifest é gerado com o nome do seu aplicativo, a cor do tema, o fundo, o modo de exibição e a orientação — a instalação como aplicativo funciona desde o primeiro dia.
Sem chave
Endpoint público, 3 gerações/minuto por IP. Para limites maiores, gere um token de API.
Perguntas frequentes
Não. A Favicon API é pública. /generate é limitado a 3 requisições/minuto por IP, porque cada chamada executa o sharp para cada tamanho solicitado. Se precisar de mais, crie uma conta e gere um token de API.
Um PNG ou SVG quadrado de 512×512 ou maior dá os melhores resultados em todos os tamanhos. Qualquer coisa menor que 192×192 vai ficar borrada na tela inicial do Android. Aceitamos png, jpg, jpeg, svg e webp de até 10 MB.
Favicon clássico (ico + 6 tamanhos de PNG), Apple Touch Icon (180/152/120 + precomposed) e Android Chrome (192/512 + maskable). Os blocos do Windows e os ícones do Yandex.Browser são opcionais, ativados com windows=true e yandex=true — a maioria das stacks modernas não precisa deles.
60 minutos a partir da geração. Depois disso, o ZIP e as prévias são excluídos do armazenamento temporário. Se precisar do pacote mais tarde, gere-o de novo.
O trecho retornado em html_snippet é propositalmente mínimo — só as tags que os navegadores modernos consultam. Se o seu CMS precisar de metatags extras (ícones Open Graph etc.), adicione-as você mesmo; os caminhos dos ícones no ZIP correspondem aos do trecho.