SuperAPI AI 工具集

nextjs-modal-integration

前端与建站

查看项目

更新于 10-15 23:42

技能介绍

用途:该技能用于把 Next.js 应用与 Modal.com 后端集成,适合 Edge/Vercel Functions 难以承载的 AI 推理、FFmpeg 音视频处理、超过 Vercel 60 秒超时的后台作业、GPU 负载(图像生成、LLM、嵌入)以及突发算力的成本优化。架构原则是 Next.js 负责 UI、鉴权与路由,Modal 负责重型计算。

主要能力:提供 Modal 后端 FastAPI 端点搭建(含 CORS、HTTPBearer 鉴权、健康检查)、Next.js App Router API Route 调用 Modal 的请求/响应模式、AI 图像生成(Stable Diffusion XL + A100 GPU + Volume 模型缓存 + 预热容器)完整示例、React 客户端组件示例,以及 Webhook 回调、文件上传流水线、流式 LLM 响应(SSE、ReadableStream、中断处理)等模式(详见 references/webhooks-uploads-streaming.md)。

使用方式:Modal 侧用 modal.App、modal.Image、@modal.asgi_app() 定义端点,通过 modal deploy modal_backend/app.py 部署,得到形如 https://your-workspace--nextjs-backend-api.modal.run 的地址;Next.js 侧在 .env.local 配置 MODAL_API_URL 与 MODAL_API_KEY,在 API Route 中用 fetch 转发请求。生产环境建议设置 min_containers=1 保持热容器,并配置 CORS 允许本地、Vercel 预览与生产域名。

限制与注意事项:Modal API Key 必须仅保留在服务端,禁止使用 NEXT_PUBLIC_ 前缀暴露;Vercel 超时限制为 Hobby 60 秒、Pro 300 秒、Enterprise 900 秒,更长任务应改用 Webhook;避免通过 Next.js API Route 传输超过 4MB 的大文件,建议使用签名 URL 或 CloudBucketMount;冷启动约 500ms,热容器低于 100ms;需处理 CORS、错误与请求超时(如 55 秒 AbortController)。具体收费与价格资料暂未提供。