fal.ai 代理库

导言

这个 @fal-ai/server-proxy 库可以让您通过自己的服务器传送客户端请求,从而保护敏感的证书。 在Next.js和Express等通俗框架的内置支持下,设置代理成为一股微风.

安装代理库 :

npm install --save @fal-ai/server-proxy

Next.js 页面路由器集成

对于使用页面路由器的 Next.js 应用程序 :

1. 在您的 Next.js app 中创建 API 路由, 作为我们建议使用的常规 pages/api/fal/proxy.js (或 .ts 如果您正在使用类型脚本 :
2. 从库中再导出代理处理器为默认导出 :

   export { handler as default } from "@fal-ai/server-proxy/nextjs";
   

3. 确保您已经设置 FAL_KEY 作为您服务器中的环境变量,包含有效的 API 密钥.

Next.js app 路由器集成

Next.js 应用程序使用应用程序路由器:

1. 在您的 Next.js app 中创建 API 路由, 作为我们建议使用的常规 app/api/fal/proxy/route.js (或 .ts 如果您正在使用类型脚本 :

2. 从库中再导出代理处理器为默认导出 :

   import { route } from "@fal-ai/server-proxy/nextjs";
   
   export const { GET, POST, PUT } = route;
   

3. 确保您已经设置 FAL_KEY 作为您服务器中的环境变量,包含有效的 API 密钥.

快速融合

对快件应用程序:

1. 确保您的应用程序支持 JSON 有效载荷, 要么使用 express.json() (建议)或 body-parser数字 :

   app.use(express.json());
   

2. 添加代理路由及其处理器 。 注意, 如果您的客户端居住在快取应用之外( 即快取应用完全用作其他客户端的外部 API) , 您需要允许 CORS 在代理路径上 :

   import * as falProxy from "@fal-ai/server-proxy/express";
   
   app.all(
     falProxy.route, // '/api/fal/proxy' or you can use your own
     cors(), // if external clients will use the proxy
     falProxy.handler,
   );
   

3. 确保您已经设置 FAL_KEY 作为您服务器中的环境变量,包含有效的 API 密钥.

客户端配置

一旦设置了代理,您就可以配置客户端使用:

import { fal } from "@fal-ai/client";

fal.config({
  proxyUrl: "/api/fal/proxy", // or https://my.app.com/api/fal/proxy
});

现在所有客户端的电话都会通过您的服务器代理运行,所以您的证书是受到保护的.

默认情况下,代理中间软件只在浏览器环境中运行——由Node,Electron,Bun,或边缘/工人运行时间提出的要求直接被发送到fal API. 要在这些运行时间选择代理, 要通过一个对象而不是字符串 :

fal.config({
  proxyUrl: {
    url: "/api/fal/proxy",
    when: "always",
  },
});

when 接受:

• "browser" - 只在有DOM的环境中 window (默认).

• "always" - 在每一个运行的时间.

• (env) => boolean ——自定义上游. env 实值 { isBrowser: boolean },因此您可以分层自行检查——例如,只能通过电子渲染器过程的代用路由:

  fal.config({
    proxyUrl: {
      url: "/api/fal/proxy",
      when: ({ isBrowser }) => isBrowser || (typeof process !== "undefined" && process.type === "renderer"),
    },
  });
  

备份域

当代理无法连接到 fal 推断网关时, 它会重复 在备份域请求一次 :

只有DNS和连接-建立故障触发倒计时. HTTP 密码 错误响应, 网关回复后失败, 和呼叫者 取消方式不变。 节点出错代码 区分;边缘运行时报告两者的赤网错误,所以有 在备份主机上对已发送但未获答复的请求也进行再审.

获取 API 没有连接相位超时, 因此无法访问主机 代理伺候运行时间本身的连接超时( 节点约10秒) 在尝试备份之前.

如果您的服务器限制外出流量, 也允许备份域 . 目标 URL 在任何回落前都会对许可列表进行验证,所以 备份域不需要在 allowedUrlPatterns。 。 。 .

更多信息

为了更深入地潜入代理库及其能力,探索 正式文件。 。 。 .

服务器运行时间证书更新

在固定节点上运行代理主机 : 22.23.4+ 22号节点, 24.22.1+ 在节点24上,或 26.12.1+ 在节点26。 重新部署并重新启动现有进程。 软件包引擎 所需经费不更新已部署的运行时间。 检查明显的 CA 覆盖, 自定义获取客户端, 并单独管理运行时信任; 确认两者都受到影响 eMudhra/AAA 链家在合法 HTTPS 时失败验证证书 继续工作.