获取请求结果
GET /fal-ai/{model_name}/requests/{request_id}
查询 Fal.ai 异步任务结果,返回图片或视频输出。
请求参数 (Query / Path)
string
required
模型名称,auto 我们系统会自动判断model_name
string
required
任务id
请求示例 (cURL)
响应示例 (200 OK)
查询 Fal.ai 任务
GET /fal-ai/*modelpath
通用查询接口,路径格式 GET /fal-ai//requests/“。request_id 为路径末段。
通用查询接口,路径格式 GET /fal-ai//requests/“。
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/veo3/requests/
GET /fal-ai/veo3/requests/{request_id}
查询 Veo3 视频生成任务状态与结果。
请求参数 (Query / Path)
string
required
请求追踪 ID
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/bytedance/seedream/v4/edit
POST /fal-ai/bytedance/seedream/v4/edit
官方文档: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit
请求体参数 (Body)
boolean
启用安全检查,默认值:true
object
图片尺寸,宽高取值范围必须在:1024-4096.
array
required
图片url
integer
生成图片数量:1-6
string
required
提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/bytedance/seedream/v4/text-to-image
POST /fal-ai/bytedance/seedream/v4/text-to-image
官方文档: https://fal.ai/models/fal-ai/bytedance/seedream/v4/text-to-image
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-1/dev/image-to-image
POST /fal-ai/flux-1/dev/image-to-image
官方文档: https://fal.ai/models/fal-ai/flux-1/dev/image-to-image
请求体参数 (Body)
string
生成速度。速度越高,生成速度越快。默认值:“regular” 支持default、none、regular、high
boolean
是否启用安全检查
number
CFG(无分类器引导)量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 范围值1-20
string
required
在此处拖放文件,或提供 base64 编码的数据 URL接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
生成的图像数量。默认值:1 范围值1-4
integer
要执行的推理步骤数。默认值:40 范围值10-50
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
string
required
生成图像的提示
number
初始图像的强度。强度值越高,该模型的效果越好。默认值:0.95 范围值0.01-1
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-1/dev/redux
POST /fal-ai/flux-1/dev/redux
官方文档: https://fal.ai/models/fal-ai/flux-1/dev/redux
请求体参数 (Body)
string
生成速度。速度越高,生成速度越快。默认值:“regular” 支持default、none、regular、high
boolean
如果设置为 true,则启用安全检查器。默认值:true
number
CFG(无分类器引导)量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 范围值1-20
string
生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16)
string
required
在此处拖放文件,或提供 base64 编码的数据 URL接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
生成的图像数量。默认值:1 范围值1-4
integer
要执行的推理步骤数。默认值:28 范围值:1-50
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-1/dev
POST /fal-ai/flux-1/dev
官方文档: https://fal.ai/models/fal-ai/flux-1/dev
请求体参数 (Body)
string
生成速度。速度越高,生成速度越快。默认值:“regular” 。支持:default、none、regular、high
boolean
如果设置为 true,则启用安全检查器。默认值:true
number
CFG(无分类器引导)量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 .范围值:1-20
string
生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16)
integer
生成的图像数量。默认值:1 范围值:1-4
integer
要执行的推理步骤数。默认值:28 .范围值:0-50
string
生成图片的格式。默认值:“jpeg” .支持的格式default、JPEG、png
string
required
文本提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-1/schnell/redux
POST /fal-ai/flux-1/schnell/redux
官方文档: https://fal.ai/models/fal-ai/flux-1/schnell/redux
请求体参数 (Body)
string
生成速度。速度越高,生成速度越快。默认值:“regular” 支持default、none、regular、high
boolean
如果设置为 true,则启用安全检查器。默认值:true
string
生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16)
string
required
在此处拖放文件,或提供 base64 编码的数据 URL接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
生成的图像数量。默认值:1 范围值1-4
integer
要执行的推理步骤数。默认值:4 范围值:1-12
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-1/schnell
POST /fal-ai/flux-1/schnell
官方文档: https://fal.ai/models/fal-ai/flux-1/schnell
请求体参数 (Body)
string
生成速度。速度越高,生成速度越快。默认值:“regular” 。支持:default、none、regular、high
boolean
如果设置为 true,则启用安全检查器。默认值:true
number
CFG(无分类器引导)量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 .范围值:1-20
string
生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16)
integer
生成的图像数量。默认值:1 范围值:1-4
integer
要执行的推理步骤数。默认值:28 .范围值:0-50
string
生成图片的格式。默认值:“jpeg” .支持的格式default、JPEG、png
string
required
文本提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-lora/image-to-image
POST /fal-ai/flux-lora/image-to-image
官方文档: https://fal.ai/models/fal-ai/flux-lora/image-to-image
请求体参数 (Body)
boolean
启用安全检查,默认值:true
number
范围值:0-35
string
required
图片url,接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
图片数量,范围值:1-4
integer
范围值:1-50
string
输出图片格式,支持:jpeg、png
string
required
提示词
number
强度,范围值:0.01-1
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-lora/inpainting
POST /fal-ai/flux-lora/inpainting
官方文档: https://fal.ai/models/fal-ai/flux-lora/inpainting
请求体参数 (Body)
boolean
启用安全检查,默认值:true
number
范围值:0-35
string
required
图片url,接受的文件类型:jpg、jpeg、png、webp、gif、avif
string
required
蒙版url,接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
图片数量,范围值:1-4
integer
范围值:1-50
string
输出图片格式,支持:jpeg、png
string
required
提示词
number
强度,范围值:0.01-1
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-lora
POST /fal-ai/flux-lora
官方文档: https://fal.ai/models/fal-ai/flux-lora
请求体参数 (Body)
boolean
启用安全检查,默认值:true
number
范围值:0-35
string
图片尺寸,枚举值:square、square pro、landscape_4_3、landscape_16_9、portrait_3_4
integer
图片数量,范围值:1-4
integer
范围值:1-50
string
输出图片格式,支持:jpeg、png
string
required
提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext/max/multi
POST /fal-ai/flux-pro/kontext/max/multi
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext/max/multi
请求体参数 (Body)
number
范围值:1-20
array
required
图片URL
integer
生成图片数量,范围值:1-4
string
图片输出格式:“jpeg”,“png”
string
required
提示词
string
安全容差
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext/max/text-to-image
POST /fal-ai/flux-pro/kontext/max/text-to-image
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext/max/text-to-image
请求体参数 (Body)
string
生成图像的宽高比。默认值:“1:1” 支持:21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21
number
CFG(无分类器引导)量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 范围值1-20
integer
生成的图像数量。默认值:1 范围值1-4
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
string
required
生成图像的提示。
string
生成图像的安全容差等级。1 表示最严格,5 表示最宽松。默认值:“2”
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext/max
POST /fal-ai/flux-pro/kontext/max
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext/max
请求体参数 (Body)
string
图片尺寸,枚举值:21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21
number
范围值:1-20
string
required
图片URL
integer
输出图片数量,范围值:1-4
string
required
图片输出格式:“jpeg”,“png”
string
required
提示词
string
安全容差
integer
随机种子;相同种子便于复现
boolean
同步模式
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext/multi
POST /fal-ai/flux-pro/kontext/multi
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext/multi
请求体参数 (Body)
number
范围值:1-20
array
required
图片URL
integer
生成图片数量,范围值:1-4
string
图片输出格式:“jpeg”,“png”
string
required
提示词
string
安全容差
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext/text-to-image
POST /fal-ai/flux-pro/kontext/text-to-image
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext/text-to-image
请求体参数 (Body)
string
生成图像的宽高比。默认值:“1:1” 支持:21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21
number
CFG(无分类器引导)量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 范围值1-20
integer
生成的图像数量。默认值:1 范围值1-4
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
string
required
生成图像的提示。
string
生成图像的安全容差等级。1 表示最严格,5 表示最宽松。默认值:“2”
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/flux-pro/kontext
POST /fal-ai/flux-pro/kontext
官方文档: https://fal.ai/models/fal-ai/flux-pro/kontext
请求体参数 (Body)
number
CFG(无分类器引导)量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 范围值1-20
string
required
在此处拖放文件,或提供 base64 编码的数据 URL接受的文件类型:jpg、jpeg、png、webp、gif、avif
integer
生成的图像数量。默认值:1 范围值1-4
string
生成图片的格式。默认值:“jpeg” 支持default、png、jpeg
string
required
生成图像的提示
string
生成图像的安全容差等级。1 表示最严格,5 表示最宽松。默认值:“2”
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/imagen4/preview
POST /fal-ai/imagen4/preview
官方文档: https://fal.ai/models/fal-ai/imagen4/preview
请求体参数 (Body)
string
图片比例,枚举值:1:1、16:9、9:16、3:4、4:3
integer
生成图片数量,范围值:1-4
string
required
提示词
string
分辨率:枚举值:“1K”、“2K”
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/kling-video/v2.5-turbo/pro/image-to-video
POST /fal-ai/kling-video/v2.5-turbo/pro/image-to-video
官方文档: https://fal.ai/models/fal-ai/kling-video/v2.5-turbo/pro/image-to-video
请求体参数 (Body)
number
范围值:0-1
string
生成视频时长,枚举值:5、10
string
required
图片url,接受的文件类型:jpg、jpeg、png、webp、gif、avif
string
负向提示词(不希望出现的内容)
string
required
提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/kling-video/v2.5-turbo/pro/text-to-video
POST /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
请求体参数 (Body)
string
视频比例,枚举值:16:9,9:16,1:1
number
范围值:0-1
string
生成视频时长,枚举值:5、10
string
负向提示词(不希望出现的内容)
string
required
视频生成提示词。
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
提交 Fal.ai 任务
POST /fal-ai/*model
通用提交接口,路径格式 POST /fal-ai/“。不同模型请求体各异。
请求体参数 (Body)
number
引导系数
string
输出尺寸,如 square_hd、landscape_4_3
integer
生成图片数量
integer
推理步数
string
required
文本提示词(图像/视频模型常用)
integer
随机种子;相同种子便于复现
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/nano-banana/edit 图片编辑
POST /fal-ai/nano-banana/edit
官方文档: https://fal.ai/models/fal-ai/nano-banana/edit
请求体参数 (Body)
array
required
需要编辑的图片url。
integer
生成图片数量。范围值1-4。默认值:1
string
required
图像编辑的提示词。
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/nano-banana 文生图
POST /fal-ai/nano-banana
官方文档: https://fal.ai/models/fal-ai/nano-banana
请求体参数 (Body)
integer
生成图片数量。范围值1-4。默认值:1
string
required
生成图片的提示词。
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/qwen-image-edit-lora
POST /fal-ai/qwen-image-edit-lora
请求体参数 (Body)
string
图像生成的加速级别。枚举值: ‘none’, ‘regular’,‘high’
boolean
启用安全检查,默认值:true
integer
范围值:2-100
string
required
图片url
string
负向提示词(不希望出现的内容)
integer
生成图片数量,范围值:1-4
integer
范围值:2-100
string
输出图片格式,支持:jpeg、png
string
required
提示词
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/qwen-image-edit-plus
POST /fal-ai/qwen-image-edit-plus
官方文档: https://fal.ai/models/fal-ai/qwen-image-edit-plus
请求体参数 (Body)
boolean
启用安全检查,默认值:true
integer
范围值:0-20
string
图片尺寸,枚举值:square、square_hd、landscape_4_3、landscape_16_9、portrait_3_4、portrait_9_16
array
required
图片url
string
负向提示词(不希望出现的内容)
integer
生成图片数量,范围值:1-4
integer
范围值:2-100
string
输出图片格式,支持:jpeg、png
string
required
提示词。
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/veo3/fast/image-to-video
POST /fal-ai/veo3/fast/image-to-video
官方文档地址:https://fal.ai/models/fal-ai/veo3/fast/image-to-video
请求体参数 (Body)
string
生成视频的宽高比默认值:“auto”
string
生成视频的时长(以秒为单位)默认值:“8s”
boolean
是否为视频生成音频。如果为 false,则将减少 %33 的积分。默认值:true
string
required
要制作动画的输入图像的 URL。宽高比应为 720p 或更高分辨率,宽高比为 16:9。如果图像的纵横比不是 16:9,则会裁剪以适合。
string
required
描述图像应如何制作动画的文本提示
string
生成视频的分辨率默认值:“720p” 范围值[720p,1080p]
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/veo3/fast
POST /fal-ai/veo3/fast
官方文档地址:https://fal.ai/models/fal-ai/veo3/fast
请求体参数 (Body)
string
生成视频的宽高比。如果设置为 1:1,视频将被外绘。默认值:“16:9”,范围[16:9,9:16,1:1]
boolean
是否通过重写来自动尝试修复未通过内容策略或其他验证检查的提示默认值:true
string
生成视频的时长(以秒为单位)默认值:“8s”
boolean
是否增强视频生成默认值:true
boolean
是否为视频生成音频。如果为 false,则将减少 %33 的积分。默认值:true
string
required
描述要生成的视频的文本提示
string
生成视频的分辨率默认值:“720p” 范围值[720p,1080p]
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/veo3/image-to-video
POST /fal-ai/veo3/image-to-video
官方文档:https://fal.ai/models/fal-ai/veo3/image-to-video
请求体参数 (Body)
string
尺寸,枚举值:16:9、9:16、auto,默认值: “auto”
string
视频时长,默认值:“8s”
boolean
生成音频,默认值:true
string
required
参考图片URL
string
required
提示词
string
分辨率,枚举值:“720p”、“1080p”
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/veo3
POST /fal-ai/veo3
官方文档地址:https://fal.ai/models/fal-ai/veo3
请求体参数 (Body)
string
生成视频的宽高比。如果设置为 1:1,视频将被外绘。默认值:“16:9”,范围[16:9,9:16,1:1]
boolean
是否通过重写来自动尝试修复未通过内容策略或其他验证检查的提示默认值:true
string
生成视频的时长(以秒为单位)默认值:“8s”
boolean
是否增强视频生成默认值:true
boolean
是否为视频生成音频。如果为 false,则将减少 %33 的积分。默认值:true
string
required
文本提示词
string
生成视频的分辨率默认值:“720p” 范围值[720p,1080p]
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/vidu/reference-to-image
POST /fal-ai/vidu/reference-to-image
官方文档: https://fal.ai/models/fal-ai/vidu/reference-to-image
请求体参数 (Body)
string
图片比例,枚举值:1:1、16:9、9:16
string
required
提示词
array
required
参考图片url
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
/fal-ai/wan/v2.2-a14b/image-to-image
POST /fal-ai/wan/v2.2-a14b/image-to-image
官方文档: https://fal.ai/models/fal-ai/wan/v2.2-a14b/image-to-image
请求体参数 (Body)
string
图片生成速度,枚举值:“regular”,“none”
string
图片尺寸
boolean
启用提示扩展
boolean
启用安全检查,默认值:true
number
范围值:1-10
integer
范围值:1-10
string
图片输出格式:“jpeg”,“png”
string
required
图片URL
integer
范围值:2-40
string
required
提示词
integer
范围值:1-10
number
强度,范围值:0-1