服务器优先 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、类型化响应和社区驱动的路线图。