image-to-video

POST

https://api.chatfire.cn/fal-ai/{model}

最后修改时间：2025-07-04 03:27:01

责任人：未设置

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

model

string

枚举值

必需

示例值:

hunyuan-video-image-to-video

Body 参数application/json

prompt

string

可选

用于生成视频的提示词。

image_url

string

输入图像的URL。

可选

seed

integer

可选

用于生成视频的种子。

aspect_ratio

enum<string>

可选

要生成的视频的宽高比。

枚举值:

16:99:16

默认值:

16:9

resolution

enum<string>

可选

要生成的视频的分辨率。

枚举值:

720p

默认值:

720p

num_frames

enum<string>

要生成的帧数。

可选

枚举值:

129

默认值:

129

i2v_stability

boolean

可选

开启I2V稳定性可以减少幻觉，但也会减少运动。

默认值:

false

示例

{
  "prompt": "Two muscular cats boxing in a boxing ring.",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hunyuan_i2v.jpg",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "num_frames": 129,
  "i2v_stability": false // 开启 I2V 稳定性功能可减少幻觉，但也会降低运动效果。默认值：false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.chatfire.cn/fal-ai/hunyuan-video-image-to-video' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "Two muscular cats boxing in a boxing ring.",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hunyuan_i2v.jpg",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "num_frames": 129,
  "i2v_stability": false // 开启 I2V 稳定性功能可减少幻觉，但也会降低运动效果。默认值：false
}'

返回响应

🟢200成功

application/json

Body

status

string

必需

request_id

string

必需

response_url

string

必需

status_url

string

必需

cancel_url

string

必需

logs

null

必需

metrics

object

必需

queue_position

integer

必需

示例

{
    "status": "IN_QUEUE",
    "request_id": "8d80d97f-e691-43e1-b5ce-71bd815b322b",
    "response_url": "https://queue.fal.run/fal-ai/hunyuan-video-image-to-video/requests/8d80d97f-e691-43e1-b5ce-71bd815b322b",
    "status_url": "https://queue.fal.run/fal-ai/hunyuan-video-image-to-video/requests/8d80d97f-e691-43e1-b5ce-71bd815b322b/status",
    "cancel_url": "https://queue.fal.run/fal-ai/hunyuan-video-image-to-video/requests/8d80d97f-e691-43e1-b5ce-71bd815b322b/cancel",
    "logs": null,
    "metrics": {},
    "queue_position": 0
}

修改于 2025-07-04 03:27:01

text-to-video

video-to-video