> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Fal.ai 生图接口参考

> Fal.ai 高性能开源与商业模型生图端点

## 获取请求结果

`GET /fal-ai/{model_name}/requests/{request_id}`

查询 Fal.ai 异步任务结果，返回图片或视频输出。

### 请求参数 (Query / Path)

<ParamField path="model_name" type="string" required>
  模型名称,auto 我们系统会自动判断model\_name
</ParamField>

<ParamField path="request_id" type="string" required>
  任务id
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/fal-ai/{model_name}/requests/{request_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "has_nsfw_concepts": [
    false
  ],
  "images": [
    {
      "content_type": "image/jpeg",
      "height": 1024,
      "url": "https://fal.media/files/tiger/BwdOcvXOx0UmkCyCMZGmZ_1ee10db761e146a28fdaadafa528d239.jpg",
      "width": 1024
    }
  ],
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "request": {
    "guidance_scale": 3.5,
    "image_urls": [
      "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
      "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
    ],
    "num_images": 1,
    "output_format": "jpeg",
    "prompt": "Put the little duckling on top of the woman's t-shirt.",
    "safety_tolerance": "2"
  },
  "seed": 2841475369,
  "timings": {}
}
```

***

## 查询 Fal.ai 任务

`GET /fal-ai/*modelpath`

通用查询接口，路径格式 `GET /fal-ai/`{`model`}`/requests/`{`request_id`}\`\`。request\_id 为路径末段。

通用查询接口，路径格式 `GET /fal-ai/`{`model`}`/requests/`{`request_id`}\`\`。

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/fal-ai/*modelpath" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "request_id": "req_example",
  "status": "OK"
}
```

***

## /fal-ai/veo3/requests/{request_id}

`GET /fal-ai/veo3/requests/{request_id}`

查询 Veo3 视频生成任务状态与结果。

### 请求参数 (Query / Path)

<ParamField path="request_id" type="string" required>
  请求追踪 ID
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/fal-ai/veo3/requests/{request_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "request_id": "req_example",
  "status": "OK"
}
```

***

## /fal-ai/bytedance/seedream/v4/edit

`POST /fal-ai/bytedance/seedream/v4/edit`

官方文档: [https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit](https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit)

### 请求体参数 (Body)

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="image_size" type="object">
  图片尺寸，宽高取值范围必须在：1024-4096.
</ParamField>

<ParamField body="image_urls" type="array" required>
  图片url
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量：1-6
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "image_size": {
    "height": 1280,
    "width": 1280
  },
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ],
  "num_images": 1,
  "prompt": "Dress the model in the clothes and shoes."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/bytedance/seedream/v4/edit" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "image_size": {
    "height": 1280,
    "width": 1280
  },
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ],
  "num_images": 1,
  "prompt": "Dress the model in the clothes and shoes."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "42a7eb80-8916-43ae-b27b-02e79f479977",
  "response_url": "https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/bytedance/seedream/v4/text-to-image)

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "image_size": {
    "height": 1280,
    "width": 1280
  },
  "num_images": 1,
  "prompt": "Draw a chart showing the typical vegetation distribution in four different climate zones: tropical rainforest, temperate forest, desert, and tundra."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/bytedance/seedream/v4/text-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "image_size": {
    "height": 1280,
    "width": 1280
  },
  "num_images": 1,
  "prompt": "Draw a chart showing the typical vegetation distribution in four different climate zones: tropical rainforest, temperate forest, desert, and tundra."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/flux-1/dev/image-to-image)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  生成速度。速度越高，生成速度越快。默认值："regular"  支持default、none、regular、high
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  是否启用安全检查
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  范围值1-20
</ParamField>

<ParamField body="image_url" type="string" required>
  在此处拖放文件，或提供 base64 编码的数据 URL接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  要执行的推理步骤数。默认值：40   范围值10-50
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

<ParamField body="prompt" type="string" required>
  生成图像的提示
</ParamField>

<ParamField body="strength" type="number">
  初始图像的强度。强度值越高，该模型的效果越好。默认值：0.95  范围值0.01-1
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://fal.media/files/koala/Chls9L2ZnvuipUTEwlnJC.png",
  "num_images": 1,
  "num_inference_steps": 40,
  "output_format": "jpeg",
  "prompt": "A cat dressed as a wizard with a background of a mystic forest.",
  "strength": 0.95
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-1/dev/image-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://fal.media/files/koala/Chls9L2ZnvuipUTEwlnJC.png",
  "num_images": 1,
  "num_inference_steps": 40,
  "output_format": "jpeg",
  "prompt": "A cat dressed as a wizard with a background of a mystic forest.",
  "strength": 0.95
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-1/dev/redux

`POST /fal-ai/flux-1/dev/redux`

官方文档: [https://fal.ai/models/fal-ai/flux-1/dev/redux](https://fal.ai/models/fal-ai/flux-1/dev/redux)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  生成速度。速度越高，生成速度越快。默认值："regular"  支持default、none、regular、high
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  如果设置为 true，则启用安全检查器。默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  范围值1-20
</ParamField>

<ParamField body="image_size" type="string">
  生成图像的大小。默认值：landscape\_4\_3 范围（3：4、4：3、16：9、9：16）
</ParamField>

<ParamField body="image_url" type="string" required>
  在此处拖放文件，或提供 base64 编码的数据 URL接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  要执行的推理步骤数。默认值：28 范围值：1-50
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "image_url": "https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-1/dev/redux" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "image_url": "https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-1/dev

`POST /fal-ai/flux-1/dev`

官方文档: [https://fal.ai/models/fal-ai/flux-1/dev](https://fal.ai/models/fal-ai/flux-1/dev)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  生成速度。速度越高，生成速度越快。默认值："regular"  。支持：default、none、regular、high
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  如果设置为 true，则启用安全检查器。默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  .范围值：1-20
</ParamField>

<ParamField body="image_size" type="string">
  生成图像的大小。默认值：landscape\_4\_3 范围（3：4、4：3、16：9、9：16）
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1  范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  要执行的推理步骤数。默认值：28  .范围值：0-50
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  .支持的格式default、JPEG、png
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-1/dev" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "3892f1e8-5fb1-469f-87b0-696d6054c9f2",
  "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status"
}
```

***

## /fal-ai/flux-1/schnell/redux

`POST /fal-ai/flux-1/schnell/redux`

官方文档: [https://fal.ai/models/fal-ai/flux-1/schnell/redux](https://fal.ai/models/fal-ai/flux-1/schnell/redux)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  生成速度。速度越高，生成速度越快。默认值："regular"  支持default、none、regular、high
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  如果设置为 true，则启用安全检查器。默认值：true
</ParamField>

<ParamField body="image_size" type="string">
  生成图像的大小。默认值：landscape\_4\_3 范围（3：4、4：3、16：9、9：16）
</ParamField>

<ParamField body="image_url" type="string" required>
  在此处拖放文件，或提供 base64 编码的数据 URL接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  要执行的推理步骤数。默认值：4 范围值：1-12
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "image_size": "landscape_4_3",
  "image_url": "https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png",
  "num_images": 1,
  "num_inference_steps": 4,
  "output_format": "jpeg"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-1/schnell/redux" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "image_size": "landscape_4_3",
  "image_url": "https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png",
  "num_images": 1,
  "num_inference_steps": 4,
  "output_format": "jpeg"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-1/schnell

`POST /fal-ai/flux-1/schnell`

官方文档: [https://fal.ai/models/fal-ai/flux-1/schnell](https://fal.ai/models/fal-ai/flux-1/schnell)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  生成速度。速度越高，生成速度越快。默认值："regular"  。支持：default、none、regular、high
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  如果设置为 true，则启用安全检查器。默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  .范围值：1-20
</ParamField>

<ParamField body="image_size" type="string">
  生成图像的大小。默认值：landscape\_4\_3 范围（3：4、4：3、16：9、9：16）
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1  范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  要执行的推理步骤数。默认值：28  .范围值：0-50
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  .支持的格式default、JPEG、png
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-1/schnell" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "3892f1e8-5fb1-469f-87b0-696d6054c9f2",
  "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/flux-lora/image-to-image)

### 请求体参数 (Body)

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  范围值：0-35
</ParamField>

<ParamField body="image_url" type="string" required>
  图片url，接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  图片数量，范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：1-50
</ParamField>

<ParamField body="output_format" type="string">
  输出图片格式，支持：jpeg、png
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="strength" type="number">
  强度，范围值：0.01-1
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/dog.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "A photo of a lion sitting on a stone bench",
  "strength": 0.85
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-lora/image-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/dog.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "A photo of a lion sitting on a stone bench",
  "strength": 0.85
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "9b54828d-3c2b-4e0e-ac8c-ac234504015e",
  "response_url": "https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e/status"
}
```

***

## /fal-ai/flux-lora/inpainting

`POST /fal-ai/flux-lora/inpainting`

官方文档: [https://fal.ai/models/fal-ai/flux-lora/inpainting](https://fal.ai/models/fal-ai/flux-lora/inpainting)

### 请求体参数 (Body)

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  范围值：0-35
</ParamField>

<ParamField body="image_url" type="string" required>
  图片url，接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="mask_url" type="string" required>
  蒙版url，接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  图片数量，范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：1-50
</ParamField>

<ParamField body="output_format" type="string">
  输出图片格式，支持：jpeg、png
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="strength" type="number">
  强度，范围值：0.01-1
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/dog.png",
  "mask_url": "https://storage.googleapis.com/falserverless/example_inputs/dog_mask.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "A photo of a lion sitting on a stone bench",
  "strength": 0.85
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-lora/inpainting" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/dog.png",
  "mask_url": "https://storage.googleapis.com/falserverless/example_inputs/dog_mask.png",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "A photo of a lion sitting on a stone bench",
  "strength": 0.85
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-lora

`POST /fal-ai/flux-lora`

官方文档: [https://fal.ai/models/fal-ai/flux-lora](https://fal.ai/models/fal-ai/flux-lora)

### 请求体参数 (Body)

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  范围值：0-35
</ParamField>

<ParamField body="image_size" type="string">
  图片尺寸，枚举值：square、square pro、landscape\_4\_3、landscape\_16\_9、portrait\_3\_4
</ParamField>

<ParamField body="num_images" type="integer">
  图片数量，范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：1-50
</ParamField>

<ParamField body="output_format" type="string">
  输出图片格式，支持：jpeg、png
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-lora" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_images": 1,
  "num_inference_steps": 28,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "07e0be22-3380-4699-a377-48729443435c",
  "response_url": "https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/flux-pro/kontext/max/multi)

### 请求体参数 (Body)

<ParamField body="guidance_scale" type="number">
  范围值：1-20
</ParamField>

<ParamField body="image_urls" type="array" required>
  图片URL
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量，范围值：1-4
</ParamField>

<ParamField body="output_format" type="string">
  图片输出格式："jpeg"，"png"
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="safety_tolerance" type="string">
  安全容差
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "guidance_scale": 3.5,
  "image_urls": [
    "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
    "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
  ],
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "safety_tolerance": "2"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext/max/multi" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "guidance_scale": 3.5,
  "image_urls": [
    "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
    "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
  ],
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "safety_tolerance": "2"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "30bc4aeb-0543-4198-929c-da97da4d14c9",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/flux-pro/kontext/max/text-to-image)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  生成图像的宽高比。默认值："1:1"   支持：21：9、16：9、4：3、3：2、1：1、2：3、3：4、9：16、9：21
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  范围值1-20
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

<ParamField body="prompt" type="string" required>
  生成图像的提示。
</ParamField>

<ParamField body="safety_tolerance" type="string">
  生成图像的安全容差等级。1 表示最严格，5 表示最宽松。默认值："2"
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "1:1",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "safety_tolerance": "2"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext/max/text-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "safety_tolerance": "2"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-pro/kontext/max

`POST /fal-ai/flux-pro/kontext/max`

官方文档:  [https://fal.ai/models/fal-ai/flux-pro/kontext/max](https://fal.ai/models/fal-ai/flux-pro/kontext/max)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  图片尺寸，枚举值：21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21
</ParamField>

<ParamField body="guidance_scale" type="number">
  范围值：1-20
</ParamField>

<ParamField body="image_url" type="string" required>
  图片URL
</ParamField>

<ParamField body="num_images" type="integer">
  输出图片数量，范围值：1-4
</ParamField>

<ParamField body="output_format" type="string" required>
  图片输出格式："jpeg"，"png"
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="safety_tolerance" type="string">
  安全容差
</ParamField>

<ParamField body="seed" type="integer">
  随机种子；相同种子便于复现
</ParamField>

<ParamField body="sync_mode" type="boolean">
  同步模式
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "string",
  "guidance_scale": 3.5,
  "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put a donut next to the flour.",
  "safety_tolerance": "2",
  "seed": 0,
  "sync_mode": false
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext/max" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "string",
  "guidance_scale": 3.5,
  "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put a donut next to the flour.",
  "safety_tolerance": "2",
  "seed": 0,
  "sync_mode": false
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "e36fc67f-afa7-416a-a288-50d90a630d7a",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a/status"
}
```

***

## /fal-ai/flux-pro/kontext/multi

`POST /fal-ai/flux-pro/kontext/multi`

官方文档: [https://fal.ai/models/fal-ai/flux-pro/kontext/multi](https://fal.ai/models/fal-ai/flux-pro/kontext/multi)

### 请求体参数 (Body)

<ParamField body="guidance_scale" type="number">
  范围值：1-20
</ParamField>

<ParamField body="image_urls" type="array" required>
  图片URL
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量，范围值：1-4
</ParamField>

<ParamField body="output_format" type="string">
  图片输出格式："jpeg"，"png"
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="safety_tolerance" type="string">
  安全容差
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "guidance_scale": 3.5,
  "image_urls": [
    "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
    "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
  ],
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "safety_tolerance": "2"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext/multi" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "guidance_scale": 3.5,
  "image_urls": [
    "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
    "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
  ],
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "safety_tolerance": "2"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "30bc4aeb-0543-4198-929c-da97da4d14c9",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/flux-pro/kontext/text-to-image)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  生成图像的宽高比。默认值："1:1"   支持：21：9、16：9、4：3、3：2、1：1、2：3、3：4、9：16、9：21
</ParamField>

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  范围值1-20
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

<ParamField body="prompt" type="string" required>
  生成图像的提示。
</ParamField>

<ParamField body="safety_tolerance" type="string">
  生成图像的安全容差等级。1 表示最严格，5 表示最宽松。默认值："2"
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "1:1",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "safety_tolerance": "2"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext/text-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "safety_tolerance": "2"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/flux-pro/kontext

`POST /fal-ai/flux-pro/kontext`

官方文档: [https://fal.ai/models/fal-ai/flux-pro/kontext](https://fal.ai/models/fal-ai/flux-pro/kontext)

### 请求体参数 (Body)

<ParamField body="guidance_scale" type="number">
  CFG（无分类器引导）量表用于衡量您希望模型在寻找相关图像时与提示的贴近程度。默认值：3.5  范围值1-20
</ParamField>

<ParamField body="image_url" type="string" required>
  在此处拖放文件，或提供 base64 编码的数据 URL接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="num_images" type="integer">
  生成的图像数量。默认值：1   范围值1-4
</ParamField>

<ParamField body="output_format" type="string">
  生成图片的格式。默认值："jpeg"  支持default、png、jpeg
</ParamField>

<ParamField body="prompt" type="string" required>
  生成图像的提示
</ParamField>

<ParamField body="safety_tolerance" type="string">
  生成图像的安全容差等级。1 表示最严格，5 表示最宽松。默认值："2"
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "guidance_scale": 3.5,
  "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put a donut next to the flour.",
  "safety_tolerance": "2"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/flux-pro/kontext" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "guidance_scale": 3.5,
  "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
  "num_images": 1,
  "output_format": "jpeg",
  "prompt": "Put a donut next to the flour.",
  "safety_tolerance": "2"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"
}
```

***

## /fal-ai/imagen4/preview

`POST /fal-ai/imagen4/preview`

官方文档: [https://fal.ai/models/fal-ai/imagen4/preview](https://fal.ai/models/fal-ai/imagen4/preview)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  图片比例，枚举值：1：1、16：9、9：16、3：4、4：3
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量，范围值：1-4
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率：枚举值："1K"、"2K"
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "1:1",
  "num_images": 1,
  "prompt": "Capture an intimate close-up bathed in warm, soft, late-afternoon sunlight filtering into a quintessential 1960s kitchen. The focal point is a charmingly designed vintage package of all-purpose flour, resting invitingly on a speckled Formica countertop. The packaging itself evokes pure nostalgia: perhaps thick, slightly textured paper in a warm cream tone, adorned with simple, bold typography (a friendly serif or script) in classic red and blue “ALL-PURPOSE FLOUR”, featuring a delightful illustration like a stylized sheaf of wheat or a cheerful baker character. In smaller bold print at the bottom of the package: “NET WT 5 LBS (80 OZ) 2.27kg”. Focus sharply on the package details – the slightly soft edges of the paper bag, the texture of the vintage printing, the inviting \"All-Purpose Flour\" text. Subtle hints of the 1960s kitchen frame the shot – the chrome edge of the counter gleaming softly, a blurred glimpse of a pastel yellow ceramic tile backsplash, or the corner of a vintage metal canister set just out of focus. The shallow depth of field keeps attention locked on the beautifully designed package, creating an aesthetic rich in warmth, authenticity, and nostalgic appeal.",
  "resolution": "1K"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/imagen4/preview" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "num_images": 1,
  "prompt": "Capture an intimate close-up bathed in warm, soft, late-afternoon sunlight filtering into a quintessential 1960s kitchen. The focal point is a charmingly designed vintage package of all-purpose flour, resting invitingly on a speckled Formica countertop. The packaging itself evokes pure nostalgia: perhaps thick, slightly textured paper in a warm cream tone, adorned with simple, bold typography (a friendly serif or script) in classic red and blue “ALL-PURPOSE FLOUR”, featuring a delightful illustration like a stylized sheaf of wheat or a cheerful baker character. In smaller bold print at the bottom of the package: “NET WT 5 LBS (80 OZ) 2.27kg”. Focus sharply on the package details – the slightly soft edges of the paper bag, the texture of the vintage printing, the inviting \"All-Purpose Flour\" text. Subtle hints of the 1960s kitchen frame the shot – the chrome edge of the counter gleaming softly, a blurred glimpse of a pastel yellow ceramic tile backsplash, or the corner of a vintage metal canister set just out of focus. The shallow depth of field keeps attention locked on the beautifully designed package, creating an aesthetic rich in warmth, authenticity, and nostalgic appeal.",
  "resolution": "1K"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "484ccb37-5477-44fe-8e75-6d6f6e9160b3",
  "response_url": "https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/kling-video/v2.5-turbo/pro/image-to-video)

### 请求体参数 (Body)

<ParamField body="cfg_scale" type="number">
  范围值：0-1
</ParamField>

<ParamField body="duration" type="string">
  生成视频时长，枚举值：5、10
</ParamField>

<ParamField body="image_url" type="string" required>
  图片url，接受的文件类型：jpg、jpeg、png、webp、gif、avif
</ParamField>

<ParamField body="negative_prompt" type="string">
  负向提示词（不希望出现的内容）
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "cfg_scale": 0.5,
  "duration": "5",
  "image_url": "https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg",
  "negative_prompt": "blur, distort, and low quality",
  "prompt": "A stark starting line divides two powerful cars, engines revving for the challenge ahead. They surge forward in the heat of competition, a blur of speed and chrome. The finish line looms as they vie for victory."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/kling-video/v2.5-turbo/pro/image-to-video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "cfg_scale": 0.5,
  "duration": "5",
  "image_url": "https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg",
  "negative_prompt": "blur, distort, and low quality",
  "prompt": "A stark starting line divides two powerful cars, engines revving for the challenge ahead. They surge forward in the heat of competition, a blur of speed and chrome. The finish line looms as they vie for victory."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "727028ec-aa98-4073-9bcd-0acb386abcfc",
  "response_url": "https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc/status"
}
```

***

## /fal-ai/kling-video/v2.5-turbo/pro/text-to-video

`POST /fal-ai/kling-video/v2.5-turbo/pro/text-to-video`

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  视频比例，枚举值：16：9，9：16，1：1
</ParamField>

<ParamField body="cfg_scale" type="number">
  范围值：0-1
</ParamField>

<ParamField body="duration" type="string">
  生成视频时长，枚举值：5、10
</ParamField>

<ParamField body="negative_prompt" type="string">
  负向提示词（不希望出现的内容）
</ParamField>

<ParamField body="prompt" type="string" required>
  视频生成提示词。
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "cfg_scale": 0.5,
  "duration": "5",
  "negative_prompt": "blur, distort, and low quality",
  "prompt": "A noble lord walks among his people, his presence a comforting reassurance. He greets them with a gentle smile, embodying their hopes and earning their respect through simple interactions. The atmosphere is intimate and sincere, highlighting the bond between the leader and community."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/kling-video/v2.5-turbo/pro/text-to-video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "cfg_scale": 0.5,
  "duration": "5",
  "negative_prompt": "blur, distort, and low quality",
  "prompt": "A noble lord walks among his people, his presence a comforting reassurance. He greets them with a gentle smile, embodying their hopes and earning their respect through simple interactions. The atmosphere is intimate and sincere, highlighting the bond between the leader and community."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "request_id": "req_example",
  "status": "OK"
}
```

***

## 提交 Fal.ai 任务

`POST /fal-ai/*model`

通用提交接口，路径格式 `POST /fal-ai/`{`model`}\`\`。不同模型请求体各异。

### 请求体参数 (Body)

<ParamField body="guidance_scale" type="number">
  引导系数
</ParamField>

<ParamField body="image_size" type="string">
  输出尺寸，如 square\_hd、landscape\_4\_3
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  推理步数
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词（图像/视频模型常用）
</ParamField>

<ParamField body="seed" type="integer">
  随机种子；相同种子便于复现
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_inference_steps": 28,
  "prompt": "A serene mountain landscape"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/*model" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "guidance_scale": 3.5,
  "image_size": "landscape_4_3",
  "num_inference_steps": 28,
  "prompt": "A serene mountain landscape"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "request_id": "req_example",
  "status": "OK"
}
```

***

## /fal-ai/nano-banana/edit 图片编辑

`POST /fal-ai/nano-banana/edit`

官方文档: [https://fal.ai/models/fal-ai/nano-banana/edit](https://fal.ai/models/fal-ai/nano-banana/edit)

### 请求体参数 (Body)

<ParamField body="image_urls" type="array" required>
  需要编辑的图片url。
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量。范围值1-4。默认值：1
</ParamField>

<ParamField body="prompt" type="string" required>
  图像编辑的提示词。
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
    "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
  ],
  "num_images": 1,
  "prompt": "make a photo of the man driving the car down the california coastline"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/nano-banana/edit" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
    "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
  ],
  "num_images": 1,
  "prompt": "make a photo of the man driving the car down the california coastline"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "f8837f29-26cb-4213-90f5-22b2911a0ea7",
  "response_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/status"
}
```

***

## /fal-ai/nano-banana 文生图

`POST /fal-ai/nano-banana`

官方文档: [https://fal.ai/models/fal-ai/nano-banana](https://fal.ai/models/fal-ai/nano-banana)

### 请求体参数 (Body)

<ParamField body="num_images" type="integer">
  生成图片数量。范围值1-4。默认值：1
</ParamField>

<ParamField body="prompt" type="string" required>
  生成图片的提示词。
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "num_images": 1,
  "prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater."
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/nano-banana" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "num_images": 1,
  "prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater."
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca",
  "response_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/status"
}
```

***

## /fal-ai/qwen-image-edit-lora

`POST /fal-ai/qwen-image-edit-lora`

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  图像生成的加速级别。枚举值： 'none', 'regular','high'
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="integer">
  范围值：2-100
</ParamField>

<ParamField body="image_url" type="string" required>
  图片url
</ParamField>

<ParamField body="negative_prompt" type="string">
  负向提示词（不希望出现的内容）
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量，范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：2-100
</ParamField>

<ParamField body="output_format" type="string">
  输出图片格式，支持：jpeg、png
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 4,
  "image_url": "https://v3.fal.media/files/koala/oei_-iPIYFnhdB8SxojND_qwen-edit-res.png",
  "negative_prompt": "blurry, ugly",
  "num_images": 1,
  "num_inference_steps": 30,
  "output_format": "png",
  "prompt": "Change bag to apple macbook"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/qwen-image-edit-lora" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "enable_safety_checker": true,
  "guidance_scale": 4,
  "image_url": "https://v3.fal.media/files/koala/oei_-iPIYFnhdB8SxojND_qwen-edit-res.png",
  "negative_prompt": "blurry, ugly",
  "num_images": 1,
  "num_inference_steps": 30,
  "output_format": "png",
  "prompt": "Change bag to apple macbook"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "request_id": "req_example",
  "status": "OK"
}
```

***

## /fal-ai/qwen-image-edit-plus

`POST /fal-ai/qwen-image-edit-plus`

官方文档: [https://fal.ai/models/fal-ai/qwen-image-edit-plus](https://fal.ai/models/fal-ai/qwen-image-edit-plus)

### 请求体参数 (Body)

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="integer">
  范围值：0-20
</ParamField>

<ParamField body="image_size" type="string">
  图片尺寸，枚举值：square、square\_hd、landscape\_4\_3、landscape\_16\_9、portrait\_3\_4、portrait\_9\_16
</ParamField>

<ParamField body="image_urls" type="array" required>
  图片url
</ParamField>

<ParamField body="negative_prompt" type="string">
  负向提示词（不希望出现的内容）
</ParamField>

<ParamField body="num_images" type="integer">
  生成图片数量，范围值：1-4
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：2-100
</ParamField>

<ParamField body="output_format" type="string">
  输出图片格式，支持：jpeg、png
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词。
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "enable_safety_checker": true,
  "guidance_scale": 4,
  "image_size": "square_hd",
  "image_urls": [
    "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png",
    "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png",
    "https://v3.fal.media/files/tiger/sCoZhBksx9DvwSR4_U3_C_3d1f581441874005908addeae9c10d0f.png"
  ],
  "negative_prompt": "blurry, ugly",
  "num_images": 1,
  "num_inference_steps": 50,
  "output_format": "png",
  "prompt": "Close shot portrait of a woman in front of this car on this highway"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/qwen-image-edit-plus" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enable_safety_checker": true,
  "guidance_scale": 4,
  "image_size": "square_hd",
  "image_urls": [
    "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png",
    "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png",
    "https://v3.fal.media/files/tiger/sCoZhBksx9DvwSR4_U3_C_3d1f581441874005908addeae9c10d0f.png"
  ],
  "negative_prompt": "blurry, ugly",
  "num_images": 1,
  "num_inference_steps": 50,
  "output_format": "png",
  "prompt": "Close shot portrait of a woman in front of this car on this highway"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121/cancel",
  "metrics": {},
  "queue_position": 0,
  "request_id": "9c08e7d8-312c-402d-a691-c207a9cb8121",
  "response_url": "https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/veo3/fast/image-to-video)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  生成视频的宽高比默认值："auto"
</ParamField>

<ParamField body="duration" type="string">
  生成视频的时长（以秒为单位）默认值："8s"
</ParamField>

<ParamField body="generate_audio" type="boolean">
  是否为视频生成音频。如果为 false，则将减少 %33 的积分。默认值：true
</ParamField>

<ParamField body="image_url" type="string" required>
  要制作动画的输入图像的 URL。宽高比应为 720p 或更高分辨率，宽高比为 16：9。如果图像的纵横比不是 16：9，则会裁剪以适合。
</ParamField>

<ParamField body="prompt" type="string" required>
  描述图像应如何制作动画的文本提示
</ParamField>

<ParamField body="resolution" type="string">
  生成视频的分辨率默认值："720p"  范围值\[720p，1080p]
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "duration": "8s",
  "generate_audio": true,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",
  "prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",
  "resolution": "720p"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/veo3/fast/image-to-video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "duration": "8s",
  "generate_audio": true,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",
  "prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",
  "resolution": "720p"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "1b24b3ae-16a2-4d19-b10d-1e323ebff061",
  "response_url": "https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061/status"
}
```

***

## /fal-ai/veo3/fast

`POST /fal-ai/veo3/fast`

官方文档地址：[https://fal.ai/models/fal-ai/veo3/fast](https://fal.ai/models/fal-ai/veo3/fast)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  生成视频的宽高比。如果设置为 1：1，视频将被外绘。默认值："16:9"，范围\[16:9,9:16,1:1]
</ParamField>

<ParamField body="auto_fix" type="boolean">
  是否通过重写来自动尝试修复未通过内容策略或其他验证检查的提示默认值：true
</ParamField>

<ParamField body="duration" type="string">
  生成视频的时长（以秒为单位）默认值："8s"
</ParamField>

<ParamField body="enhance_prompt" type="boolean">
  是否增强视频生成默认值：true
</ParamField>

<ParamField body="generate_audio" type="boolean">
  是否为视频生成音频。如果为 false，则将减少 %33 的积分。默认值：true
</ParamField>

<ParamField body="prompt" type="string" required>
  描述要生成的视频的文本提示
</ParamField>

<ParamField body="resolution" type="string">
  生成视频的分辨率默认值："720p"  范围值\[720p，1080p]
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "auto_fix": true,
  "duration": "4s",
  "enhance_prompt": true,
  "generate_audio": false,
  "prompt": "A casual street interview on a busy New York City sidewalk in the afternoon. The interviewer holds a plain, unbranded microphone and asks: Have you seen Google's new Veo3 model It is a super good model. Person replies: Yeah I saw it, it's already available on fal. It's crazy good.",
  "resolution": "720p"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/veo3/fast" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "auto_fix": true,
  "duration": "4s",
  "enhance_prompt": true,
  "generate_audio": false,
  "prompt": "A casual street interview on a busy New York City sidewalk in the afternoon. The interviewer holds a plain, unbranded microphone and asks: Have you seen Google's new Veo3 model It is a super good model. Person replies: Yeah I saw it, it's already available on fal. It's crazy good.",
  "resolution": "720p"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "fabda298-3a7c-43f6-ba3a-2bde5b344173",
  "response_url": "https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173/status"
}
```

***

## /fal-ai/veo3/image-to-video

`POST /fal-ai/veo3/image-to-video`

官方文档：[https://fal.ai/models/fal-ai/veo3/image-to-video](https://fal.ai/models/fal-ai/veo3/image-to-video)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  尺寸，枚举值：16：9、9：16、auto，默认值： "auto"
</ParamField>

<ParamField body="duration" type="string">
  视频时长，默认值："8s"
</ParamField>

<ParamField body="generate_audio" type="boolean">
  生成音频，默认值：true
</ParamField>

<ParamField body="image_url" type="string" required>
  参考图片URL
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="resolution" type="string">
  分辨率，枚举值："720p"、"1080p"
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "auto",
  "duration": "8s",
  "generate_audio": true,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",
  "prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",
  "resolution": "720p"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/veo3/image-to-video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "auto",
  "duration": "8s",
  "generate_audio": true,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",
  "prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",
  "resolution": "720p"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "bcd3b436-b7af-42f3-8649-204657bfaf10",
  "response_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/status"
}
```

***

## /fal-ai/veo3

`POST /fal-ai/veo3`

官方文档地址：[https://fal.ai/models/fal-ai/veo3](https://fal.ai/models/fal-ai/veo3)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  生成视频的宽高比。如果设置为 1：1，视频将被外绘。默认值："16:9"，范围\[16:9,9:16,1:1]
</ParamField>

<ParamField body="auto_fix" type="boolean">
  是否通过重写来自动尝试修复未通过内容策略或其他验证检查的提示默认值：true
</ParamField>

<ParamField body="duration" type="string">
  生成视频的时长（以秒为单位）默认值："8s"
</ParamField>

<ParamField body="enhance_prompt" type="boolean">
  是否增强视频生成默认值：true
</ParamField>

<ParamField body="generate_audio" type="boolean">
  是否为视频生成音频。如果为 false，则将减少 %33 的积分。默认值：true
</ParamField>

<ParamField body="prompt" type="string" required>
  文本提示词
</ParamField>

<ParamField body="resolution" type="string">
  生成视频的分辨率默认值："720p"  范围值\[720p，1080p]
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "auto_fix": true,
  "duration": "8s",
  "enhance_prompt": true,
  "generate_audio": true,
  "prompt": "A casual street interview on a busy New York City sidewalk in the afternoon. The interviewer holds a plain, unbranded microphone and asks: Have you seen Google's new Veo3 model It is a super good model. Person replies: Yeah I saw it, it's already available on fal. It's crazy good.",
  "resolution": "720p"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/veo3" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "auto_fix": true,
  "duration": "8s",
  "enhance_prompt": true,
  "generate_audio": true,
  "prompt": "A casual street interview on a busy New York City sidewalk in the afternoon. The interviewer holds a plain, unbranded microphone and asks: Have you seen Google's new Veo3 model It is a super good model. Person replies: Yeah I saw it, it's already available on fal. It's crazy good.",
  "resolution": "720p"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "57b19308-8d3e-4196-b8bf-5ca80fa90827",
  "response_url": "https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827/status"
}
```

***

## /fal-ai/vidu/reference-to-image

`POST /fal-ai/vidu/reference-to-image`

官方文档: [https://fal.ai/models/fal-ai/vidu/reference-to-image](https://fal.ai/models/fal-ai/vidu/reference-to-image)

### 请求体参数 (Body)

<ParamField body="aspect_ratio" type="string">
  图片比例，枚举值：1：1、16：9、9：16
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="reference_image_urls" type="array" required>
  参考图片url
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "aspect_ratio": "16:9",
  "prompt": "The little devil is looking at the apple on the beach and walking around it.",
  "reference_image_urls": [
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png",
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png",
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png"
  ]
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/vidu/reference-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "prompt": "The little devil is looking at the apple on the beach and walking around it.",
  "reference_image_urls": [
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png",
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png",
    "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png"
  ]
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/vidu/requests/405a114e-04bd-463a-a98c-895502cfdce9/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "405a114e-04bd-463a-a98c-895502cfdce9",
  "response_url": "https://queue.fal.run/fal-ai/vidu/requests/405a114e-04bd-463a-a98c-895502cfdce9",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/vidu/requests/405a114e-04bd-463a-a98c-895502cfdce9/status"
}
```

***

## /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](https://fal.ai/models/fal-ai/wan/v2.2-a14b/image-to-image)

### 请求体参数 (Body)

<ParamField body="acceleration" type="string">
  图片生成速度，枚举值："regular"，"none"
</ParamField>

<ParamField body="aspect_ratio" type="string">
  图片尺寸
</ParamField>

<ParamField body="enable_prompt_expansion" type="boolean">
  启用提示扩展
</ParamField>

<ParamField body="enable_safety_checker" type="boolean">
  启用安全检查，默认值：true
</ParamField>

<ParamField body="guidance_scale" type="number">
  范围值：1-10
</ParamField>

<ParamField body="guidance_scale_2" type="integer">
  范围值：1-10
</ParamField>

<ParamField body="image_format" type="string">
  图片输出格式："jpeg"，"png"
</ParamField>

<ParamField body="image_url" type="string" required>
  图片URL
</ParamField>

<ParamField body="num_inference_steps" type="integer">
  范围值：2-40
</ParamField>

<ParamField body="prompt" type="string" required>
  提示词
</ParamField>

<ParamField body="shift" type="integer">
  范围值：1-10
</ParamField>

<ParamField body="strength" type="number">
  强度，范围值：0-1
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "acceleration": "regular",
  "aspect_ratio": "auto",
  "enable_prompt_expansion": false,
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "guidance_scale_2": 4,
  "image_format": "jpeg",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/wan-image-to-image-input.png",
  "num_inference_steps": 27,
  "prompt": "A cinematic shot of an ancient city at sunset, intricate stone buildings, warm golden light",
  "shift": 2,
  "strength": 0.5
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/fal-ai/wan/v2.2-a14b/image-to-image" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acceleration": "regular",
  "aspect_ratio": "auto",
  "enable_prompt_expansion": false,
  "enable_safety_checker": true,
  "guidance_scale": 3.5,
  "guidance_scale_2": 4,
  "image_format": "jpeg",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/wan-image-to-image-input.png",
  "num_inference_steps": 27,
  "prompt": "A cinematic shot of an ancient city at sunset, intricate stone buildings, warm golden light",
  "shift": 2,
  "strength": 0.5
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "cancel_url": "https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6/cancel",
  "logs": [],
  "metrics": {},
  "queue_position": 0,
  "request_id": "f88f1b41-b325-4f23-926b-da51481bf6c6",
  "response_url": "https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6",
  "status": "IN_QUEUE",
  "status_url": "https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6/status"
}
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.