SDK po stronie serwera najpierw
Użyj @image2url/next do akceptowania plików w Route Handlers lub API Routes, przesyłania ich do image2url i wysyłania linków z pamięcią podręczną CDN w jednym wywołaniu. Zbudowany dla szybkości, obserwowalności i zerowych uszkodzonych osadzeń.
Strategia pamięci podręcznej
public, max-age=31536000
Walidacja
MIME + ochrona rozmiaru
Formaty
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: 'Brak pliku' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Bezpieczny domyślnie
Przesyłanie HTTPS, walidacja MIME, limity rozmiaru i kodowanie nazw plików. Zwraca ustrukturyzowane błędy, które możesz logować.
Linki przyjazne SEO
Stabilne URL CDN z nagłówkami pamięci podręcznej i ciągami użycia przyjaznymi dla alt dla blogów, dokumentów i osadzeń.
Deterministyczne dane wyjściowe
URL plus ciągi Markdown, HTML i BBCode, plus pola filename, mimeType, size i uploadedAt.
Przesyłanie po stronie serwera najpierw
Utrzymuj tokeny po stronie serwera, strumieniuj pliki w Route Handlers i unikaj wycieku danych uwierzytelniających do klienta.
Wbudowana obserwowalność
Spójny JSON do logowania i analiz. Dodaj własne ponowienia lub telemetrię bez zgadywania kształtów odpowiedzi.
Fallback przyjazny dla krawędzi
Działa w runtime node i degraduje się z gracja na krawędzi. Skonfiguruj endpointy według środowiska.
Pamięć podręczna, której możesz ufać
Publiczne, długotrwałe nagłówki pamięci podręcznej na danych wyjściowych. Idealne dla dokumentów, stron marketingowych i statycznych renderów.
Mapa drogowa open source
Wysyłamy w open. Pomóż nam dodać podpisane URL, transformacje obrazów i presety frameworków.
Migracja drop-in
Zamień pomocnika przesyłania jednym wywołaniem; zachowaj formularze i UI nietknięte.
Zbieramy wzorce ze świata rzeczywistego: podpisane przesyłania, niestandardowe domeny CDN, przykłady middleware Next.js i ulepszenia DX. Gwiazdy, problemy i PR na GitHub utrzymują projekt zdrowy.
Wolisz React hooks? Wypróbuj @image2url/react. Potrzebujesz przepływów agentów? Użyj mcp-server-image2url.
Co rozwiązuje @image2url/next?
Utrzymuje przesyłanie po stronie serwera w Next.js (Route Handlers lub API Routes), zwraca typizowany JSON i wysyła URL gotowe do CDN z fragmentami Markdown/HTML.
Czy potrzebuję kluczy API?
Domyślny endpoint na image2url.com oferuje bezpłatną kwotę opartą na IP. Wdrożenia samodzielne mogą wymuszać tokeny i niestandardowe limity rozmiaru.
Czy jest kompatybilny z krawędzią?
Tak. Pomocnik działa w Route Handlers i wspiera strumieniowanie ciał. Działa najlepiej w runtime node, ale degraduje się z gracja.
Czy mogę kontrybuować?
Absolutnie. Budujemy publicznie na github.com/image2url/image2url-sdk. Problemy, PR i ulepszenia dokumentacji są mile widziane.
Jakie odpowiedzi otrzymuję z powrotem?
Permanentny URL plus filename, mimeType, size, uploadedAt i sformatowane ciągi (Markdown, HTML, BBCode) do natychmiastowego wklejenia.
Jak jest obsługiwana niezawodność?
Przesyłanie jest HTTPS, walidowane dla MIME i rozmiaru, ustawia Cache-Control: public, max-age=31536000 i zwraca ustrukturyzowane błędy, które możesz logować.
Gotowy do wysyłki
URL wspierany przez CDN, typizowane odpowiedzi i mapa drogowa napędzana przez społeczność.