fal.ai 文生图技能：使用 FLUX、Recraft V3 等模型从文本生成专业图像

fal-text-to-image by delorenj/skills

72 周安装量

9 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/delorenj/skills --skill fal-text-to-image

AI/机器学习内容创作图像处理

🇨🇳中文介绍

fal.ai 文生图技能

使用 fal.ai 先进的文生图模型（包括 FLUX、Recraft V3、Imagen4 等）从文本提示生成可用于生产的图像。

使用场景

当用户出现以下情况时触发：

请求根据文本描述生成图像
想要创建具有特定风格（矢量、写实、字体设计）的图像
需要高分辨率专业图像（最高 2K）
希望使用参考图像进行风格迁移
提及特定模型，如 FLUX、Recraft 或 Imagen
要求生成徽标、海报或品牌风格图像

快速开始

基本用法

uv run python fal-text-to-image "日落时分的赛博朋克城市，霓虹闪烁"

指定模型

uv run python fal-text-to-image -m flux-pro/v1.1-ultra "商务高管的专业肖像照"

使用风格参考图像

uv run python fal-text-to-image -i reference.jpg "山景" -m flux-2/lora/edit

模型选择指南

脚本会根据任务上下文智能选择最佳模型：

flux-pro/v1.1-ultra (高分辨率默认选择)

最佳用途：专业摄影、高分辨率输出（最高 2K）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

recraft/v3/text-to-image (SOTA 质量)

最佳用途：字体设计、矢量艺术、品牌风格图像、长文本
优势：行业领先的基准测试分数、精确的文本渲染
使用时机：创建徽标、海报或文本密集的设计
端点：fal-ai/recraft/v3/text-to-image

flux-2 (最佳平衡)

最佳用途：通用图像生成
优势：增强的真实感、清晰的文本、原生编辑功能
使用时机：标准图像生成需求
端点：fal-ai/flux-2

flux-2/lora (自定义风格)

最佳用途：特定领域风格、微调变体
优势：自定义风格适配
使用时机：用户想要特定的艺术风格
端点：fal-ai/flux-2/lora

flux-2/lora/edit (风格迁移)

最佳用途：使用风格参考进行图生图编辑
优势：专业的风格迁移
使用时机：用户通过 -i 标志提供参考图像时
端点：fal-ai/flux-2/lora/edit

imagen4/preview (谷歌品质)

最佳用途：高质量通用图像
优势：谷歌最高质量模型
使用时机：用户特别请求 Imagen 或谷歌模型时
端点：fal-ai/imagen4/preview

stable-diffusion-v35-large (字体与风格)

最佳用途：复杂提示、字体设计、风格控制
优势：高级提示理解、资源效率高
使用时机：复杂的多元素构图
端点：fal-ai/stable-diffusion-v35-large

ideogram/v2 (字体设计专家)

最佳用途：海报、徽标、文本密集的设计
优势：卓越的字体设计、写实输出
使用时机：文本准确性至关重要时
端点：fal-ai/ideogram/v2

bria/text-to-image/3.2 (商业安全)

最佳用途：需要授权训练数据的商业项目
优势：可安全用于商业用途、优秀的文本渲染
使用时机：法律/授权问题重要时
端点：fal-ai/bria/text-to-image/3.2

uv run python fal-text-to-image [OPTIONS] PROMPT

参数：
  PROMPT                    要生成图像的文本描述

选项：
  -m, --model TEXT         使用的模型（见上方模型列表）
  -i, --image TEXT         用于风格迁移的参考图像路径或 URL
  -o, --output TEXT        输出文件名（默认：generated_image.png）
  -s, --size TEXT          图像尺寸（例如："1024x1024", "landscape_16_9"）
  --seed INTEGER           用于可重现性的随机种子
  --steps INTEGER          推理步数（取决于模型）
  --guidance FLOAT         引导尺度（越高越遵循提示）
  --help                   显示此帮助信息并退出

首次使用前，请设置您的 fal.ai API 密钥：

export FAL_KEY="your-api-key-here"

或者在技能目录中创建 .env 文件：

FAL_KEY=your-api-key-here

从以下网址获取您的 API 密钥：https://fal.ai/dashboard/keys

高分辨率专业照片

uv run python fal-text-to-image \
  -m flux-pro/v1.1-ultra \
  "现代办公室中商务高管的专业肖像照" \
  -s 2048x2048

uv run python fal-text-to-image \
  -m recraft/v3/text-to-image \
  "现代科技初创公司徽标，带有极简主义风格的 'AI Labs' 文字"

从参考图像进行风格迁移

uv run python fal-text-to-image \
  -m flux-2/lora/edit \
  -i artistic_style.jpg \
  "花园中的女性肖像"

uv run python fal-text-to-image \
  -m flux-2 \
  --seed 42 \
  "带有飞行汽车的未来主义城市景观"

当未指定 -m 时，脚本会自动选择最佳模型：

如果提供了 -i：使用 flux-2/lora/edit 进行风格迁移
如果提示包含字体设计关键词（徽标、文本、海报、标志）：使用 recraft/v3/text-to-image
如果提示表明需要高分辨率（专业、肖像、头像）：使用 flux-pro/v1.1-ultra
如果提示提及矢量/品牌：使用 recraft/v3/text-to-image
默认情况：使用 flux-2 进行通用目的生成

生成的图像会附带元数据保存：

文件名包含时间戳和模型名称
EXIF 数据存储提示、模型和参数
控制台显示生成时间和成本估算

问题	解决方案
`FAL_KEY 未设置`	导出 FAL_KEY 环境变量或创建 .env 文件
`找不到模型`	根据支持的列表检查模型名称
`图像参考失败`	确保图像路径/URL 可访问
`生成超时`	某些模型耗时较长；请等待或尝试更快的模型
`速率限制错误`	检查 fal.ai 仪表板了解使用限制

免费层级：FLUX.2 提供 100 次免费请求（有效期至 2025 年 12 月 25 日）
按使用付费：FLUX Pro 按每百万像素计费
预算选项：通用用途使用 flux-2 或 stable-diffusion-v35-large
高级选项：仅在需要高分辨率时使用 flux-pro/v1.1-ultra

fal-text-to-image/
├── SKILL.md                    # 本文档
├── pyproject.toml              # 依赖项 (uv)
├── fal-text-to-image           # 主可执行脚本
├── references/
│   └── model-comparison.md     # 详细的模型基准测试
└── outputs/                    # 生成的图像（首次运行时创建）

通过 uv 管理：

fal-client：官方 fal.ai Python SDK
python-dotenv：环境变量管理
pillow：图像处理和 EXIF 元数据
click：CLI 界面

模型选择：除非有特定需求，否则让脚本自动选择
参考图像：使用高质量的参考图像以获得最佳风格迁移效果
提示工程：提示要具体和描述性，以获得更好的输出
成本意识：在 fal.ai 仪表板上监控使用情况
可重现性：在迭代过程中使用 --seed 以获得一致的结果

需要有效的 fal.ai API 密钥
受 fal.ai 速率限制和配额约束
需要互联网连接
某些模型有使用成本（请查看定价）
图像参考功能仅限于特定模型

2026 年 1 月 24 日

🇺🇸English

fal.ai Text-to-Image Generation Skill

Generate production-quality images from text prompts using fal.ai's state-of-the-art text-to-image models including FLUX, Recraft V3, Imagen4, and more.

When to Use This Skill

Trigger when user:

Requests image generation from text descriptions
Wants to create images with specific styles (vector, realistic, typography)
Needs high-resolution professional images (up to 2K)
Wants to use a reference image for style transfer
Mentions specific models like FLUX, Recraft, or Imagen
Asks for logo, poster, or brand-style image generation

Quick Start

Basic Usage

uv run python fal-text-to-image "A cyberpunk city at sunset with neon lights"

With Specific Model

uv run python fal-text-to-image -m flux-pro/v1.1-ultra "Professional headshot of a business executive"

With Style Reference Image

uv run python fal-text-to-image -i reference.jpg "A mountain landscape" -m flux-2/lora/edit

Model Selection Guide

The script intelligently selects the best model based on task context:

flux-pro/v1.1-ultra (Default for High-Res)

Best for : Professional photography, high-resolution outputs (up to 2K)
Strengths : Photo realism, professional quality
Use when : User needs publication-ready images
Endpoint : fal-ai/flux-pro/v1.1-ultra

recraft/v3/text-to-image (SOTA Quality)

Best for : Typography, vector art, brand-style images, long text
Strengths : Industry-leading benchmark scores, precise text rendering
Use when : Creating logos, posters, or text-heavy designs
Endpoint : fal-ai/recraft/v3/text-to-image

flux-2 (Best Balance)

Best for : General-purpose image generation
Strengths : Enhanced realism, crisp text, native editing
Use when : Standard image generation needs
Endpoint : fal-ai/flux-2

flux-2/lora (Custom Styles)

Best for : Domain-specific styles, fine-tuned variations
Strengths : Custom style adaptation
Use when : User wants specific artistic styles
Endpoint : fal-ai/flux-2/lora

flux-2/lora/edit (Style Transfer)

Best for : Image-to-image editing with style references
Strengths : Specialized style transfer
Use when : User provides reference image with -i flag
Endpoint : fal-ai/flux-2/lora/edit

imagen4/preview (Google Quality)

Best for : High-quality general images
Strengths : Google's highest quality model
Use when : User specifically requests Imagen or Google models
Endpoint : fal-ai/imagen4/preview

stable-diffusion-v35-large (Typography & Style)

Best for : Complex prompts, typography, style control
Strengths : Advanced prompt understanding, resource efficiency
Use when : Complex multi-element compositions
Endpoint : fal-ai/stable-diffusion-v35-large

ideogram/v2 (Typography Specialist)

Best for : Posters, logos, text-heavy designs
Strengths : Exceptional typography, realistic outputs
Use when : Text accuracy is critical
Endpoint : fal-ai/ideogram/v2

bria/text-to-image/3.2 (Commercial Safe)

Best for : Commercial projects requiring licensed training data
Strengths : Safe for commercial use, excellent text rendering
Use when : Legal/licensing concerns matter
Endpoint : fal-ai/bria/text-to-image/3.2

Command-Line Interface

uv run python fal-text-to-image [OPTIONS] PROMPT

Arguments:
  PROMPT                    Text description of the image to generate

Options:
  -m, --model TEXT         Model to use (see model list above)
  -i, --image TEXT         Path or URL to reference image for style transfer
  -o, --output TEXT        Output filename (default: generated_image.png)
  -s, --size TEXT          Image size (e.g., "1024x1024", "landscape_16_9")
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps (model-dependent)
  --guidance FLOAT         Guidance scale (higher = more prompt adherence)
  --help                   Show this message and exit

Authentication Setup

Before first use, set your fal.ai API key:

export FAL_KEY="your-api-key-here"

Or create a .env file in the skill directory:

FAL_KEY=your-api-key-here

Get your API key from: https://fal.ai/dashboard/keys

Advanced Examples

High-Resolution Professional Photo

uv run python fal-text-to-image \
  -m flux-pro/v1.1-ultra \
  "Professional headshot of a business executive in modern office" \
  -s 2048x2048

Logo/Typography Design

uv run python fal-text-to-image \
  -m recraft/v3/text-to-image \
  "Modern tech startup logo with text 'AI Labs' in minimalist style"

Style Transfer from Reference

uv run python fal-text-to-image \
  -m flux-2/lora/edit \
  -i artistic_style.jpg \
  "Portrait of a woman in a garden"

Reproducible Generation

uv run python fal-text-to-image \
  -m flux-2 \
  --seed 42 \
  "Futuristic cityscape with flying cars"

Model Selection Logic

The script automatically selects the best model when -m is not specified:

If-i provided: Uses flux-2/lora/edit for style transfer
If prompt contains typography keywords (logo, text, poster, sign): Uses recraft/v3/text-to-image
If prompt suggests high-res needs (professional, portrait, headshot): Uses flux-pro/v1.1-ultra
If prompt mentions vector/brand : Uses recraft/v3/text-to-image
Default : Uses flux-2 for general purpose

Output Format

Generated images are saved with metadata:

Filename includes timestamp and model name
EXIF data stores prompt, model, and parameters
Console displays generation time and cost estimate

Troubleshooting

Problem	Solution
`FAL_KEY not set`	Export FAL_KEY environment variable or create .env file
`Model not found`	Check model name against supported list
`Image reference fails`	Ensure image path/URL is accessible
`Generation timeout`	Some models take longer; wait or try faster model
`Rate limit error`	Check fal.ai dashboard for usage limits

Cost Optimization

Free tier : FLUX.2 offers 100 free requests (expires Dec 25, 2025)
Pay per use : FLUX Pro charges per megapixel
Budget option : Use flux-2 or stable-diffusion-v35-large for general use
Premium : Use flux-pro/v1.1-ultra only when high-res is required

File Structure

fal-text-to-image/
├── SKILL.md                    # This file
├── pyproject.toml              # Dependencies (uv)
├── fal-text-to-image           # Main executable script
├── references/
│   └── model-comparison.md     # Detailed model benchmarks
└── outputs/                    # Generated images (created on first run)

Dependencies

Managed via uv:

fal-client: Official fal.ai Python SDK
python-dotenv: Environment variable management
pillow: Image handling and EXIF metadata
click: CLI interface

Best Practices

Model Selection : Let the script auto-select unless you have specific needs
Reference Images : Use high-quality references for best style transfer results
Prompt Engineering : Be specific and descriptive for better outputs
Cost Awareness : Monitor usage on fal.ai dashboard
Reproducibility : Use --seed for consistent results during iteration

Resources

fal.ai Documentation: https://docs.fal.ai/
Model Playground: https://fal.ai/explore/search
API Keys: https://fal.ai/dashboard/keys
Pricing: https://fal.ai/pricing

Limitations

Requires active fal.ai API key
Subject to fal.ai rate limits and quotas
Internet connection required
Some models have usage costs (check pricing)
Image reference features limited to specific models

Weekly Installs

Repository

delorenj/skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode62

gemini-cli61

codex61

cursor59

github-copilot59

amp57

AI 代码实施计划编写技能 | 自动化开发任务分解与 TDD 流程规划工具

50,900 周安装