Server-first SDK
Verwenden Sie @image2url/next, um Dateien in Route Handlers oder API Routes zu akzeptieren, sie an image2url zu übergeben und CDN-gecachedete Links in einem Aufruf zu liefern. Gebaut für Geschwindigkeit, Beobachtbarkeit und null kapotte Einbettungen.
Cache-Strategie
public, max-age=31536000
Validierung
MIME + Größen-Schutz
Formate
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: 'Fehlende Datei' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Standardmäßig sicher
HTTPS-Uploads, MIME-Validierung, Größenbeschränkungen und Dateinamen-Kodierung. Gibt strukturierte Fehler zurück, die Sie protokollieren können.
SEO-freundliche Links
Stabile CDN-URLs mit Cache-Headern und alt-freundlichen Nutzungsstrings für Blogs, Dokumentationen und Einbettungen.
Deterministische Ausgabe
URL plus Markdown-, HTML- und BBCode-Strings, plus filename-, mimeType-, size- und uploadedAt-Felder.
Server-first Uploads
Tokens server-seitig behalten, Dateien in Route Handlers streamen und vermeiden, Anmeldeinformationen an den Client preiszugeben.
Integrierte Beobachtbarkeit
Konsistentes JSON für Logging und Analysen. Fügen Sie eigene Wiederholungsversuche oder Telemetrie hinzu, ohne Antwortformen raten zu müssen.
Edge-freundlicher Fallback
Funktioniert in der node-Laufzeit und degradiert am Rand sanft. Konfigurieren Sie Endpunkte pro Umgebung.
Cache, dem Sie vertrauen können
Öffentliche, langlebige Cache-Header auf Ausgaben. Perfekt für Dokumentationen, Marketing-Sites und statisches Rendering.
Open-Source-Roadmap
Wir liefern im Open. Helfen Sie uns, signierte URLs, Bild-Transformationen und Framework-Voreinstellungen hinzuzufügen.
Drop-in Migration
Tauschen Sie Ihren Upload-Helfer mit einem einzigen Aufruf aus; behalten Sie Ihre Formulare und UI unverändert.
Wir sammeln Real-World-Patterns: signierte Uploads, CDN-Custom-Domains, Next.js-Middleware-Beispiele und DX-Verbesserungen. Stars, Issues und PRs auf GitHub halten das Projekt gesund.
Bevorzugen Sie React Hooks? Probieren Sie @image2url/react. Benötigen Sie Agent-Flows? Verwenden Sie mcp-server-image2url.
Was löst @image2url/next?
Es hält Uploads server-seitig in Next.js (Route Handlers oder API Routes), gibt typisiertes JSON zurück und liefert CDN-fähige URLs mit Markdown/HTML-Snippets.
Benötige ich API-Schlüssel?
Der Standard-Endpunkt auf image2url.com bietet ein kostenloses IP-basiertes Kontingent. Selbst gehostete Deployments können Tokens und benutzerdefinierte Größenbeschränkungen erzwingen.
Ist es Edge-kompatibel?
Ja. Der Helfer läuft in Route Handlers und unterstützt Streaming-Body. Er funktioniert am besten in node-Runtimes, degradiert aber sanft.
Kann ich beitragen?
Absolut. Wir bauen öffentlich auf github.com/image2url/image2url-sdk. Issues, PRs und Dokumentationsverbesserungen sind willkommen.
Welche Antworten erhalte ich zurück?
Permanente URL plus filename, mimeType, size, uploadedAt und formatierte Strings (Markdown, HTML, BBCode) für sofortiges Einfügen.
Wie wird Zuverlässigkeit gehandhabt?
Uploads sind HTTPS, validiert für MIME und Größe, setzen Cache-Control: public, max-age=31536000 und geben strukturierte Fehler zurück, die Sie protokollieren können.
Bereit zum Liefern
CDN-gestützte URLs, typisierte Antworten und eine Community-gesteuerte Roadmap.