API CleverUtils
Uma API REST pública gratuita para conversão de ficheiros. Converta imagens, áudio, vídeo, documentos e PDFs — além de ferramentas de IA como ampliação, remoção de fundo, isolamento vocal e conversão de fala em texto — com um único pedido HTTP. Respostas JSON, limites de taxa generosos, suporte em lote.
Converter um ficheiro com um comando cURL
Sem registo. Sem chave de API. Apenas envie um ficheiro e obtenha uma tarefa em troca.
curl -X POST https://cleverutils.com/api/v1/convert \
-F "[email protected]" \
-F "to_format=jpg"
Resposta (envelope canónico):
{
"data": {
"job_id": "5f8c1a2e9d4b7c0e3f6a8b2d1e4c5f78",
"status": "done",
"output": {
"filename": "photo_cleverutils.com.jpg",
"size_bytes": 184523,
"size_human": "180 KB",
"url": "https://cleverutils.com/api/v1/jobs/5f8c.../output"
},
"links": {
"self": "https://cleverutils.com/api/v1/jobs/5f8c...",
"output": "https://cleverutils.com/api/v1/jobs/5f8c.../output"
},
"expires_at": "2026-04-10T14:32:11Z"
}
}
Em seguida, descarregue o resultado:
curl -o photo.jpg https://cleverutils.com/api/v1/jobs/5f8c.../output
Veja o guia de início rápido completo com Python, Node.js, PHP & Go →
Por que utilizar a API?
Gratuito, sem registo
Sem chaves de API, sem OAuth, sem cartão de crédito. Apenas HTTP. Limites de taxa generosos baseados em IP.
Todos os formatos
55+ formatos de imagem, 17+ de áudio, 30+ de vídeo, 25+ de documentos. Mais 12 ferramentas de IA.
Processamento em lote
Envie até 20 ficheiros num único pedido. Perfeito para bibliotecas de fotografias, memorandos de voz e arquivos de documentos.
Amigável para assíncrono
Obtenha imediatamente um job_id, consulte o estado. Ou aguarde de forma síncrona para ficheiros pequenos.
Envios de 200 MB
Limite superior ao do site. Concebido para vídeo, fotos RAW e documentos grandes.
Mesmo motor do site
ImageMagick, FFmpeg, LibreOffice, Real-ESRGAN, Demucs, Whisper. Comprovado em milhões de ficheiros.
Endpoints num relance
Referência completa de endpoints →
Factos-chave
- Autenticação: nenhuma necessária. Anónima, limitação de taxa baseada em IP.
- Quota predefinida: 1000 pedidos por dia por IP, 150 por hora, período de espera de 1 segundo entre pedidos.
- Quotas de ferramentas de IA: 50–100 por dia por IP (computação intensiva).
- Limite de tamanho de ficheiro: 200 MB por ficheiro.
- Limite de lote: 20 ficheiros por pedido
POST /api/v1/batch. - Retenção de tarefas: ficheiros convertidos são excluídos após 2 horas — descarregue prontamente.
- CORS:
Access-Control-Allow-Origin: *— funciona a partir de qualquer origem do navegador. - Controlo de versão: baseado em URL (
/api/v1/). Alterações de rutura irão para v2 com aviso de pelo menos 6 meses. - Estado: consulte /api/status para saúde em tempo real.
Documentação
Perguntas Frequentes
A API CleverUtils é realmente gratuita?
Sim. A API é gratuita para utilizar sem registo, sem cartão de crédito e sem chaves de API. Utilizamos limites de taxa baseados em IP para proteger contra abuso — atualmente 1000 conversões por IP por dia, com envios de ficheiros até 200 MB. Podemos introduzir níveis pagos opcionais no futuro para quotas mais altas, mas o nível gratuito permanecerá sempre.
Preciso de uma chave de API?
Não. O nível gratuito é totalmente anónimo. Apenas envie pedidos HTTP para /api/v1/* e está pronto. A limitação de taxa é por endereço IP.
Que formatos de ficheiro são suportados?
Todos os formatos suportados pelo site: 55+ formatos de imagem (JPG, PNG, HEIC, AVIF, WebP, RAW, PSD, etc.), 17+ formatos de áudio (MP3, WAV, FLAC, M4A, OGG, etc.), 30+ formatos de vídeo (MP4, MOV, MKV, WebM, AVI, etc.), 25+ formatos de documentos (DOCX, PDF, EPUB, XLSX, etc.), mais 12 ferramentas de IA como ampliação, remoção de vocal, conversão de fala em texto e remoção de fundo.
Como funcionam os limites de taxa?
Cada endereço IP obtém 1000 pedidos por dia, 150 por hora, com período de espera de 1 segundo entre pedidos consecutivos. As ferramentas de IA têm limites mais apertados (50–100 por dia) porque são computacionalmente caras. Cada resposta inclui cabeçalhos X-RateLimit-* mostrando sua quota restante. Consulte /api/rate-limits para detalhes completos.
Quanto tempo os ficheiros convertidos são mantidos?
Os ficheiros convertidos são armazenados durante 2 horas após a conversão e depois eliminados automaticamente. Certifique-se de descarregar o resultado via GET /api/v1/jobs/{job_id}/output nessa janela.
Posso processar em lote vários ficheiros num único pedido?
Sim. POST /api/v1/batch aceita até 20 ficheiros num único pedido multipart e retorna um batch_id que pode consultar em GET /api/v1/batches/{batch_id}. Cada ficheiro no lote conta contra sua quota diária individualmente.
Qual é a diferença entre /api/v1/convert e /api/v1/tools/{slug}?
Utilize /api/v1/convert para conversão de formato (HEIC→JPG, MP4→MP3, DOCX→PDF, etc.). Utilize /api/v1/tools/{slug} para ferramentas especializadas que não se enquadram numa troca de formato simples — ampliação de IA, remoção de fundo, isolamento vocal, conversão de fala em texto, marca de água, desfocagem, etc.