SDK del lado del servidor primero
Usa @image2url/next para aceptar archivos en Route Handlers o API Routes, enviarlos a image2url y enviar enlaces cacheados por CDN en una sola llamada. Construido para velocidad, observabilidad y cero inserciones rotas.
Estrategia de caché
public, max-age=31536000
Validación
MIME + protección de tamaño
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: 'Archivo faltante' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Seguro por defecto
Subidas HTTPS, validación MIME, límites de tamaño y codificación de nombres de archivo. Devuelve errores estructurados que puedes registrar.
Enlaces amigables con SEO
URLs de CDN estables con encabezados de caché y cadenas de uso amigables con alt para blogs, documentos e inserciones.
Salida determinista
URL más cadenas Markdown, HTML y BBCode, más campos filename, mimeType, size y uploadedAt.
Subidas del lado del servidor primero
Mantén tokens del lado del servidor, transmite archivos en Route Handlers y evita filtrar credenciales al cliente.
Observabilidad incorporada
JSON consistente para registro y análisis. Agrega tus propios reintentos o telemetría sin adivinar formas de respuesta.
Respaldo amigable con edge
Funciona en el tiempo de ejecución de node y degrada elegantemente en el edge. Configura endpoints por entorno.
Caché en la que puedes confiar
Encabezados de caché públicos y de larga duración en salidas. Perfecto para documentos, sitios de marketing y renders estáticos.
Hoja de ruta de código abierto
Enviamos en abierto. Ayúdanos a agregar URLs firmadas, transformaciones de imágenes y presets de framework.
Migración drop-in
Intercambia tu ayuda de subida con una sola llamada; mantén tus formularios e UI intactos.
Estamos recolectando patrones del mundo real: subidas firmadas, dominios personalizados de CDN, ejemplos de middleware de Next.js y mejoras de DX. Stars, issues y PRs en GitHub mantienen el proyecto saludable.
¿Prefieres React hooks? Prueba @image2url/react. ¿Necesitas flujos de agentes? Usa mcp-server-image2url.
¿Qué resuelve @image2url/next?
Mantiene las subidas del lado del servidor en Next.js (Route Handlers o API Routes), devuelve JSON tipificado y envía URLs listas para CDN con fragmentos Markdown/HTML.
¿Necesito claves API?
El endpoint predeterminado en image2url.com ofrece una cuota gratuita basada en IP. Los despliegues autohospedados pueden hacer cumplir tokens y límites de tamaño personalizados.
¿Es compatible con edge?
Sí. El ayudante se ejecuta en Route Handlers y soporta cuerpos de streaming. Funciona mejor en tiempos de ejecución de node pero degrada elegantemente.
¿Puedo contribuir?
Absolutamente. Estamos construyendo públicamente en github.com/image2url/image2url-sdk. Issues, PRs y mejoras de documentación son bienvenidos.
¿Qué respuestas recibo de vuelta?
URL permanente más filename, mimeType, size, uploadedAt y cadenas formateadas (Markdown, HTML, BBCode) para pegado instantáneo.
¿Cómo se maneja la confiabilidad?
Las subidas son HTTPS, validadas para MIME y tamaño, establecen Cache-Control: public, max-age=31536000 y devuelven errores estructurados que puedes registrar.
Listo para enviar
URLs respaldadas por CDN, respuestas tipificadas y una hoja de ruta impulsada por la comunidad.