reference-to-video

POST

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

最后修改时间：2025-07-16 08:17:07

责任人：未设置

Vidu Q1 Text to Video generates high-quality 1080p videos with exceptional visual quality and motion diversity

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

model

string

枚举值

必需

示例值:

vidu

submodel

enum<string>

必需

枚举值:

q1/reference-to-videoq1/image-to-videoq1/start-end-to-videoq1/text-to-video

示例值:

q1/reference-to-video

Body 参数application/json

prompt

string

必需

用于视频生成的文本提示，最多1500个字符

<= 1500 字符

reference_image_urls

array[string]

可选

用于保持主体外观一致性的参考图像URL。Q1模型最多支持7张参考图像。

<= 7 items

seed

integer

用于生成的随机种子

可选

aspect_ratio

enum<string>

输出视频的宽高比

可选

枚举值:

16:99:161:1

默认值:

16:9

movement_amplitude

enum<string>

可选

画面中物体的运动幅度

枚举值:

autosmallmediumlarge

默认值:

auto

bgm

boolean

可选

是否为生成的视频添加背景音乐

示例

{
  "prompt": "A young woman and a monkey inside a colorful house",
  "reference_image_urls": [
    "https://v3.fal.media/files/panda/HDpZj0eLjWwCpjA5__0l1_0e6cd0b9eb7a4a968c0019a4eee15e46.png",
    "https://v3.fal.media/files/zebra/153izt1cBlMU-TwD0_B7Q_ea34618f5d974653a16a755aa61e488a.png",
    "https://v3.fal.media/files/koala/RCSZ7VEEKGFDfMoGHCwzo_f626718793e94769b1ad36d5891864a4.png"
  ],
  "aspect_ratio": "16:9",
  "movement_amplitude": "auto"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.chatfire.cn/fal-ai/vidu/q1/reference-to-video' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "A young woman and a monkey inside a colorful house",
  "reference_image_urls": [
    "https://v3.fal.media/files/panda/HDpZj0eLjWwCpjA5__0l1_0e6cd0b9eb7a4a968c0019a4eee15e46.png",
    "https://v3.fal.media/files/zebra/153izt1cBlMU-TwD0_B7Q_ea34618f5d974653a16a755aa61e488a.png",
    "https://v3.fal.media/files/koala/RCSZ7VEEKGFDfMoGHCwzo_f626718793e94769b1ad36d5891864a4.png"
  ],
  "aspect_ratio": "16:9",
  "movement_amplitude": "auto"
}'

返回响应

🟢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": "253d3040-d026-4edf-adcc-9e6f83963d47",
    "response_url": "https://queue.fal.run/fal-ai/pika/requests/253d3040-d026-4edf-adcc-9e6f83963d47",
    "status_url": "https://queue.fal.run/fal-ai/pika/requests/253d3040-d026-4edf-adcc-9e6f83963d47/status",
    "cancel_url": "https://queue.fal.run/fal-ai/pika/requests/253d3040-d026-4edf-adcc-9e6f83963d47/cancel",
    "logs": null,
    "metrics": {},
    "queue_position": 109
}

修改于 2025-07-16 08:17:07

start-end-to-video

任务状态