SDK côté serveur d'abord
Utilisez @image2url/next pour accepter les fichiers dans les Route Handlers ou API Routes, les envoyer à image2url et envoyer des liens mis en cache CDN en un seul appel. Construit pour la vitesse, l'observabilité et zéro intégration cassée.
Stratégie de cache
public, max-age=31536000
Validation
MIME + garde de taille
Formats
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: 'Fichier manquant' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Sécurisé par défaut
Téléchargements HTTPS, validation MIME, limites de taille et encodage des noms de fichiers. Retourne des erreurs structurées que vous pouvez journaliser.
Liens SEO-amicaux
URLs CDN stables avec en-têtes de cache et chaînes d'utilisation alt-amicales pour blogs, documentation et intégrations.
Sortie déterministe
URL plus chaînes Markdown, HTML et BBCode, plus champs filename, mimeType, size et uploadedAt.
Téléchargements côté serveur d'abord
Gardez les jetons côté serveur, diffusez les fichiers dans les Route Handlers et évitez de divulguer des identifiants au client.
Observabilité intégrée
JSON cohérent pour la journalisation et l'analyse. Ajoutez vos propres tentatives ou télémétrie sans deviner les formes de réponse.
Fallback compatible edge
Fonctionne dans le runtime node et se dégrade gracieusement à l'edge. Configurez les endpoints par environnement.
Cache sur lequel vous pouvez compter
En-têtes de cache publics et de longue durée sur les sorties. Parfait pour la documentation, les sites marketing et les rendus statiques.
Feuille de route open source
Nous livrons en open. Aidez-nous à ajouter des URLs signées, des transformations d'images et des presets de framework.
Migration drop-in
Échangez votre aide de téléchargement avec un seul appel ; gardez vos formulaires et UI intacts.
Nous collectons des patterns du monde réel : téléchargements signés, domaines personnalisés CDN, exemples de middleware Next.js et améliorations DX. Stars, issues et PRs sur GitHub maintiennent le projet sain.
Vous préférez React hooks ? Essayez @image2url/react. Besoin de flux d'agents ? Utilisez mcp-server-image2url.
Qu'est-ce que @image2url/next résout ?
Il garde les téléchargements côté serveur dans Next.js (Route Handlers ou API Routes), retourne JSON typé et livre des URLs prêtes CDN avec fragments Markdown/HTML.
Ai-je besoin de clés API ?
L'endpoint par défaut sur image2url.com offre un quota gratuit basé sur IP. Les déploiements auto-hébergés peuvent imposer des tokens et des limites de taille personnalisées.
Est-il compatible edge ?
Oui. L'assistant fonctionne dans les Route Handlers et supporte les corps en streaming. Fonctionne mieux dans les runtimes node mais se dégrade gracieusement.
Puis-je contribuer ?
Absolument. Nous construisons publiquement sur github.com/image2url/image2url-sdk. Issues, PRs et améliorations de documentation sont les bienvenus.
Quelles réponses reçois-je en retour ?
URL permanente plus filename, mimeType, size, uploadedAt et chaînes formatées (Markdown, HTML, BBCode) pour collage instantané.
Comment la fiabilité est-elle gérée ?
Les téléchargements sont HTTPS, validés pour MIME et taille, définissent Cache-Control: public, max-age=31536000 et retournent des erreurs structurées que vous pouvez journaliser.
Prêt à livrer
URLs soutenues par CDN, réponses typées et une feuille de route pilotée par la communauté.