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本身就在使用。