SDK phía máy chủ trước
Sử dụng @image2url/next để chấp nhận tệp trong Route Handlers hoặc API Routes, đẩy chúng vào image2url và gửi liên kết được lưu đệm CDN trong một cuộc gọi. Được xây dựng cho tốc độ, khả năng quan sát và không có nhúng bị hỏng.
Chiến lược bộ đệm
public, max-age=31536000
Xác thực
MIME + bảo vệ kích thước
Định dạng
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: 'Thiếu tệp' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}An toàn theo mặc định
Tải lên HTTPS, xác thực MIME, giới hạn kích thước và mã hóa tên tệp. Trả về lỗi cấu trúc bạn có thể ghi lại.
Liên kết thân thiện SEO
URL CDN ổn định với tiêu đề bộ đệm và chuỗi sử dụng thân thiện alt cho blog, tài liệu và nhúng.
Đầu ra xác định
URL plus chuỗi Markdown, HTML và BBCode, plus trường filename, mimeType, size và uploadedAt.
Tải lên phía máy chủ trước
Giữ mã thông tin phía máy chủ, truyền tệp trong Route Handlers và tránh rò rỉ thông tin xác thực cho client.
Khả năng quan sát tích hợp
JSON nhất quán để ghi nhật ký và phân tích. Thêm các lần thử lại hoặc đo từ xa của riêng bạn mà không cần đoán hình dạng phản hồi.
Fallback thân thiện edge
Hoạt động trong runtime node và suy giảm nhẹ nhàng ở edge. Cấu hình endpoint theo môi trường.
Bộ đệm bạn có thể tin tưởng
Tiêu đề bộ đệm công cộng, lâu dài trên đầu ra. Hoàn hảo cho tài liệu, trang tiếp thị và kết xuất tĩnh.
Lộ trình mã nguồn mở
Chúng tôi vận chuyển trong mở. Giúp chúng tôi thêm URL đã ký, biến đổi hình ảnh và presets framework.
Di chuyển drop-in
Thay thế trợ giúp tải lên của bạn bằng một cuộc gọi; giữ biểu mẫu và UI của bạn không thay đổi.
Chúng tôi đang thu thập các mẫu thế giới thực: tải lên đã ký, miền tùy chỉnh CDN, ví dụ middleware Next.js và cải tiến DX. Stars, issues và PRs trên GitHub giữ cho dự án khỏe mạnh.
Thích React hooks? Thử @image2url/react. Cần luồng tác nhân? Sử dụng mcp-server-image2url.
@image2url/next giải quyết gì?
Nó giữ tải lên phía máy chủ trong Next.js (Route Handlers hoặc API Routes), trả về JSON đã gõ kiểu và vận chuyển URL sẵn sàng CDN với các đoạn Markdown/HTML.
Tôi có cần khóa API không?
Endpoint mặc định trên image2url.com cung cấp hạn ngạch miễn phí dựa trên IP. Các triển khai tự lưu trữ có thể thực thi mã thông báo và giới hạn kích thước tùy chỉnh.
Nó có tương thích edge không?
Có. Trợ giúp hoạt động trong Route Handlers và hỗ trợ luồng trực tiếp. Hoạt động tốt nhất trong các runtime node nhưng suy giảm nhẹ nhàng.
Tôi có thể đóng góp không?
Tuyệt đối. Chúng tôi đang xây dựng công khai trên github.com/image2url/image2url-sdk. Issues, PRs và cải tiến tài liệu được chào đón.
Tôi nhận được phản hồi gì trở lại?
URL vĩnh viễn plus filename, mimeType, size, uploadedAt và chuỗi định dạng (Markdown, HTML, BBCode) để dán tức thì.
Độ tin cậy được xử lý như thế nào?
Tải lên là HTTPS, được xác thực cho MIME và kích thước, đặt Cache-Control: public, max-age=31536000 và trả về lỗi cấu trúc bạn có thể ghi lại.
Sẵn sàng để vận chuyển
URL được hỗ trợ bởi CDN, phản hồi đã gõ kiểu và lộ trình được điều khiển bởi cộng đồng.