Server-first SDK
Gebruik @image2url/next om bestanden te accepteren in Route Handlers of API Routes, ze naar image2url te sturen, en CDN-gecachede links in één aanroep te versturen. Gebouwd voor snelheid, observeerbaarheid en nul gebroken embeds.
Cache strategie
public, max-age=31536000
Validatie
MIME + size guard
Formaten
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: 'Bestand ontbreekt' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Veilig standaard
HTTPS uploads, MIME validatie, size caps en bestandsnaam encodering. Retourneert gestructureerde fouten die je kunt loggen.
SEO-vriendelijke links
Stabiele CDN URLs met cache headers en alt-vriendelijke usage strings voor blogs, docs en embeds.
Deterministische output
URL plus Markdown, HTML en BBCode strings, plus filename, mimeType, size en uploadedAt velden.
Server-first uploads
Houd tokens server-side, stream bestanden in Route Handlers, en vermijd lekken van credentials naar de client.
Ingebouwde observeerbaarheid
Consistente JSON voor logging en analytics. Voeg je eigen retries of telemetry toe zonder response shapes te hoeven raden.
Edge-vriendelijke fallback
Werkt in de node runtime en degradeert netjes aan de edge. Configureer endpoints per omgeving.
Cache die je kunt vertrouwen
Publieke, langlevende cache headers op outputs. Perfect voor docs, marketing sites en statische renders.
Open source roadmap
We verschepen in het open. Help ons met het toevoegen van signed URLs, afbeelding transforms en framework presets.
Drop-in migratie
Wissel je upload helper met één aanroep; houd je formulieren en UI onaangetast.
We verzamelen real-world patterns: signed uploads, CDN custom domains, Next.js middleware voorbeelden, en DX verbeteringen. Stars, issues en PRs op GitHub houden het project gezond.
Voorkeur voor React hooks? Probeer @image2url/react. Noodzaak voor agent flows? Gebruik mcp-server-image2url.
Wat lost @image2url/next op?
Het houdt uploads server-side in Next.js (Route Handlers of API Routes), retourneert getypeerd JSON, en verscheept CDN-ready URLs met Markdown/HTML snippets.
Heb ik API keys nodig?
De standaard endpoint op image2url.com biedt een gratis IP-gebaseerde quota. Self-hosted deployments kunnen tokens en custom size limits afdwingen.
Is het edge compatible?
Ja. De helper draait in Route Handlers en ondersteunt streaming bodies. Werkt het beste in node runtimes maar degradeert netjes.
Kan ik bijdragen?
Absoluut. We bouwen publiek op github.com/image2url/image2url-sdk. Issues, PRs en docs verbeteringen zijn welkom.
Welke responses krijg ik terug?
Permanente URL plus filename, mimeType, size, uploadedAt en geformatteerde strings (Markdown, HTML, BBCode) voor direct plakken.
Hoe wordt betrouwbaarheid afgehandeld?
Uploads zijn HTTPS, gevalideerd voor MIME en size, stellen Cache-Control: public, max-age=31536000 in, en retourneren gestructureerde fouten die je kunt loggen.
Klaar om te verschepen
CDN-backed URLs, getypeerde responses en een community-driven roadmap.