AI SDK 集成 fal.ai 图像生成 Provider安装、配置与实战指南【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai本指南以 AI SDKThe AI Toolkit for TypeScript仓库中的ai-sdk/fal包为对象系统讲解如何在 TypeScript 项目中接入 fal.ai 图像生成能力从安装、Provider 实例化、generateImage调用到providerOptions.fal透传参数、图像编辑与尺寸控制等高级用法。读完本文你将能基于 fal 提供的 Flux、Recraft、Ideogram、Sana 等模型快速搭建可运行的图像生成与编辑流水线并理解其在 AI SDK 中的底层实现原理。一、fal Provider 是什么ai-sdk/fal是 AI SDK 官方提供的一个 Provider 封装它为 TypeScript 开发者屏蔽了 fal.ai REST API 的细节以统一的 AI SDK 模型接口暴露图像生成能力。该包位于仓库 packages/fal模块名为ai-sdk/fal当前仓库中版本为3.0.40见 package.json基于ai-sdk/provider与ai-sdk/provider-utils构建遵循 Apache-2.0 许可。从源码看ai-sdk/fal并不只支持图像生成。其 Provider 接口见 fal-provider.ts声明了四类模型工厂方法image(modelId)/imageModel(modelId)图像生成与编辑返回ImageModelV4video(modelId)/videoModel(modelId)视频生成实验性返回Experimental_VideoModelV4speech(modelId)语音合成返回SpeechModelV4transcription(modelId)语音转写返回TranscriptionModelV4。其中图像生成是 README 的主线也是本文重点视频、语音与转写作为同一 Provider 的扩展能力将在后文一并介绍。二、安装与前置准备在任意支持 ESM 的 Node.js 项目要求 Node.js 22见 package.json中安装npm i ai-sdk/fal同时需要安装 AI SDK 核心包ai用于generateImage等高层 API与 zod 校验库npm i ai zod提示如果你使用 Claude Code、Cursor 等编码 AgentREADME 建议在仓库中引入官方 AI SDK skill 以提升智能体对 SDK 的理解npx skills add vercel/aiAPI Key 配置fal.ai 的 API Key 有两条读取路径按优先级排列源码见 fal-provider.ts 中的loadFalApiKey创建 Provider 时显式传入apiKey选项读取环境变量FAL_API_KEY若未设置则回退到FAL_KEY。export FAL_API_KEYyour-fal-api-key若两者均缺失运行时会抛出明确错误提示。需要特别注意的是在process不存在的环境如部分 Edge Runtime中环境变量方案不可用必须在createFal中显式传apiKey源码对此有专门的分支判断fal-provider.ts。三、创建 Provider 实例README 展示的是最简用法——直接导入默认实例import { fal } from ai-sdk/fal;fal是仓库导出的默认 Provider 实例fal-provider.ts等价于无参数调用createFal()。当需要自定义配置时使用createFal工厂函数。其FalProviderSettingsfal-provider.ts支持以下选项选项类型默认值说明apiKeystring环境变量FAL_API_KEY→FAL_KEYfal.ai API KeybaseURLstringhttps://fal.runAPI 请求基础地址源码会去除尾部斜杠fal-provider.tsheadersRecordstring, string—附加到每个请求的自定义请求头fetchFetchFunction全局 fetch自定义 fetch 实现可用于请求拦截或测试 mockimport { createFal } from ai-sdk/fal; const fal createFal({ apiKey: process.env.FAL_API_KEY, baseURL: https://fal.run, headers: { X-Custom-Header: value }, });请求头构造逻辑在源码中清晰可见每个请求都会携带Authorization: Key apiKey头并自动追加ai-sdk/fal/版本号的 User-Agent 后缀fal-provider.ts。四、图像生成实战一个完整示例README 给出了最小可运行的图像生成示例通过 AI SDK 的generateImage高层 API 调用 Flux schnell 模型import { fal } from ai-sdk/fal; import { generateImage } from ai; import fs from fs; const { image } await generateImage({ model: fal.image(fal-ai/flux/schnell), prompt: A cat wearing a intricate robe, }); const filename image-${Date.now()}.png; fs.writeFileSync(filename, image.uint8Array); console.log(Image saved to ${filename});执行流程说明fal.image(fal-ai/flux/schnell)创建一个FalImageModel实例modelId 用于拼接请求地址https://fal.run/fal-ai/flux/schnell见 fal-image-model.tsgenerateImage内部触发doGeneratePOST JSON 到 fal API随后自动下载返回的图片 URL 为二进制Uint8Array见 fal-image-model.ts 与downloadImage方法因此image.uint8Array可以直接用fs.writeFileSync落盘无需再手动请求图片 URL。FalImageModel的maxImagesPerCall固定为 1fal-image-model.ts即单次调用最多生成一张图。内置模型 IDFalImageModelId类型fal-image-settings.ts预置了大量模型 ID覆盖文生图、图生图、修复、超分等场景例如Flux 系列fal-ai/flux/schnell、fal-ai/flux/dev、fal-ai/flux-pro/v1.1、fal-ai/flux-pro/v1.1-ultra、fal-ai/flux-lora、fal-ai/flux-general含image-to-image、inpainting子路由Recraftfal-ai/recraft/v3/text-to-image、fal-ai/recraft/v3/image-to-image其他fal-ai/ideogram/character、fal-ai/imagen4/preview、fal-ai/luma-photon、fal-ai/sana/v1.5/4.8b、fal-ai/qwen-image、fal-ai/aura-sr、fal-ai/bria/background/remove等。类型定义以(string {})收尾因此也允许传入类型表中尚未枚举的新模型 ID如 README 示例中的fal-ai/recraft-v3。五、providerOptions.fal透传模型专属参数不同 fal 模型除了 prompt 之外往往还有专属输入风格、步数、引导系数等。README 指出将这类参数放入generateImage的providerOptions.fal属性即可原样透传const { image } await generateImage({ model: fal.image(fal-ai/recraft-v3), prompt: A cat wearing a intricate robe, size: 1920x1080, providerOptions: { fal: { style: digital_illustration, }, }, });源码中providerOptions.fal会先经falImageModelOptionsSchemafal-image-model-options.ts校验与归一化再与prompt、size、seed、n等标准参数合并成最终请求体fal-image-model.ts。已声明的内建参数schema 中明确声明的 camelCase 参数及其约束参数类型 / 取值范围映射到 API 字段guidanceScalenumber120guidance_scalenumInferenceStepsnumber150num_inference_stepsenableSafetyCheckerbooleanenable_safety_checkeroutputFormatjpeg \| pngoutput_formatsyncModebooleansync_modesafetyTolerance16或 16 数字safety_tolerancestrengthnumberstrengthaccelerationnone \| regular \| highaccelerationuseMultipleImagesboolean不发送给 API仅控制image_urls数组行为此外 schema 使用z.looseObject因此未枚举的任意自定义键如示例中的style也会被保留并透传给 fal API。关于 snake_case 的兼容与弃用警告schema 同时兼容历史 snake_case 写法如guidance_scale、num_inference_steps、output_format、safety_tolerance、image_url、mask_url等但会在 transform 阶段将其归一化为 camelCase并收集进__deprecatedKeys列表fal-image-model-options.ts。运行时若检测到__deprecatedKeys非空doGenerate会向warnings追加提示例如guidance_scale (use guidanceScale)并注明这些写法将在ai-sdk/falv2.0 移除fal-image-model.ts。因此新代码应统一使用 camelCase。六、尺寸与宽高比的处理细节README 示例中直接传了size: 1920x1080。源码对size的解析遵循固定约定size形如宽x高的字符串会被拆分为{ width, height }对象传给 API 的image_size字段fal-image-model.ts若未传size而传了aspectRatio则会按映射表转换为 fal 识别的枚举值fal-image-model.tsaspectRatio转换结果1:1square_hd16:9landscape_16_99:16portrait_16_94:3landscape_4_33:4portrait_4_316:10{ width: 1280, height: 800 }10:16{ width: 800, height: 1280 }21:9{ width: 2560, height: 1080 }9:21{ width: 1080, height: 2560 }FalImageSize类型本身也允许直接使用square、square_hd、landscape_16_9等字符串枚举或{ width, height }对象fal-image-settings.ts。七、图像编辑、inpainting 与多图输入除了纯文生图FalImageModel还实现了 AI SDK v4 的图像编辑接口。generateImage支持传入files参考图与mask蒙版源码会将其转为 Data URI 后写入请求体fal-image-model.ts单图编辑files[0]转为image_url字段若files传了多张但未开启useMultipleImages只会使用第一张并产生一条 warning 提示多图编辑设置providerOptions.fal.useMultipleImages: true后所有文件转为image_urls数组——适配fal-ai/flux-2/edit这类支持多图输入的模型Inpaintingmask转为mask_url字段可配合fal-ai/flux-general/inpainting等修复模型使用。import { generateImage } from ai; import fs from fs; const { image } await generateImage({ model: fal.image(fal-ai/flux-general/inpainting), prompt: Replace the sky with a starry night, files: [await fs.promises.readFile(./photo.jpg)], mask: await fs.promises.readFile(./mask.png), providerOptions: { fal: { strength: 0.8, numInferenceSteps: 30, }, }, });注意旧式的providerOptions.fal.imageUrl/maskUrl字符串参数仍被兼容但已被标记为废弃官方建议改用files/mask标准参数。八、结果元数据与错误处理providerMetadata.faldoGenerate返回时会附带providerMetadata.fal元数据fal-image-model.ts包含每张图的width、height、contentType、fileName、fileData、fileSize以及归一化后的 NSFW 标记nsfw合并自响应中的has_nsfw_concepts与nsfw_content_detected数组。响应中的timings推理耗时、seed、num_inference_steps等也会原样透传。错误响应解析fal API 的错误分为两类源码用 zod schema 分别建模后合并解析fal-image-model.ts校验错误响应体含detail数组每个元素含loc字段路径、msg消息、type错误信息会拼接为字段路径: 消息的多行文本普通 HTTP 错误响应体含message字段。这使得开发者在 prompt 或参数不合法时能拿到指明具体字段的错误信息便于快速定位。九、同一 Provider 的扩展能力视频、语音与转写虽然 README 聚焦图像生成但ai-sdk/fal在仓库中还实现了三类模型均复用同一个falProvider 实例。视频生成队列机制FalVideoModelfal-video-model.ts实现了 AI SDK v4 的实验性视频接口采用 fal 的队列式工作流doStart向https://queue.fal.run/fal-ai/modelId提交任务若配置了 webhook 则追加?fal_webhookurl参数响应中取得response_url与submit_urldoStatus轮询response_url若 fal 返回Request is still in progress则返回status: pending完成后返回status: completed及视频 URL、mediaType默认video/mp4。支持的模型 ID 包括luma-dream-machine、luma-ray-2、minimax-video、hunyuan-video等fal-video-settings.ts。请求体支持prompt、image_url图生视频、aspect_ratio、duration如5s、seed以及providerOptions.fal中的loop、motionStrength映射motion_strength、resolution、negativePrompt映射negative_prompt、promptOptimizer映射prompt_optimizer等参数。语音合成FalSpeechModelfal-speech-model.ts请求体包含text、voice、speed与output_formaturl或hex响应中的音频 URL 会被自动下载为二进制。其专属选项voice_settingspeed、vol、voice_id、pitch、english_normalization、emotion、audio_setting、language_boost、pronunciation_dict定义在 fal-speech-model-options.ts。需要注意两个行为fal 语音模型不直接支持language标准参数传入会触发unsupportedwarning官方建议改用providerOptions.fal.language_boost不支持的outputFormat值会回退为url并产生 warning。支持模型见 fal-speech-settings.tsfal-ai/minimax/speech-02-hd、fal-ai/minimax/speech-02-turbo、fal-ai/minimax/voice-clone、fal-ai/dia-tts等。语音转写FalTranscriptionModelfal-transcription-model.ts将音频转为 base64 Data URI 后提交到队列端点轮询直至完成。默认请求体为task: transcribe、diarize: true、chunk_level: word可通过providerOptions.fal覆盖language、version、batchSize映射batch_size、numSpeakers映射num_speakers、diarize、chunkLevel映射chunk_level等字段。模型 ID 目前为whisper与wizperfal-transcription-options.ts。十、如何验证与深入阅读仓库为ai-sdk/fal提供了完整的单元测试与快照测试是理解各模型行为边界的首选材料fal-image-model.test.ts图像生成的请求体构造、尺寸/宽高比解析、NSFW 元数据归一化、废弃 snake_case 警告等fal-speech-model.test.ts、fal-video-model.test.ts、fal-transcription-model.test.ts分别覆盖三类模型的参数映射与流程fal-provider.test.tsProvider 实例与 API Key 加载逻辑snapshots与fixtures记录真实请求/响应样例含转写队列的 JSON fixture。运行测试的命令在 package.json 中定义pnpm test会同时执行 Node 与 Edge 两套 vitest 配置vitest.node.config.js、vitest.edge.config.js。结语ai-sdk/fal以极小的学习成本将 fal.ai 的图像生成、编辑、视频、语音与转写能力统一收编进 AI SDK 的模型抽象体系。核心用法只需三件事安装ai-sdk/fal、配置 API Key、用fal.image(model-id)搭配generateImage调用进阶能力则集中在providerOptions.fal的透传参数、size/aspectRatio尺寸控制以及files/mask编辑输入上。借助仓库源码你可以精确把握每个参数如何映射到 fal API、哪些写法已被标记废弃从而写出更健壮、更易维护的多模态生成应用。【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AI SDK 集成 fal.ai 图像生成 Provider：安装、配置与实战指南
AI SDK 集成 fal.ai 图像生成 Provider安装、配置与实战指南【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai本指南以 AI SDKThe AI Toolkit for TypeScript仓库中的ai-sdk/fal包为对象系统讲解如何在 TypeScript 项目中接入 fal.ai 图像生成能力从安装、Provider 实例化、generateImage调用到providerOptions.fal透传参数、图像编辑与尺寸控制等高级用法。读完本文你将能基于 fal 提供的 Flux、Recraft、Ideogram、Sana 等模型快速搭建可运行的图像生成与编辑流水线并理解其在 AI SDK 中的底层实现原理。一、fal Provider 是什么ai-sdk/fal是 AI SDK 官方提供的一个 Provider 封装它为 TypeScript 开发者屏蔽了 fal.ai REST API 的细节以统一的 AI SDK 模型接口暴露图像生成能力。该包位于仓库 packages/fal模块名为ai-sdk/fal当前仓库中版本为3.0.40见 package.json基于ai-sdk/provider与ai-sdk/provider-utils构建遵循 Apache-2.0 许可。从源码看ai-sdk/fal并不只支持图像生成。其 Provider 接口见 fal-provider.ts声明了四类模型工厂方法image(modelId)/imageModel(modelId)图像生成与编辑返回ImageModelV4video(modelId)/videoModel(modelId)视频生成实验性返回Experimental_VideoModelV4speech(modelId)语音合成返回SpeechModelV4transcription(modelId)语音转写返回TranscriptionModelV4。其中图像生成是 README 的主线也是本文重点视频、语音与转写作为同一 Provider 的扩展能力将在后文一并介绍。二、安装与前置准备在任意支持 ESM 的 Node.js 项目要求 Node.js 22见 package.json中安装npm i ai-sdk/fal同时需要安装 AI SDK 核心包ai用于generateImage等高层 API与 zod 校验库npm i ai zod提示如果你使用 Claude Code、Cursor 等编码 AgentREADME 建议在仓库中引入官方 AI SDK skill 以提升智能体对 SDK 的理解npx skills add vercel/aiAPI Key 配置fal.ai 的 API Key 有两条读取路径按优先级排列源码见 fal-provider.ts 中的loadFalApiKey创建 Provider 时显式传入apiKey选项读取环境变量FAL_API_KEY若未设置则回退到FAL_KEY。export FAL_API_KEYyour-fal-api-key若两者均缺失运行时会抛出明确错误提示。需要特别注意的是在process不存在的环境如部分 Edge Runtime中环境变量方案不可用必须在createFal中显式传apiKey源码对此有专门的分支判断fal-provider.ts。三、创建 Provider 实例README 展示的是最简用法——直接导入默认实例import { fal } from ai-sdk/fal;fal是仓库导出的默认 Provider 实例fal-provider.ts等价于无参数调用createFal()。当需要自定义配置时使用createFal工厂函数。其FalProviderSettingsfal-provider.ts支持以下选项选项类型默认值说明apiKeystring环境变量FAL_API_KEY→FAL_KEYfal.ai API KeybaseURLstringhttps://fal.runAPI 请求基础地址源码会去除尾部斜杠fal-provider.tsheadersRecordstring, string—附加到每个请求的自定义请求头fetchFetchFunction全局 fetch自定义 fetch 实现可用于请求拦截或测试 mockimport { createFal } from ai-sdk/fal; const fal createFal({ apiKey: process.env.FAL_API_KEY, baseURL: https://fal.run, headers: { X-Custom-Header: value }, });请求头构造逻辑在源码中清晰可见每个请求都会携带Authorization: Key apiKey头并自动追加ai-sdk/fal/版本号的 User-Agent 后缀fal-provider.ts。四、图像生成实战一个完整示例README 给出了最小可运行的图像生成示例通过 AI SDK 的generateImage高层 API 调用 Flux schnell 模型import { fal } from ai-sdk/fal; import { generateImage } from ai; import fs from fs; const { image } await generateImage({ model: fal.image(fal-ai/flux/schnell), prompt: A cat wearing a intricate robe, }); const filename image-${Date.now()}.png; fs.writeFileSync(filename, image.uint8Array); console.log(Image saved to ${filename});执行流程说明fal.image(fal-ai/flux/schnell)创建一个FalImageModel实例modelId 用于拼接请求地址https://fal.run/fal-ai/flux/schnell见 fal-image-model.tsgenerateImage内部触发doGeneratePOST JSON 到 fal API随后自动下载返回的图片 URL 为二进制Uint8Array见 fal-image-model.ts 与downloadImage方法因此image.uint8Array可以直接用fs.writeFileSync落盘无需再手动请求图片 URL。FalImageModel的maxImagesPerCall固定为 1fal-image-model.ts即单次调用最多生成一张图。内置模型 IDFalImageModelId类型fal-image-settings.ts预置了大量模型 ID覆盖文生图、图生图、修复、超分等场景例如Flux 系列fal-ai/flux/schnell、fal-ai/flux/dev、fal-ai/flux-pro/v1.1、fal-ai/flux-pro/v1.1-ultra、fal-ai/flux-lora、fal-ai/flux-general含image-to-image、inpainting子路由Recraftfal-ai/recraft/v3/text-to-image、fal-ai/recraft/v3/image-to-image其他fal-ai/ideogram/character、fal-ai/imagen4/preview、fal-ai/luma-photon、fal-ai/sana/v1.5/4.8b、fal-ai/qwen-image、fal-ai/aura-sr、fal-ai/bria/background/remove等。类型定义以(string {})收尾因此也允许传入类型表中尚未枚举的新模型 ID如 README 示例中的fal-ai/recraft-v3。五、providerOptions.fal透传模型专属参数不同 fal 模型除了 prompt 之外往往还有专属输入风格、步数、引导系数等。README 指出将这类参数放入generateImage的providerOptions.fal属性即可原样透传const { image } await generateImage({ model: fal.image(fal-ai/recraft-v3), prompt: A cat wearing a intricate robe, size: 1920x1080, providerOptions: { fal: { style: digital_illustration, }, }, });源码中providerOptions.fal会先经falImageModelOptionsSchemafal-image-model-options.ts校验与归一化再与prompt、size、seed、n等标准参数合并成最终请求体fal-image-model.ts。已声明的内建参数schema 中明确声明的 camelCase 参数及其约束参数类型 / 取值范围映射到 API 字段guidanceScalenumber120guidance_scalenumInferenceStepsnumber150num_inference_stepsenableSafetyCheckerbooleanenable_safety_checkeroutputFormatjpeg \| pngoutput_formatsyncModebooleansync_modesafetyTolerance16或 16 数字safety_tolerancestrengthnumberstrengthaccelerationnone \| regular \| highaccelerationuseMultipleImagesboolean不发送给 API仅控制image_urls数组行为此外 schema 使用z.looseObject因此未枚举的任意自定义键如示例中的style也会被保留并透传给 fal API。关于 snake_case 的兼容与弃用警告schema 同时兼容历史 snake_case 写法如guidance_scale、num_inference_steps、output_format、safety_tolerance、image_url、mask_url等但会在 transform 阶段将其归一化为 camelCase并收集进__deprecatedKeys列表fal-image-model-options.ts。运行时若检测到__deprecatedKeys非空doGenerate会向warnings追加提示例如guidance_scale (use guidanceScale)并注明这些写法将在ai-sdk/falv2.0 移除fal-image-model.ts。因此新代码应统一使用 camelCase。六、尺寸与宽高比的处理细节README 示例中直接传了size: 1920x1080。源码对size的解析遵循固定约定size形如宽x高的字符串会被拆分为{ width, height }对象传给 API 的image_size字段fal-image-model.ts若未传size而传了aspectRatio则会按映射表转换为 fal 识别的枚举值fal-image-model.tsaspectRatio转换结果1:1square_hd16:9landscape_16_99:16portrait_16_94:3landscape_4_33:4portrait_4_316:10{ width: 1280, height: 800 }10:16{ width: 800, height: 1280 }21:9{ width: 2560, height: 1080 }9:21{ width: 1080, height: 2560 }FalImageSize类型本身也允许直接使用square、square_hd、landscape_16_9等字符串枚举或{ width, height }对象fal-image-settings.ts。七、图像编辑、inpainting 与多图输入除了纯文生图FalImageModel还实现了 AI SDK v4 的图像编辑接口。generateImage支持传入files参考图与mask蒙版源码会将其转为 Data URI 后写入请求体fal-image-model.ts单图编辑files[0]转为image_url字段若files传了多张但未开启useMultipleImages只会使用第一张并产生一条 warning 提示多图编辑设置providerOptions.fal.useMultipleImages: true后所有文件转为image_urls数组——适配fal-ai/flux-2/edit这类支持多图输入的模型Inpaintingmask转为mask_url字段可配合fal-ai/flux-general/inpainting等修复模型使用。import { generateImage } from ai; import fs from fs; const { image } await generateImage({ model: fal.image(fal-ai/flux-general/inpainting), prompt: Replace the sky with a starry night, files: [await fs.promises.readFile(./photo.jpg)], mask: await fs.promises.readFile(./mask.png), providerOptions: { fal: { strength: 0.8, numInferenceSteps: 30, }, }, });注意旧式的providerOptions.fal.imageUrl/maskUrl字符串参数仍被兼容但已被标记为废弃官方建议改用files/mask标准参数。八、结果元数据与错误处理providerMetadata.faldoGenerate返回时会附带providerMetadata.fal元数据fal-image-model.ts包含每张图的width、height、contentType、fileName、fileData、fileSize以及归一化后的 NSFW 标记nsfw合并自响应中的has_nsfw_concepts与nsfw_content_detected数组。响应中的timings推理耗时、seed、num_inference_steps等也会原样透传。错误响应解析fal API 的错误分为两类源码用 zod schema 分别建模后合并解析fal-image-model.ts校验错误响应体含detail数组每个元素含loc字段路径、msg消息、type错误信息会拼接为字段路径: 消息的多行文本普通 HTTP 错误响应体含message字段。这使得开发者在 prompt 或参数不合法时能拿到指明具体字段的错误信息便于快速定位。九、同一 Provider 的扩展能力视频、语音与转写虽然 README 聚焦图像生成但ai-sdk/fal在仓库中还实现了三类模型均复用同一个falProvider 实例。视频生成队列机制FalVideoModelfal-video-model.ts实现了 AI SDK v4 的实验性视频接口采用 fal 的队列式工作流doStart向https://queue.fal.run/fal-ai/modelId提交任务若配置了 webhook 则追加?fal_webhookurl参数响应中取得response_url与submit_urldoStatus轮询response_url若 fal 返回Request is still in progress则返回status: pending完成后返回status: completed及视频 URL、mediaType默认video/mp4。支持的模型 ID 包括luma-dream-machine、luma-ray-2、minimax-video、hunyuan-video等fal-video-settings.ts。请求体支持prompt、image_url图生视频、aspect_ratio、duration如5s、seed以及providerOptions.fal中的loop、motionStrength映射motion_strength、resolution、negativePrompt映射negative_prompt、promptOptimizer映射prompt_optimizer等参数。语音合成FalSpeechModelfal-speech-model.ts请求体包含text、voice、speed与output_formaturl或hex响应中的音频 URL 会被自动下载为二进制。其专属选项voice_settingspeed、vol、voice_id、pitch、english_normalization、emotion、audio_setting、language_boost、pronunciation_dict定义在 fal-speech-model-options.ts。需要注意两个行为fal 语音模型不直接支持language标准参数传入会触发unsupportedwarning官方建议改用providerOptions.fal.language_boost不支持的outputFormat值会回退为url并产生 warning。支持模型见 fal-speech-settings.tsfal-ai/minimax/speech-02-hd、fal-ai/minimax/speech-02-turbo、fal-ai/minimax/voice-clone、fal-ai/dia-tts等。语音转写FalTranscriptionModelfal-transcription-model.ts将音频转为 base64 Data URI 后提交到队列端点轮询直至完成。默认请求体为task: transcribe、diarize: true、chunk_level: word可通过providerOptions.fal覆盖language、version、batchSize映射batch_size、numSpeakers映射num_speakers、diarize、chunkLevel映射chunk_level等字段。模型 ID 目前为whisper与wizperfal-transcription-options.ts。十、如何验证与深入阅读仓库为ai-sdk/fal提供了完整的单元测试与快照测试是理解各模型行为边界的首选材料fal-image-model.test.ts图像生成的请求体构造、尺寸/宽高比解析、NSFW 元数据归一化、废弃 snake_case 警告等fal-speech-model.test.ts、fal-video-model.test.ts、fal-transcription-model.test.ts分别覆盖三类模型的参数映射与流程fal-provider.test.tsProvider 实例与 API Key 加载逻辑snapshots与fixtures记录真实请求/响应样例含转写队列的 JSON fixture。运行测试的命令在 package.json 中定义pnpm test会同时执行 Node 与 Edge 两套 vitest 配置vitest.node.config.js、vitest.edge.config.js。结语ai-sdk/fal以极小的学习成本将 fal.ai 的图像生成、编辑、视频、语音与转写能力统一收编进 AI SDK 的模型抽象体系。核心用法只需三件事安装ai-sdk/fal、配置 API Key、用fal.image(model-id)搭配generateImage调用进阶能力则集中在providerOptions.fal的透传参数、size/aspectRatio尺寸控制以及files/mask编辑输入上。借助仓库源码你可以精确把握每个参数如何映射到 fal API、哪些写法已被标记废弃从而写出更健壮、更易维护的多模态生成应用。【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考