Back to Details

fal-ai-model-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Fal AI Model Search & Integration

Fal AI模型搜索与集成

Guide for searching and integrating Fal AI models from fal.ai platform.
来自fal.ai平台的Fal AI模型搜索与集成指南。

Workflow

工作流程

1. Search Models

1. 搜索模型

When user wants to find a model, use WebFetch to search:
https://fal.ai/explore/search?q=<search-query>
Process:
  1. Parse search results - look for model IDs in format 
    <namespace>/<model-name>
    (e.g., 
    fal-ai/flux-schnell
    , 
    xai/grok-imagine-image
    )
  2. Extract: model ID, category (text-to-image, image-to-image, etc.), description
  3. Present the found models to the user with:
    • Model name and category
    • Description
    • Playground link: 
      https://fal.ai/models/<full-model-id>
      (for xai: 
      https://fal.ai/models/xai/<model>
      ; others: 
      https://fal.ai/models/fal-ai/<model>
      )
  4. Wait for user confirmation on which model to use
Important: The full Model ID format depends on the model namespace:
Search ResultFull Model IDAPI Endpoint
xai/grok-imagine-image
xai/grok-imagine-image
https://fal.run/xai/grok-imagine-image
bytedance/seedream/v4.5/...
fal-ai/bytedance/seedream/v4.5/...
https://fal.run/fal-ai/bytedance/seedream/v4.5/...
flux-1/schnell
fal-ai/flux-1/schnell
https://fal.run/fal-ai/flux-1/schnell
Rule: 
xai/
models use their ID directly; all others need 
fal-ai/
prefix.
当用户需要查找模型时，使用WebFetch进行搜索：
https://fal.ai/explore/search?q=<search-query>
步骤：
  1. 解析搜索结果 - 查找格式为
    <namespace>/<model-name>
    的模型ID（例如：
    fal-ai/flux-schnell
    、
    xai/grok-imagine-image
    ）
  2. 提取：模型ID、类别（文本转图像、图像转图像等）、描述
  3. 向用户展示找到的模型，包含：
    • 模型名称和类别
    • 描述
    • 在线测试链接：
      https://fal.ai/models/<full-model-id>
      （xai模型：
      https://fal.ai/models/xai/<model>
      ；其他模型：
      https://fal.ai/models/fal-ai/<model>
      ）
  4. 等待用户确认要使用的模型
重要说明： 完整模型ID的格式取决于模型命名空间：
搜索结果完整模型IDAPI端点
xai/grok-imagine-image
xai/grok-imagine-image
https://fal.run/xai/grok-imagine-image
bytedance/seedream/v4.5/...
fal-ai/bytedance/seedream/v4.5/...
https://fal.run/fal-ai/bytedance/seedream/v4.5/...
flux-1/schnell
fal-ai/flux-1/schnell
https://fal.run/fal-ai/flux-1/schnell
规则： 
xai/
开头的模型直接使用其ID；所有其他模型需要添加
fal-ai/
前缀。

2. Get Model Details

2. 获取模型详情

Once user confirms a model, fetch its detailed information:
URL Pattern Rules:
Model Prefixllms.txt URLPlayground URLFull Model ID
xai/
https://fal.ai/models/xai/<name>/llms.txt
https://fal.ai/models/xai/<name>
xai/<name>
Others
https://fal.ai/models/fal-ai/<id>/llms.txt
https://fal.ai/models/fal-ai/<id>
fal-ai/<id>
Rule: If model ID starts with 
xai/
, do NOT prepend 
fal-ai/
. For all other models, prepend 
fal-ai/
.
Examples:
  • xai/grok-imagine-image
    → llms.txt: 
    .../models/xai/grok-imagine-image/llms.txt
    , Playground: 
    .../models/xai/grok-imagine-image
  • bytedance/seedream/v4.5/text-to-image
    → llms.txt: 
    .../models/fal-ai/bytedance/seedream/v4.5/text-to-image/llms.txt
    , Playground: 
    .../models/fal-ai/bytedance/seedream/v4.5/text-to-image
When presenting model details to user, always include:
  • Model ID
  • Playground link: For interactive testing
  • API endpoint: 
    https://fal.run/<full-model-id>
  • Documentation links: llms.txt, API docs (
    https://fal.ai/models/<full-model-id>/api
    )
Process:
  1. Parse the llms.txt content for:
    • Model capabilities and use cases
    • API endpoint and parameters
    • Code examples
    • Pricing information
  2. Present the key details to the user
  3. Confirm integration approach with user
用户确认模型后，获取其详细信息：
URL模式规则：
模型前缀llms.txt URL在线测试链接完整模型ID
xai/
https://fal.ai/models/xai/<name>/llms.txt
https://fal.ai/models/xai/<name>
xai/<name>
其他
https://fal.ai/models/fal-ai/<id>/llms.txt
https://fal.ai/models/fal-ai/<id>
fal-ai/<id>
规则： 如果模型ID以
xai/
开头，请勿添加
fal-ai/
前缀。对于所有其他模型，添加
fal-ai/
前缀。
示例：
  • xai/grok-imagine-image
    → llms.txt: 
    .../models/xai/grok-imagine-image/llms.txt
    ，在线测试链接: 
    .../models/xai/grok-imagine-image
  • bytedance/seedream/v4.5/text-to-image
    → llms.txt: 
    .../models/fal-ai/bytedance/seedream/v4.5/text-to-image/llms.txt
    ，在线测试链接: 
    .../models/fal-ai/bytedance/seedream/v4.5/text-to-image
向用户展示模型详情时，需始终包含：
  • 模型ID
  • 在线测试链接：用于交互式测试
  • API端点：
    https://fal.run/<full-model-id>
  • 文档链接：llms.txt、API文档（
    https://fal.ai/models/<full-model-id>/api
    ）
步骤：
  1. 解析llms.txt内容，提取：
    • 模型功能和使用场景
    • API端点和参数
    • 代码示例
    • 定价信息
  2. 向用户展示关键详情
  3. 与用户确认集成方式

3. Integration Guidelines

3. 集成指南

When integrating a Fal AI model:
  1. Check existing Fal client setup in the project
  2. Use the model ID returned from search (format: 
    fal-ai/<model-name>
    )
  3. Follow the API patterns shown in the llms.txt examples
  4. Add proper error handling for API calls
集成Fal AI模型时：
  1. 检查项目中现有的Fal客户端配置
  2. 使用搜索返回的模型ID（格式：
    fal-ai/<model-name>
    ）
  3. 遵循llms.txt示例中的API模式
  4. 为API调用添加适当的错误处理

4. User Confirmation Points

4. 用户确认节点

Always confirm with user at these stages:
  • After search results: "Found these models: [list with links]. Which one would you like to use?"
  • After model details: "Here are the details for [model] ([playground link]). Shall I proceed with integration?"
  • Before code changes: "I'll integrate [model] by [changes]. Does this look correct?"
Link format for presentation:
  • Use markdown format: 
    [description](url)
  • Always include the model's playground link so users can test it interactively
在以下阶段始终与用户确认：
  • 搜索结果展示后：“找到以下模型：[带链接的列表]。您想使用哪一个？”
  • 模型详情展示后：“这是[模型]的详情（[在线测试链接]）。是否继续集成？”
  • 代码修改前：“我将通过[修改内容]集成[模型]。这样是否正确？”
展示链接的格式：
  • 使用markdown格式：
    [描述](链接地址)
  • 始终包含模型的在线测试链接，方便用户进行交互式测试

Common Model Patterns

常见模型类型

Model TypeExample IDsUse Case
Text to Image
fal-ai/flux-schnell
, 
xai/grok-imagine-image
Generate images from text
Image to Image
fal-ai/flux-lora
, 
xai/grok-imagine-image/edit
Transform existing images
Video
fal-ai/ltx-video
, 
fal-ai/veo2
Generate video content
Audio
fal-ai/playht
, 
fal-ai/xtts
Text-to-speech, audio generation
模型类型示例ID使用场景
文本转图像
fal-ai/flux-schnell
, 
xai/grok-imagine-image
根据文本生成图像
图像转图像
fal-ai/flux-lora
, 
xai/grok-imagine-image/edit
转换现有图像
视频
fal-ai/ltx-video
, 
fal-ai/veo2
生成视频内容
音频
fal-ai/playht
, 
fal-ai/xtts
文本转语音、音频生成

Example Output Format

示例输出格式

When presenting search results to the user, use this format:
Found 3 models matching "flux":

1. **fal-ai/flux-schnell** (Text to Image)
   - Fastest Flux model for high-quality image generation
   - [Playground](https://fal.ai/models/fal-ai/flux-schnell) | [API Docs](https://fal.ai/models/fal-ai/flux-schnell/api)

2. **fal-ai/flux-pro/v1.1** (Text to Image)
   - Professional-grade image generation with superior quality
   - [Playground](https://fal.ai/models/fal-ai/flux-pro/v1.1) | [API Docs](https://fal.ai/models/fal-ai/flux-pro/v1.1/api)

Which model would you like to use?
向用户展示搜索结果时，使用以下格式：
找到3个匹配“flux”的模型：

1. **fal-ai/flux-schnell**（文本转图像）
   - 最快的Flux模型，用于生成高质量图像
   - [在线测试](https://fal.ai/models/fal-ai/flux-schnell) | [API文档](https://fal.ai/models/fal-ai/flux-schnell/api)

2. **fal-ai/flux-pro/v1.1**（文本转图像）
   - 专业级图像生成，质量卓越
   - [在线测试](https://fal.ai/models/fal-ai/flux-pro/v1.1) | [API文档](https://fal.ai/models/fal-ai/flux-pro/v1.1/api)

您想使用哪一个模型？

Error Handling

错误处理

ErrorCauseSolution
No search resultsQuery too specific or no matching modelsSuggest broader search terms or alternative keywords
Model not found (404)Wrong URL patternCheck if model starts with 
xai/
→ use 
/models/xai/...
URL; otherwise use 
/models/fal-ai/...
llms.txt returns emptyModel deprecated or unavailableInform user the model may be deprecated; suggest alternatives
API key error (401)Missing or invalid 
FAL_KEY
Check environment variable or prompt user to set 
FAL_KEY
Rate limit (429)Too many requestsImplement exponential backoff; suggest retry after delay
TimeoutModel inference taking too longFor async models, use 
fal.queue.submit
pattern with polling
错误原因解决方案
无搜索结果查询过于具体或无匹配模型建议使用更宽泛的搜索词或替代关键词
模型未找到（404）URL模式错误检查模型是否以
xai/
开头 → 使用
/models/xai/...
格式的URL；否则使用
/models/fal-ai/...
llms.txt返回空内容模型已弃用或不可用告知用户该模型可能已弃用；建议使用替代模型
API密钥错误（401）缺少或无效的
FAL_KEY
检查环境变量或提示用户设置
FAL_KEY
请求超限（429）请求次数过多实现指数退避机制；建议延迟后重试
超时模型推理耗时过长对于异步模型，使用
fal.queue.submit
模式并轮询结果

Notes

注意事项

  • The 
    llms.txt
    endpoint returns machine-readable documentation optimized for LLMs
  • Model IDs can have various prefixes: 
    fal-ai/
    , 
    xai/
    , etc. - always use the full ID from search results
  • Always present options to the user before making integration decisions
  • llms.txt
    端点返回针对LLM优化的机器可读文档
  • 模型ID可以有不同的前缀：
    fal-ai/
    、
    xai/
    等 - 始终使用搜索结果中的完整ID
  • 在做出集成决策前，始终向用户提供选项