OpenAPI 参考

Modelink API · 视频

Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo、MiniMax H3/H3 Max 等多厂商的文生视频、图生视频与任务查询能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。

版本 1.0.0

文生视频

POST

/queue/fal-ai/kling-video/o3/{mode}/text-to-video

o3 text-to-video 支持 standard/pro/4k。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
支持 standard/pro/4k。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring
视频内容提示词。与 multi_prompt 互斥，最长 2500 个字符。
durationenum
生成视频的时长（秒）。默认 5，支持 3～15 秒的整数。
default: 5
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
aspect_ratioenum
生成视频的画面宽高比。默认 16:9。
default: 16:9
- 16:9
- 9:16
- 1:1
generate_audioboolean
是否生成原生音频。默认 false。
default: false
multi_promptobject[]
多镜头分镜列表。与 prompt 互斥；每个分镜分别指定提示词和时长。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
shot_typeenum
多镜头生成方式。使用 multi_prompt 时必填；customize 按分镜生成，intelligent 由模型规划镜头。默认 customize。
default: customize
- customize
- intelligent

请求

POST/queue/fal-ai/kling-video/o3/{mode}/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o3/{mode}/text-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A mecha lands on the ground to save the city, and says \"I'\''m here\", in anime style"
}'

响应

object & object

任务已入队。

响应体属性

allOf[0]object
fal 标准 URL 集合，所有响应均内联此字段。
- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
allOf[1]object
- statusenum, 必填
  - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- logsobject[]
  日志条目（入队时为空数组）。
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ]
}

图生视频

POST

/queue/fal-ai/kling-video/o3/{mode}/image-to-video

o3 image-to-video 支持 standard/pro/4k。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
支持 standard/pro/4k。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring
视频内容提示词。与 multi_prompt 互斥。
image_urlstring<uri>, 必填
视频首帧图像 URL，必填。
end_image_urlstring<uri>
可选的视频尾帧图像 URL。
durationenum
生成视频的时长（秒）。默认 5，范围 3～15。
default: 5
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
generate_audioboolean
是否生成原生音频。默认 false。
default: false
multi_promptobject[]
多镜头分镜列表。与 prompt 互斥。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
shot_typeenum
多镜头生成方式。customize 按分镜生成；intelligent 由模型自动规划镜头。默认 customize。
default: customize
- customize
- intelligent
elementsobject | object[]
主体（Element）参考列表。每项两种形态二选一：①通过 element_id 引用已有素材；②内联传入 frontal_image_url + reference_image_urls，由平台自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除。详见 Kling 主体（Element）使用教程。
- oneOf[0]object
  additionalProperties: false
  - element_idstring | integer<int64>, 必填
    引用已有主体：Kling 官方主体库数字 ID（如 313464315622507），或 qasset://qasset-xxx 引用我方 /v1/assets 已建素材。
    oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- oneOf[1]object
  additionalProperties: false
  - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。

请求

POST/queue/fal-ai/kling-video/o3/{mode}/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o3/{mode}/image-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "The character walks forward slowly, with the camera following from behind.",
  "image_url": "https://v3b.fal.media/files/b/0a8cfd5a/8ABMp4n9rh3kfD2Rq8fHd_start_frame.png"
}'

响应

object & object

任务已入队。

响应体属性

allOf[0]object
fal 标准 URL 集合，所有响应均内联此字段。
- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
allOf[1]object
- statusenum, 必填
  - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- logsobject[]
  日志条目（入队时为空数组）。
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ]
}

参考生视频

POST

/queue/fal-ai/kling-video/o3/{mode}/reference-to-video

o3 reference-to-video 支持 standard/pro/4k。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
支持 standard/pro/4k。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring
视频内容提示词。与 multi_prompt 互斥；可使用 @Image1、@Element1 等引用输入素材。
multi_promptobject[]
多镜头分镜列表。与 prompt 互斥。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
start_image_urlstring<uri>
可选的视频首帧图像 URL。
end_image_urlstring<uri>
可选的视频尾帧图像 URL。
image_urlsstring[]
风格或外观参考图 URL 列表，在提示词中按 @Image1、@Image2 顺序引用。
elementsobject | object[]
人物或物体主体参考列表，在提示词中按 @Element1、@Element2 顺序引用。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。
- oneOf[0]object
  additionalProperties: false
  - element_idstring | integer<int64>, 必填
    引用已有主体：Kling 官方主体库数字 ID（如 313464315622507），或 qasset://qasset-xxx 引用我方 /v1/assets 已建素材。
    oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- oneOf[1]object
  additionalProperties: false
  - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
generate_audioboolean
是否生成原生音频。默认 false。
default: false
durationenum
生成视频的时长（秒）。默认 5，范围 3～15。
default: 5
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
shot_typeenum
多镜头生成方式。customize 按分镜生成；intelligent 由模型自动规划镜头。默认 customize。
default: customize
- customize
- intelligent
aspect_ratioenum
生成视频的画面宽高比。默认 16:9。
default: 16:9
- 16:9
- 9:16
- 1:1

请求

POST/queue/fal-ai/kling-video/o3/{mode}/reference-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o3/{mode}/reference-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "从白天平滑过渡到夜晚，城市灯光逐渐亮起",
  "start_image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "end_image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg"
}'

响应

object & object

任务已入队。

响应体属性

allOf[0]object
fal 标准 URL 集合，所有响应均内联此字段。
- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
allOf[1]object
- statusenum, 必填
  - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- logsobject[]
  日志条目（入队时为空数组）。
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ]
}

视频参考生视频

POST

/queue/fal-ai/kling-video/o3/{mode}/video-to-video/reference

以参考视频的特征风格（refer_type=feature）生成新视频。固定使用 kling-v3-omni 模型，不支持 4k 模式。输出宽高比和时长可通过 aspect_ratio / duration 自定义。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
支持 standard/std/pro，不支持 4k。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
视频生成文本描述。
video_urlstring, 必填
输入参考视频的公网 URL。
image_urlsstring[]
补充参考图片 URL 列表（可选）。
elementsobject | object[]
主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。
- oneOf[0]object
  additionalProperties: false
  - element_idstring | integer<int64>, 必填
    引用已有主体：Kling 官方主体库数字 ID（如 313464315622507），或 qasset://qasset-xxx 引用我方 /v1/assets 已建素材。
    oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- oneOf[1]object
  additionalProperties: false
  - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留输入视频原声，默认 true。
shot_typeenum
镜头类型（可选）。
- customize
aspect_ratioenum
输出视频宽高比，不填时默认 auto（由 Kling 自行决定）。
- 16:9
- 9:16
- 1:1
- auto
durationstring
输出视频时长（秒），有效范围 3~15。

请求

POST/queue/fal-ai/kling-video/o3/{mode}/video-to-video/reference

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o3/{mode}/video-to-video/reference?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Style @Video1 following watercolor style of @Image1",
  "video_url": "https://example.com/input.mp4",
  "aspect_ratio": "16:9",
  "duration": "5"
}'

响应

object & object

任务已入队。

响应体属性

allOf[0]object
fal 标准 URL 集合，所有响应均内联此字段。
- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
allOf[1]object
- statusenum, 必填
  - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- logsobject[]
  日志条目（入队时为空数组）。
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ]
}

视频编辑

POST

/queue/fal-ai/kling-video/o3/{mode}/video-to-video/edit

直接对已有视频做内容编辑（refer_type=base）。输出视频的尺寸和时长沿用输入视频，无需传 aspect_ratio / duration。固定使用 kling-v3-omni 模型，不支持 4k 模式。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
支持 standard/std/pro，不支持 4k。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
编辑指令，描述对视频的修改内容。
video_urlstring, 必填
待编辑视频的公网 URL。
image_urlsstring[]
补充参考图片 URL 列表（可选）。
elementsobject | object[]
主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。
- oneOf[0]object
  additionalProperties: false
  - element_idstring | integer<int64>, 必填
    引用已有主体：Kling 官方主体库数字 ID（如 313464315622507），或 qasset://qasset-xxx 引用我方 /v1/assets 已建素材。
    oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- oneOf[1]object
  additionalProperties: false
  - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留输入视频原声，默认 true。
shot_typeenum
镜头类型（可选）。
- customize

请求

POST/queue/fal-ai/kling-video/o3/{mode}/video-to-video/edit

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o3/{mode}/video-to-video/edit?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Change environment to snow",
  "video_url": "https://example.com/input.mp4",
  "keep_audio": false
}'

响应

object & object

任务已入队。

响应体属性

allOf[0]object
fal 标准 URL 集合，所有响应均内联此字段。
- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
allOf[1]object
- statusenum, 必填
  - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- logsobject[]
  日志条目（入队时为空数组）。
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ]
}