伺服器優先 SDK
使用 @image2url/next 在路由處理器或 API 路由中接收檔案，推送到 image2url，並在一次呼叫中返回 CDN 快取的連結。為速度、可觀測性和零損壞嵌入而建構。
快取策略
public, max-age=31536000
驗證
MIME + 大小保護
格式
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: '缺少檔案' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}預設安全
HTTPS 上傳、MIME 驗證、大小限制和檔名編碼。返回可以記錄的結構化錯誤。
SEO 友好連結
帶有快取頭和 alt 友好使用字串的穩定 CDN URL，適用於部落格、文件和嵌入。
確定性輸出
URL 加上 Markdown、HTML 和 BBCode 字串，以及 filename、mimeType、size 和 uploadedAt 欄位。
伺服器優先上傳
令牌保留在伺服器端，在路由處理器中串流傳輸檔案，避免向客戶端洩露憑證。
內建可觀測性
用於日誌記錄和分析的一致 JSON。新增自己的重試或遙測，無需猜測回應形狀。
邊緣友好回退
在 node 運行時工作並在邊緣優雅降級。為每個環境配置端點。
可信賴的快取
輸出的公共、長期快取頭。完美適用於文件、行銷網站和靜態渲染。
開源路線圖
我們在開放中建構。幫助我們新增簽章 URL、圖片轉換和框架預設。
直接遷移
用一次呼叫交換上傳助手；保持表單和 UI 不變。
我們正在收集真實世界模式：簽章上傳、CDN 自定義網域、Next.js 中介軟體範例和 DX 改進。GitHub 上的 Stars、Issues 和 PRs 保持專案健康發展。
更喜歡 React hooks？試試 @image2url/react。需要代理程式流程？使用 mcp-server-image2url。
@image2url/next 解決了什麼問題？
它在 Next.js 中保持上傳伺服器端（路由處理器或 API 路由），返回類型化 JSON，並提供帶有 Markdown/HTML 片段的 CDN 就緒 URL。
我需要 API 金鑰嗎？
image2url.com 上的預設端點提供免費的基於 IP 的配額。自託管部署可以強制執行令牌和自定義大小限制。
它相容邊緣嗎？
是的。助手在路由處理器中執行並支援串流傳輸主體。它在 node 運行時中效果最好但會優雅降級。
我可以貢獻嗎？
當然。我們在 github.com/image2url/image2url-sdk 公開建構。歡迎 Issues、PRs 和文件改進。
我會得到什麼回應？
永久 URL 加上 filename、mimeType、size、uploadedAt 和格式化字串（Markdown、HTML、BBCode），可即時貼上。
如何處理可靠性？
上傳是 HTTPS，驗證 MIME 和大小，設定 Cache-Control: public, max-age=31536000，並返回可以記錄的結構化錯誤。
準備就緒
CDN 支援的 URL、類型化回應和社群驅動的路線圖。