name: fal-image-gen
description: "调用 fal.ai 模型 API 进行图像生成（文生图与图生图）。当用户要求集成 fal、构建请求、运行任务、处理身份验证或从 fal 模型 API 返回图像 URL 时使用。"

Fal 图像生成

概述

使用此技能实现对 fal 模型 API 的文生图或图生图调用。为确保正确性，请优先查阅当前文档，确认所选模型所需的输入/输出及身份验证要求。

快速开始

1. 从 fal 模型 API 文档中确定目标模型 ID。
2. 收集用户输入。
   - 文生图：prompt、可选的 negative_prompt、尺寸/宽高比、步数、种子、安全选项。
   - 图生图：源图像 URL、强度/去噪参数，以及上述提示词/选项。
3. 选择调用方式。
   - 若用户偏好 SDK：提供 Python 和/或 JavaScript 示例。
   - 若用户偏好 REST：提供 curl/HTTP 示例。
4. 执行请求并从响应中返回图像 URL。

工作流：文生图

1. 确定模型 ID 与模式。
   - 打开 fal 模型 API 文档，确认确切的输入字段和输出格式。
2. 验证输入。
   - 确保提示词非空，且尺寸/宽高比设置受模型支持。
3. 构建请求。
   - SDK：使用 input 对象调用 SDK 的 run/submit 方法。
   - REST：调用模型端点，JSON 请求体需符合模式定义。
4. 执行并解析输出。
   - 从模型定义的响应字段中提取图像 URL。
5. 返回 URL。
   - 提供清晰的 URL 列表，并注明用户要求的任何元数据（种子、尺寸等）。

工作流：图生图

1. 确定模型 ID 与模式。
2. 验证输入。
   - 确保源图像可通过 URL 访问（或已转换为所需格式）。
   - 根据文档确认强度/去噪参数的范围限制。
3. 构建请求。
   - 根据模型要求，包含源图像、提示词及其他选项。
4. 执行并解析输出。
   - 从模型定义的响应字段中提取图像 URL。
5. 返回 URL。

SDK 与 REST 使用指南

• 推荐使用 SDK，以简化身份验证和重试处理。
• 若用户需要原始 HTTP 示例，或在无 SDK 支持的环境中运行，则推荐使用 REST。
• 切勿硬编码 API 密钥。请遵循文档要求，使用环境变量或请求头名称。

基础示例（请根据文档填充）

以下仅为模板，使用前请根据文档替换占位符。

Python (SDK)

# 伪代码：请根据文档替换为确切的 fal SDK 导入与调用模式
import os
# from fal import client  # 或当前 SDK 导入语句

MODEL_ID = "<model-id-from-docs>"
input_data = {
    "prompt": "一张红狐狸的电影感照片",
    # "image_url": "https://..."  # 用于图生图
    # "negative_prompt": "...",
    # "width": 1024,
    # "height": 1024,
}

# result = client.run(MODEL_ID, input=input_data)
# urls = extract_urls(result)

JavaScript (SDK)

// 伪代码：请根据文档替换为确切的 fal SDK 导入与调用模式
// import { client } from "@fal-ai/client";

const MODEL_ID = "<model-id-from-docs>";
const input = {
  prompt: "a cinematic photo of a red fox",
  // image_url: "https://..." // 用于图生图
};

// const result = await client.run(MODEL_ID, { input });
// const urls = extractUrls(result);

REST (curl)

# 伪代码：请根据文档替换端点、请求头和载荷模式
curl -X POST "https://<fal-api-base>/<model-endpoint>" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a cinematic photo of a red fox"
  }'

资源

• references/fal-model-api-checklist.md：收集输入与验证响应的检查清单。
• references/fal-model-examples.md：文生图、图生图及 REST 使用的示例模板。