Image2URL開發技術堆疊
image2url.com背後的官方套件：imgtourl (CLI)、mcp-server-image2url (智慧體)、@image2url/react (UI) 和 @image2url/next (API助手)。一次上傳，處處分享。
全球CDN
邊緣快取
安全性
TLS + MIME檢查
免費方案
基於IP的配額
EEAT就緒：透明限制、預設HTTPS、Cloudflare R2儲存，以及用於可重現工作流程的結構化輸出。
輸入 npm install -g imgtourl 並按 Enter 進行模擬。
步驟1：模擬安裝。步驟2：嘗試 imgtourl logo.png 進行帶綠色URL輸出的上傳。
imgtourl (CLI)
適用於CI腳本、文件編寫者和快速終端上傳。
mcp-server-image2url
在結構化MCP輸出中傳回URL + Markdown/HTML/BBCode片段。
@image2url/react
客戶端友善，支援fetch，保持套件體積小。
@image2url/next
API路由/路由處理器就緒；快取並強制執行大小限制。
漸進增強：即插即用鉤子加拖放功能。保持上傳遠離後端或覆蓋端點用於私有部署。
import { useImage2URL } from '@image2url/react';
export function ImageUploader() {
const { upload, status, result, error } = useImage2URL({
uploadUrl: 'https://www.image2url.com/api/upload',
});
async function handleFile(file) {
await upload({ file, alt: 'hero banner' });
}
return (
<div>
<input type="file" accept="image/*" onChange={(e) => e.target.files && handleFile(e.target.files[0])} />
<p>{status === 'uploading' ? '上傳中…' : null}</p>
{result?.url && <a href={result.url}>{result.url}</a>}
{error && <span>{error}</span>}
</div>
);
}保持上傳在伺服器端以避免暴露令牌。在API路由或路由處理器中工作，支援串流響應和快取標頭。
import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';
export async function POST(request: Request) {
const data = await request.formData();
const file = data.get('file');
if (!(file instanceof File)) {
return NextResponse.json({ error: '缺少檔案' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'marketing-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}安全與信任
預設HTTPS、MIME驗證、檔名編碼和針對CDN優化的Cache-Control標頭。結構化錯誤讓可觀察性變得簡單。
SEO和嵌入就緒
連結經過CDN快取且穩定，完美適用於部落格、文件、wiki和社交嵌入，無需base64臃腫。
一致的輸出
每個套件都傳回URL、Markdown、HTML、BBCode、檔名、mimeType和uploadedAt，讓您的工作流程保持確定性。
什麼是Image2URL？
Image2URL將任何檔案或遠端圖片URL轉換為永久HTTPS連結加上Markdown/HTML片段。SDK技術堆疊為CLI、MCP、React和Next.js封裝了該端點。
有免費方案嗎？
有的。image2url.com上的預設端點提供基於IP的免費配額，讓您無需令牌即可本機測試。
我可以自託管嗎？
設定IMAGE2URL_BASE_URL或IMAGE2URL_UPLOAD_URL指向您自己的部署或Cloudflare R2儲存桶。CLI、MCP伺服器和SDK都遵循這些環境變數。
傳回哪些格式？
直接URL加上Markdown、HTML和BBCode字串。結構化響應包括檔名、mimeType、大小、uploadedAt和uploadEndpoint。
檔案如何驗證？
圖片必須呈現有效的image/* MIME類型。預設大小限制為2MB；您可以在自託管部署中透過IMAGE2URL_MAX_BYTES覆蓋。
SDK是否生產就緒？
是的。基於HTTPS構建，具有快取友善的標頭、完整性檢查和清晰的錯誤訊息。image2url.com本身就在使用。