SDK do lado do servidor primeiro
Use @image2url/next para aceitar arquivos em Route Handlers ou API Routes, enviá-los para image2url e enviar links cacheados por CDN em uma única chamada. Construído para velocidade, observabilidade e zero incorporações quebradas.
Estratégia de cache
public, max-age=31536000
Validação
MIME + guarda de tamanho
Formatos
URL + Markdown/HTML/BBCode
import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';
export async function POST(request: Request) {
const form = await request.formData();
const file = form.get('file');
if (!(file instanceof File)) {
return NextResponse.json({ error: 'Arquivo ausente' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Seguro por padrão
Uploads HTTPS, validação MIME, limites de tamanho e codificação de nome de arquivo. Retorna erros estruturados que você pode registrar.
Links amigáveis ao SEO
URLs CDN estáveis com cabeçalhos de cache e strings de uso amigáveis ao alt para blogs, documentos e incorporações.
Saída determinística
URL mais strings Markdown, HTML e BBCode, mais campos filename, mimeType, size e uploadedAt.
Uploads do lado do servidor primeiro
Mantenha tokens do lado do servidor, transmita arquivos em Route Handlers e evite vazar credenciais para o cliente.
Observabilidade incorporada
JSON consistente para registro e análise. Adicione suas próprias tentativas ou telemetria sem adivinhar formas de resposta.
Fallback amigável à borda
Funciona no runtime node e degrada graciosamente na borda. Configure endpoints por ambiente.
Cache em que você pode confiar
Cabeçalhos de cache públicos e de longa duração nas saídas. Perfeito para documentos, sites de marketing e renders estáticos.
Roadmap de código aberto
Enviamos no aberto. Ajude-nos a adicionar URLs assinados, transformações de imagem e presets de framework.
Migração drop-in
Troque seu auxiliar de upload com uma única chamada; mantenha seus formulários e UI intactos.
Estamos coletando padrões do mundo real: uploads assinados, dom personalizados de CDN, exemplos de middleware Next.js e melhorias de DX. Stars, issues e PRs no GitHub mantêm o projeto saudável.
Prefere React hooks? Tente @image2url/react. Precisa de fluxos de agentes? Use mcp-server-image2url.
O que @image2url/next resolve?
Mantém uploads do lado do servidor em Next.js (Route Handlers ou API Routes), retorna JSON tipificado e envia URLs prontas para CDN com snippets Markdown/HTML.
Preciso de chaves API?
O endpoint padrão em image2url.com oferece uma cota gratuita baseada em IP. Deployments auto-hospedados podem impor tokens e limites de tamanho personalizados.
É compatível com borda?
Sim. O auxiliar funciona em Route Handlers e suporta corpos de streaming. Funciona melhor em runtimes node mas degrada graciosamente.
Posso contribuir?
Absolutamente. Estamos construindo publicamente em github.com/image2url/image2url-sdk. Issues, PRs e melhorias de documentação são bem-vindos.
Que respostas recebo de volta?
URL permanente mais filename, mimeType, size, uploadedAt e strings formatadas (Markdown, HTML, BBCode) para colagem instantânea.
Como a confiabilidade é tratada?
Uploads são HTTPS, validados para MIME e tamanho, definem Cache-Control: public, max-age=31536000 e retornam erros estruturados que você pode registrar.
Pronto para enviar
URLs suportados por CDN, respostas tipificadas e uma roadmap impulsionada pela comunidade.