OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建视频任务

POST

/v1/videos

OpenAI 风格的统一视频创建接口，服务端根据 model 前缀自动路由到对应供应商：

可灵（Kling）：kling-v3-omni 等 Omni 模型，支持文生 / 图生 / 视频生视频、首尾帧、有声视频等，参数结构见 KlingV3OmniCreateRequest。
Sora：sora-2、sora-2-pro，支持文生视频与图生视频（通过 input_reference 传参考图），参数结构见 SoraVideoCreateRequest。

请求体结构按 model 区分，下方示例分别给出可灵与 Sora 两类模型的用法。任务创建成功后返回任务 ID，可通过 GET /v1/videos/{id} 轮询任务状态并获取生成的视频。

Sora 分辨率限制：sora-2 仅支持 1280x720 / 720x1280；sora-2-pro 额外支持 1792x1024 / 1024x1792。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

请求体

请求体属性

- - kling-v3-omni
- multi_shotboolean
  是否生成多镜头视频。当前参数为 true 时，prompt 参数无效；当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。
  default: false
- - customize
- promptstring
  文本提示词，可包含正向描述和负向描述。可将提示词模板化来满足不同的视频生成需求。Omni 模型可通过 Prompt 与主体、图片、视频等内容实现多种能力：通过 <<<>>> 的格式来指定某个主体、图片、视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>。长度不能超过 2500 个字符。当 multi_shot 参数为 false 或 shot_type 参数为 intelligence 时，当前参数不得为空。不同模型版本、视频模式支持范围不同，详见能力地图。
- - indexinteger, 必填
    分镜序号。
  - promptstring, 必填
    该分镜的提示词。最大长度不超过 512 个字符。
  - durationstring, 必填
    该分镜的时长（秒）。不大于当前任务的总时长，不小于 1。
- - imagestring, 必填
    图片 URL 或 Base64 编码（对应可灵文档 image_url 字段）。支持 .jpg/.jpeg/.png 格式，文件大小不超过 10MB，宽高尺寸不小于 300px，宽高比在 1:2.5~2.5:1 之间。参数值不得为空。
  - first_frame
    end_frame
- - video_urlstring, 必填
    参考视频 URL。视频格式仅支持 MP4/MOV，大小不超过 200MB，时长不少于 3 秒，宽高尺寸需介于 720px（含）和 2160px（含）之间。参数值不得为空。
  - base
    feature
  - yes
    no
- - on
  - off
- - std
  - pro
  - 4k
- sizestring
  生成视频的画面纵横比（宽:高）。对应可灵的 aspect_ratio 字段，服务内部自动将 size（如 1280x720）转换为 aspect_ratio（如 16:9）。可灵文档枚举值：16:9, 9:16, 1:1。未使用首帧参考或视频编辑功能时，当前参数必填。
- - 3
  - 4
  - 5
  - 6
  - 7
  - 8
  - 9
  - 10
  - 11
  - 12
  - 13
  - 14
  - 15
- - enabledboolean
    true 为生成水印，false 为不生成水印。
- - sora-2
  - sora-2-pro
- promptstring, 必填
  文本提示词，描述希望生成的视频内容。最大 2500 字符。
- input_referencestring<uri>
  参考图片 URL，用于图生视频。传入该字段后自动走图生视频流程，图片尺寸需与 size 一致。仅支持文生视频时可省略。
- - 4
  - 8
  - 12
- - 1280x720
  - 720x1280
  - 1792x1024
  - 1024x1792

请求

POST/v1/videos

curl https://api.qnaigc.com/v1/videos \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v3-omni",
  "prompt": "视频连贯在一起",
  "image_list": [
    {
      "image": "https://picsum.photos/1280/720",
      "type": "first_frame"
    },
    {
      "image": "https://picsum.photos/1280/720",
      "type": "end_frame"
    }
  ],
  "size": "1920x1080",
  "mode": "pro"
}'

响应

object

视频任务创建成功

响应体属性

idstring, 必填
视频任务唯一 ID，用于后续查询任务状态
- video
modelstring
使用的模型名称，例如 kling-video-o1
modestring
生成模式，std（标准模式）或 pro（专家模式）
statusstring, 必填
任务状态，通常为 queued（排队中）
created_atinteger
创建时间（Unix 时间戳，秒）
updated_atinteger
更新时间（Unix 时间戳，秒）
secondsstring
视频时长（秒）
sizestring
请求体中的视频分辨率（宽 x 高）
job_type_descriptionstring
任务类型描述。
billing_type_descriptionstring
计费类型描述。

响应

{
  "id": "qvideo-user123-1766391125174150336",
  "object": "video",
  "model": "kling-v3-omni",
  "mode": "pro",
  "status": "queued",
  "created_at": 1766391125,
  "updated_at": 1766391125,
  "seconds": "5",
  "size": "1920x1080"
}

查询视频生成状态

GET

/v1/videos/{id}

根据视频任务 ID 查询视频生成状态和结果，适用于通过 POST /v1/videos 创建的可灵（kling-v3-omni 等）与 Sora（sora-2、sora-2-pro）任务。建议定期轮询直到状态变为 completed 或 failed。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
id
Type
string, 必填
Description
视频任务 ID，创建视频时返回的 id 字段

请求体

暂无请求体

请求

GET/v1/videos/{id}

curl https://api.qnaigc.com/v1/videos/{id} \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json'

响应

object

成功获取视频任务状态

响应体属性

idstring, 必填
视频任务唯一 ID
- video
modelstring
使用的模型名称
modestring
生成模式，std 或 pro，仅在成功时返回
- initializing
- queued
- in_progress
- downloading
- uploading
- completed
- failed
- cancelled
- expired
created_atinteger
创建时间（Unix 时间戳，秒）
updated_atinteger
更新时间（Unix 时间戳，秒）
completed_atinteger
完成时间（Unix 时间戳，秒），仅在已完成或失败时返回
secondsstring
视频时长（秒）
sizestring
视频分辨率（宽 x 高）
- - idstring, 必填
    视频 ID，全局唯一
  - urlstring, 必填
    视频下载 URL（注意：生成的视频会在 7 天后过期，请及时转存）
  - durationstring
    视频时长（秒）
- codestring
  错误码
- messagestring
  错误描述

响应

{
  "id": "qvideo-user123-1766391125174150336",
  "object": "video",
  "model": "kling-video-o1",
  "status": "in_progress",
  "created_at": 1766391125,
  "updated_at": 1766391150
}

视频 Remix

POST

/v1/videos/{id}/remix

基于已完成的视频任务，使用新的提示词重新生成视频。保持原视频的时长和分辨率。支持的模型：sora-2、sora-2-pro（需为通过 POST /v1/videos 创建并已完成的 Sora 视频任务）。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
id
Type
string, 必填
Description
原视频任务 ID（必须是已完成的视频任务）

请求体

请求体属性

promptstring, 必填
新的视频生成提示词，最大 2500 字符。描述希望在新视频中呈现的变化、风格或效果。

请求

POST/v1/videos/{id}/remix

curl https://api.qnaigc.com/v1/videos/{id}/remix \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "将场景改为夜晚,增加霓虹灯效果,赛博朋克风格"
}'

响应

object & object

Remix 任务创建成功

响应体属性

- idstring, 必填
  视频任务唯一 ID，用于后续查询任务状态
- - video
- modelstring
  使用的模型名称，例如 kling-video-o1
- modestring
  生成模式，std（标准模式）或 pro（专家模式）
- statusstring, 必填
  任务状态，通常为 queued（排队中）
- created_atinteger
  创建时间（Unix 时间戳，秒）
- updated_atinteger
  更新时间（Unix 时间戳，秒）
- secondsstring
  视频时长（秒）
- sizestring
  请求体中的视频分辨率（宽 x 高）
- job_type_descriptionstring
  任务类型描述。
- billing_type_descriptionstring
  计费类型描述。
- remixed_from_video_idstring, 必填
  源视频任务 ID。

响应

{
  "id": "qvideo-user123-1766454050923137689",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "created_at": 1766454050,
  "updated_at": 1766454050,
  "seconds": "4",
  "size": "1280x720",
  "remixed_from_video_id": "qvideo-user123-1766453713089395279"
}

创建视频生成任务

POST

/v3/contents/generations/tasks

异步创建视频生成任务（火山引擎格式）。成功后返回任务 id，需配合「查询视频生成任务」接口轮询或等待回调获取结果。

含人像素材的单次生成可使用可选字段 auto_create_assets，详见 Seedance 虚拟人像生视频自动临时素材。

项目	说明
名称	创建视频生成任务
任务类型	文生视频；图生视频首帧；图生视频首尾帧；多模态参考生视频
结果获取	轮询「查询视频生成任务」接口，或等待回调通知

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

请求头

Name
Authorization
Type
string, 必填
Description
操作参数。

请求体

请求体属性

modelstring, 必填
要调用的模型 ID（Model ID）。
- - text
  - textstring, 必填
    文本提示词；建议中文不超过约 500 字、英文约 1000 词。
- - image_url
  - urlstring, 必填
    图片URL地址
  - rolestring
    图片用途，支持 first_frame、last_frame、reference_image 。在图生视频任务中不必须，其余任务为必须。首尾帧与参考图不能混用
- - video_url
  - urlstring, 必填
    公网视频 URL 或 asset:// 素材 ID。
  - rolestring, 必填
    视频用途，当前仅支持 reference_video。
- - audio_url
  - urlstring, 必填
    公网 URL、data:audio/<格式>;base64,... 或 asset://。
  - rolestring, 必填
    音频用途，当前仅支持 reference_audio。
- - draft_task
  - idstring, 必填
    样片（Draft）任务 ID，用于生成正式成片。
callback_urlstring
任务状态变更时，服务端向该地址发起 POST 回调；回调体结构与「查询视频生成任务」接口的返回体一致。
return_last_frameboolean
为 true 时可通过查询接口获取生成视频的尾帧 PNG，用于多段连续视频衔接。
default: false
- default
- flex
execution_expires_afterinteger
任务过期时间（秒），从 created_at 起算。超过后任务标记为 expired。取值范围 [3600, 259200]，默认 172800（48 小时）。
default: 172800; minimum: 3600; maximum: 259200
generate_audioboolean
是否生成与画面同步的声音。仅 Seedance 2.0 / 2.0 fast、Seedance 1.5 pro 等模型支持。
default: true
draftboolean
是否开启样片（Draft）模式。仅 Seedance 1.5 pro 支持；样片模式有分辨率等限制。
default: false
- typestring
  工具类型，例如联网搜索。
safety_identifierstring
终端用户唯一标识（英文字符串），用于合规检测；建议对用户名等做哈希，长度不超过 64。
- 480p
- 720p
- 1080p
- 4k
ratiostring
输出宽高比，如 16:9、4:3、1:1、9:16、21:9、adaptive（按输入自动选择）等；依模型而定。
durationinteger
生成视频时长（秒，整数）。与 frames 二选一，若同时存在 frames 则 frames 优先。部分模型支持 -1 表示由模型自选时长。
framesinteger
生成帧数，用于小数秒时长。与 duration 二选一。Seedance 2.0 / 2.0 fast、1.5 pro 等可能不支持；取值需满足产品文档中的公式与范围。
seedinteger
随机种子，控制可重复性；范围 [-1, 2^32-1]。-1 表示随机。
default: -1
camera_fixedboolean
是否固定摄像头视角。参考图场景不支持；Seedance 2.0 / 2.0 fast 暂不支持。
default: false
watermarkboolean
生成视频是否包含水印。
default: false
auto_create_assetsboolean
可选。为 true 时，对 content 中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/v3/contents/generations/tasks

curl https://api.qnaigc.com/v3/contents/generations/tasks \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "bytedance/doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "夕阳下的城市街道，电影感镜头缓慢推进"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true
}'

响应

object

创建成功，返回任务 ID。

响应体属性

idstring, 必填
视频生成任务 ID；创建时 draft 为 true 时为 Draft 任务 ID。异步任务需调用查询接口获取状态与 video_url。

响应

{
  "id": "qvideo-xxxxxxxxxxxxxxxx"
}

查询视频生成任务

GET

/v3/contents/generations/tasks/{id}

根据任务 id 查询视频生成任务状态与结果。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
id
Type
string, 必填
Description
待查询的视频生成任务 ID。

请求头

Name
Authorization
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/v3/contents/generations/tasks/{id}

curl https://api.qnaigc.com/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json'

响应

object

成功返回任务详情（业务失败时仍可能 HTTP 200，需结合 status、error 判断）。

响应体属性

idstring
视频生成任务 ID。
modelstring
任务使用的模型名称和版本，格式为 模型名称-版本。
- queued
  排队中
- running
  任务运行中
- cancelled
  已取消（取消状态约 24h 自动删除；仅排队中可取消）
- succeeded
  任务成功
- failed
  任务失败
- expired
  任务超时
- codestring
  错误码。
- messagestring
  错误提示信息。
created_atinteger<int64>
任务创建时间的 Unix 时间戳（秒）。
updated_atinteger<int64>
当前状态更新时间的 Unix 时间戳（秒）。
- video_urlstring
  生成视频 mp4 地址；约 24 小时后清理，请及时转存。
- last_frame_urlstring
  尾帧图 URL；创建任务时 return_last_frame 为 true 时返回；约 24 小时有效。
seedinteger
本次任务使用的随机种子。
resolutionstring
生成视频的分辨率。
ratiostring
生成视频的宽高比。
durationinteger
生成视频时长（秒）。与 frames 只会返回其一；创建时未指定 frames 时通常返回 duration。
framesinteger
生成视频帧数。与 duration 只会返回其一；创建时指定了 frames 时返回 frames。
framespersecondinteger
生成视频的帧率（FPS）。
generate_audioboolean
生成视频是否含同步音频。仅部分模型（如 Seedance 1.5 pro）返回。
- - web_search
    联网搜索
safety_identifierstring
创建任务时传入的终端用户标识；未设置则不返回或为空。
draftboolean
是否为 Draft 样片视频。仅部分模型返回。
draft_task_idstring
Draft 视频任务 ID；基于 Draft 生成正式成片时可能返回。
service_tierstring
实际处理使用的服务等级（如 default / flex）。
execution_expires_afterinteger
任务超时阈值（秒）。
- completion_tokensinteger
  模型输出视频消耗的 token 数。
- total_tokensinteger
  总消耗 token；视频模型输入 token 计为 0，故通常等于 completion_tokens。
- - web_searchinteger
    联网搜索实际调用次数。

响应

{
  "id": "qvideo-xxxxx-1775645542150946615",
  "model": "bytedance/doubao-seedance-2-0-260128",
  "status": "succeeded",
  "created_at": 1775645542,
  "updated_at": 1775646115,
  "content": {
    "video_url": "https://aitoken-video.qnaigc.com/xxxxxxxx"
  },
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 11,
  "usage": {
    "completion_tokens": 411300,
    "total_tokens": 411300
  },
  "service_tier": "default",
  "framespersecond": 24,
  "execution_expires_after": 172800
}

创建文生视频任务

POST

/queue/bytedance/seedance-2.0/text-to-video

提交文本提示词生成视频任务。成功时返回 IN_QUEUE 及后续查询用的 request_id、状态/结果 URL。支持通过查询参数 fal_webhook 指定 HTTPS 回调地址，回调 payload 为 Fal 格式。prompt 必填且不超过 2500 字符。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 2500 字符。
- 480p
- 720p
- 1080p
- 4k
durationstring
时长，字符串形式整数秒，范围 4–15；空或 auto 表示使用默认推导。
aspect_ratiostring
画幅比例。支持：21:9、16:9、4:3、1:1、3:4、9:16；空或 auto 表示自动。
generate_audioboolean
是否生成音频，可选。
auto_create_assetsboolean
可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/text-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/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": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建图生视频任务

POST

/queue/bytedance/seedance-2.0/image-to-video

基于首帧图片（及可选尾帧）与文本提示词生成视频。image_url 必填；end_image_url 可选。图片支持公网 HTTP(S) URL 或 data:image/... Base64（大小受限）。含人像的 HTTP(S) 图片可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填。
image_urlstring, 必填
首帧图像 URL（http/https）或 data:image/... Base64。
end_image_urlstring
尾帧图像 URL，可选，规则同 image_url。
- 480p
- 720p
- 1080p
- 4k
durationstring
时长，字符串秒数 4–15 或 auto/空。
aspect_ratiostring
画幅比例，同文生视频。
generate_audioboolean
是否生成音频。
auto_create_assetsboolean
可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/image-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/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": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
  "image_url": "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建参考生视频任务

POST

/queue/bytedance/seedance-2.0/reference-to-video

基于多模态参考（图片、视频、音频）与提示词生成视频。至少需提供 image_urls 或 video_urls 中一类；若提供 audio_urls，则必须同时至少包含一张参考图或一段参考视频。参考数量约束：图片最多 9 张，视频最多 3 段，音频最多 3 段，合计不超过 12。含人像的 HTTP(S) 媒体可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填。
image_urlsstring[]
参考图片 URL 列表，最多 9 张。
video_urlsstring[]
参考视频 URL 列表，最多 3 段。
audio_urlsstring[]
参考音频 URL 列表，最多 3 段；若仅传音频而不传图/视频则非法。
- 480p
- 720p
- 1080p
- 4k
durationstring
时长，字符串秒数 4–15 或 auto/空。
aspect_ratiostring
画幅比例。
generate_audioboolean
是否生成音频。
auto_create_assetsboolean
可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/reference-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/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": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
  "image_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
  ],
  "video_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
  ],
  "audio_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
  ],
  "duration": "4",
  "generate_audio": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

查询任务状态

GET

/queue/bytedance/seedance-2.0/requests/{request_id}/status

根据 request_id（即创建任务返回的 request_id）查询任务状态。未完成时通常返回 HTTP 202 与 IN_QUEUE 或 IN_PROGRESS；已完成（成功或失败）返回 HTTP 200，status 为 COMPLETED，失败时在 detail 中给出错误信息，成功时可在 result 中看到视频信息。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
任务 ID，与提交成功响应中的 request_id 一致。

请求体

暂无请求体

请求

GET/queue/bytedance/seedance-2.0/requests/{request_id}/status

curl https://api.qnaigc.com/queue/bytedance/seedance-2.0/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务已结束（成功或失败），status 为 COMPLETED

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

object

任务仍在排队或处理中

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

查询任务结果

GET

/queue/bytedance/seedance-2.0/requests/{request_id}

获取任务最终结果。若任务仍在进行中，返回 HTTP 400，响应体为 Fal 状态结构且 detail.type 为 request_in_progress。若任务失败、取消或过期，返回对应 HTTP 状态码及 FalErrorResponse。成功则返回 HTTP 200，正文为 FalResultResponse（含 video）。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
任务 ID。

请求体

暂无请求体

请求

GET/queue/bytedance/seedance-2.0/requests/{request_id}

curl https://api.qnaigc.com/queue/bytedance/seedance-2.0/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务成功完成，返回视频结果

响应体属性

- urlstring, 必填
  图片下载链接（Kodo 签名 URL）。
- content_typestring, 必填
  必填。
- file_namestring
  可选。
- file_sizeinteger<int64>
  可选。
- widthinteger
  可选。
- heightinteger
  可选。
- urlstring, 必填
  视频下载链接（有效期有限，建议尽快下载）。
- content_typestring, 必填
  必填。
- durationnumber<double>
  视频时长（秒）。
- file_namestring
  可选。
- file_sizeinteger<int64>
  文件大小（字节）。

object

任务尚未完成（仍在队列或处理中）

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "images": [
    {
      "url": "string",
      "content_type": "string",
      "file_name": "string",
      "file_size": 42,
      "width": 42,
      "height": 42
    }
  ],
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  }
}

创建文生视频任务

POST

/queue/fal-ai/veo3.1

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1?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 monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\""
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建首尾帧生视频任务

POST

/queue/fal-ai/veo3.1/first-last-frame-to-video

使用首帧和尾帧图片生成视频，支持 Google Veo 3.1 模型。两张图片如果是 HTTP URL 会自动并行转存到 GCS。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
first_frame_urlstring, 必填
URL of the first frame of the video
last_frame_urlstring, 必填
URL of the last frame of the video
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/first-last-frame-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/first-last-frame-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 woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3.1 First-Last-Frame-to-Video on Fal? It'\''s incredible!\"",
  "first_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-1.jpeg",
  "last_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-2.jpeg",
  "aspect_ratio": "16:9"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建图生视频任务

POST

/queue/fal-ai/veo3.1/image-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
image_urlstring, 必填
URL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit.
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/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": "A monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\"",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

查询状态

GET

/queue/fal-ai/veo3.1/requests/{request_id}/status

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

查询参数

Name
logs
Type
number
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/veo3.1/requests/{request_id}/status

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/requests/{request_id}/status?logs={logs}' \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

获取结果

GET

/queue/fal-ai/veo3.1/requests/{request_id}

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/veo3.1/requests/{request_id}

curl https://api.qnaigc.com/queue/fal-ai/veo3.1/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

Result of the request.

响应体属性

- urlstring, 必填
  图片下载链接（Kodo 签名 URL）。
- content_typestring, 必填
  必填。
- file_namestring
  可选。
- file_sizeinteger<int64>
  可选。
- widthinteger
  可选。
- heightinteger
  可选。
- urlstring, 必填
  视频下载链接（有效期有限，建议尽快下载）。
- content_typestring, 必填
  必填。
- durationnumber<double>
  视频时长（秒）。
- file_namestring
  可选。
- file_sizeinteger<int64>
  文件大小（字节）。

object

任务尚未完成（进行中），或 request_id 无效。

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "images": [
    {
      "url": "string",
      "content_type": "string",
      "file_name": "string",
      "file_size": 42,
      "width": 42,
      "height": 42
    }
  ],
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  }
}

创建文生视频任务

POST

/queue/fal-ai/veo3.1/fast

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast?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 monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\""
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建首尾帧生视频任务

POST

/queue/fal-ai/veo3.1/fast/first-last-frame-to-video

使用首帧和尾帧图片生成视频，支持 Google Veo 3.1 模型。两张图片如果是 HTTP URL 会自动并行转存到 GCS。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
first_frame_urlstring, 必填
URL of the first frame of the video
last_frame_urlstring, 必填
URL of the last frame of the video
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast/first-last-frame-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast/first-last-frame-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 woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3.1 First-Last-Frame-to-Video on Fal? It'\''s incredible!\"",
  "first_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-1.jpeg",
  "last_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-2.jpeg",
  "aspect_ratio": "16:9"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建图生视频任务

POST

/queue/fal-ai/veo3.1/fast/image-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
image_urlstring, 必填
URL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit.
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast/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": "A monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\"",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建文生视频任务

POST

/queue/bytedance/seedance-2.0/fast/text-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 2500 字符。
- 480p
- 720p
durationstring
时长，字符串形式整数秒，范围 4–15；空或 auto 表示使用默认推导。
aspect_ratiostring
画幅比例。支持：21:9、16:9、4:3、1:1、3:4、9:16；空或 auto 表示自动。
generate_audioboolean
是否生成音频，可选。
auto_create_assetsboolean
可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/fast/text-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/fast/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": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建图生视频任务

POST

/queue/bytedance/seedance-2.0/fast/image-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填。
image_urlstring, 必填
首帧图像 URL（http/https）或 data:image/... Base64。
end_image_urlstring
尾帧图像 URL，可选，规则同 image_url。
- 480p
- 720p
durationstring
时长，字符串秒数 4–15 或 auto/空。
aspect_ratiostring
画幅比例，同文生视频。
generate_audioboolean
是否生成音频。
auto_create_assetsboolean
可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/fast/image-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/fast/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": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
  "image_url": "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg",
  "auto_create_assets": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建参考生视频任务

POST

/queue/bytedance/seedance-2.0/fast/reference-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，必填。
image_urlsstring[]
参考图片 URL 列表，最多 9 张。
video_urlsstring[]
参考视频 URL 列表，最多 3 段。
audio_urlsstring[]
参考音频 URL 列表，最多 3 段；若仅传音频而不传图/视频则非法。
- 480p
- 720p
durationstring
时长，字符串秒数 4–15 或 auto/空。
aspect_ratiostring
画幅比例。
generate_audioboolean
是否生成音频。
auto_create_assetsboolean
可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/fast/reference-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/fast/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": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
  "image_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
  ],
  "video_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
  ],
  "audio_urls": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
  ],
  "duration": "4",
  "generate_audio": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建文生视频任务

POST

/queue/fal-ai/vidu/q1/text-to-video

创建文生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
stylestring
风格默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制注：使用q2模型时该参数不生效
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数默认5秒，可选：5
resolutionstring
分辨率参数，默认值依据模型和视频时长而定： viduq1(5秒)：默认 1080p，可选：1080p
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q1/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q1/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": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
  "seed": 1,
  "duration": 5,
  "resolution": "1080p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建参考生视频任务-主体调用（支持音视频功能）

POST

/queue/fal-ai/vidu/q1/reference-to-video

创建参考生视频任务参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词；返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注1：字符长度不能超过 2000 个字符注2：使用sujects主体参数时，可以通过@主体id 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"
- idstring, 必填
  主体id，后续生成时可以通过@主体id的方式使用
- imagesstring[], 必填
  该主体对应的图片url，每个主体最多支持3张图片注1：支持传入图片 Base64 编码或图片URL（确保可访问）注2：图片支持 png、jpeg、jpg、webp格式注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1，且大小不超过50M。注4：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
- voice_idstring, 必填
  音色ID用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：新音色列表或者您可以使用声音复刻API来复刻任意音色，voice_id可以互通
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
audioboolean
是否使用音视频直出能力，可选值 true、false true：使用音视频直出能力。 false：不使用音视频直出能力。使用subjects参数调用音视频直出能力时选用
durationinteger
视频时长参数 viduq1：默认5秒，可选：5
resolutionstring
分辨率参数，默认值依据模型和视频时长而定： viduq1(5秒)：默认 1080p，可选：1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q1/reference-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q1/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": "The @devil is looking at the @apple on the @beach and walking around @beach.",
  "subjects": [
    {
      "id": "devil",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    },
    {
      "id": "apple",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png"
      ],
      "voice_id": ""
    },
    {
      "id": "beach",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png"
      ],
      "voice_id": ""
    }
  ],
  "seed": 2,
  "duration": 5,
  "resolution": "1080p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

查询任务状态

GET

/queue/fal-ai/vidu/requests/{request_id}/status

根据request_id查询视频任务的状态

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/vidu/requests/{request_id}/status

curl https://api.qnaigc.com/queue/fal-ai/vidu/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

响应.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。
- inference_timeinteger, 必填
  必填。
- - urlstring, 必填
    必填。
  - content_typestring, 必填
    必填。

响应

{
  "status": "COMPLETED",
  "request_id": "qvideo-root-1770720203757316283",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770720203757316283",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770720203757316283/status",
  "cancel_url": "",
  "metrics": {
    "inference_time": 2252
  },
  "result": {
    "video": {
      "url": "https://aitoken-video.qnaigc.com/root/qvideo-root-1770720203757316283/1.mp4?e=1771327255&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:ak0Qh973b2_JYshnkbvwG87rakI=",
      "content_type": "video/mp4"
    }
  }
}

查询任务结果

GET

/queue/fal-ai/vidu/requests/{request_id}

根据request_id查询视频任务的结果

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/vidu/requests/{request_id}

curl https://api.qnaigc.com/queue/fal-ai/vidu/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

响应.

响应体属性

- urlstring, 必填
  必填。
- content_typestring, 必填
  必填。

object

响应.

响应体属性

statusstring, 必填
状态
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。
queue_positioninteger, 必填
必填。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- locstring[], 必填
  必填。
- msgstring, 必填
  必填。
- typestring, 必填
  必填。
- urlstring, 必填
  错误类型文档链接。

响应

{
  "video": {
    "url": "https://aitoken-video.qnaigc.com/root/qvideo-root-1770708425639493000/1.mp4?e=1771314526&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:fw2OIbh4wSMbl5UA1VxIf-y-kP0=",
    "content_type": "video/mp4"
  }
}

创建文生视频任务

POST

/queue/fal-ai/vidu/q2/text-to-video

创建文生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
stylestring
风格默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制注：使用q2模型时该参数不生效
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数默认5秒，可选：1-10
resolutionstring
分辨率参数，默认值依据模型和视频时长而定： viduq2(1-10秒)：默认 720p，可选：540p、720p、1080p
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q2/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/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": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
  "seed": 1,
  "duration": 5,
  "resolution": "1080p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建参考生视频任务-主体调用（支持音视频功能）

POST

/queue/fal-ai/vidu/q2/reference-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注1：字符长度不能超过 2000 个字符注2：使用sujects主体参数时，可以通过@主体id 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"
- idstring, 必填
  主体id，后续生成时可以通过@主体id的方式使用
- imagesstring[], 必填
  该主体对应的图片url，每个主体最多支持3张图片注1：支持传入图片 Base64 编码或图片URL（确保可访问）注2：图片支持 png、jpeg、jpg、webp格式注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1，且大小不超过50M。注4：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
- voice_idstring, 必填
  音色ID用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：新音色列表或者您可以使用声音复刻API来复刻任意音色，voice_id可以互通
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
audioboolean
是否使用音视频直出能力，可选值 true、false true：使用音视频直出能力。 false：不使用音视频直出能力。使用subjects参数调用音视频直出能力时选用
durationinteger
视频时长参数 viduq2：默认5秒，可选：1-10
resolutionstring
分辨率参数，默认值依据模型和视频时长而定： viduq2 （1-10秒）：默认 720p, 可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q2/reference-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/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": "The @devil is looking at the @apple on the @beach and walking around @beach.",
  "subjects": [
    {
      "id": "devil",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    },
    {
      "id": "apple",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    },
    {
      "id": "beach",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    }
  ],
  "seed": 2,
  "duration": 5,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建图生视频任务

POST

/queue/fal-ai/vidu/q2/image-to-video/pro

创建图生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
audioboolean
是否使用音视频直出能力，默认为false，枚举值为：

false：不需要音视频直出，输出静音视频

true：需要音视频直出，输出带台词以及背景音的视频注1：该参数为true时，voice_id参数才生效注2：该参数为true时，仅q3模型支持错峰注3：当model 为q3 时，该参数默认值为true
voice_idstring
音色id，用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq2-pro 默认为 5，可选：1、2、3、4、5、6、7、8、9、10
resolutionstring
分辨率参数 viduq2-pro 默认为 5，可选：1、2、3、4、5、6、7、8、9、10
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
watermarkboolean
是否添加水印，可选。

请求

POST/queue/fal-ai/vidu/q2/image-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/image-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "这个人在跑马拉松",
  "image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto",
  "watermark": true
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建首尾帧生视频任务

POST

/queue/fal-ai/vidu/q2/start-end-to-video/pro

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
start_image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
end_image_urlstring, 必填
尾帧图像模型将以此参数中传入的图片为尾帧画面来生成视频。要求同上
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq2-pro 1-8秒：默认 720p，可选：540p、720p、1080p
resolutionstring
分辨率参数 viduq2-pro 1-8秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q2/start-end-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/start-end-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Dragon lands on a rock",
  "start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
  "end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建参考生视频任务-非主体调用（视频生成）

POST

/queue/fal-ai/vidu/q2/reference-to-video/pro

创建参考生视频任务参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词。返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
reference_image_urlsstring[], 必填
图像参考支持上传1～7张图片，模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。注1： viduq2、viduq1、vidu2.0模型支持上传1～7张图片注2：使用viduq2-pro模型时，如果不上传视频，则支持上传1-7张图，如果上传视频则支持1-4张图注3：支持传入图片 Base64 编码或图片URL（确保可访问）注4：图片支持 png、jpeg、jpg、webp格式注5：图片像素不能小于 128*128，且比例需要小于1:4或者4:1，且大小不超过50M。注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}
reference_video_urlsstring[], 必填
视频参考支持上传1～2个视频，模型将以此参数中传入的视频作为参考，生成具备主体一致的视频。
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq2：默认5秒，可选：1-10
resolutionstring
分辨率参数 viduq2 （1-10秒）：默认 720p, 可选：540p、720p、1080p
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q2/reference-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/reference-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "@Figure 1 Character Reference@Refer to the special effects, movements, and camera work of Video 1.",
  "reference_image_urls": [
    "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-image-3123041388101890.png"
  ],
  "reference_video_urls": [
    "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-video-3123002003131623.mp4"
  ],
  "duration": 4,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建图生视频任务

POST

/queue/fal-ai/vidu/q2/image-to-video/turbo

创建图生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
audioboolean
是否使用音视频直出能力，默认为false，枚举值为：

false：不需要音视频直出，输出静音视频

true：需要音视频直出，输出带台词以及背景音的视频注1：该参数为true时，voice_id参数才生效注2：该参数为true时，仅q3模型支持错峰注3：当model 为q3 时，该参数默认值为true
voice_idstring
音色id，用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq2-turbo 默认为 5，可选：1、2、3、4、5、6、7、8、9、10
resolutionstring
分辨率参数，默认值依据模型和视频时长而定： viduq2-turbo 1-10秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q2/image-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/image-to-video/turbo?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "这个人在跑马拉松",
  "image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建首尾帧生视频任务

POST

/queue/fal-ai/vidu/q2/start-end-to-video/turbo

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
start_image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
end_image_urlstring, 必填
尾帧图像模型将以此参数中传入的图片为尾帧画面来生成视频。要求同上
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq2-turbo 默认为 5，可选：1、2、3、4、5、6、7、8
resolutionstring
viduq2-turbo 1-8秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q2/start-end-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/start-end-to-video/turbo?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Dragon lands on a rock",
  "start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
  "end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建图生视频任务

POST

/queue/fal-ai/vidu/q3/image-to-video/pro

创建图生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
audioboolean
是否使用音视频直出能力，默认为false，枚举值为：

false：不需要音视频直出，输出静音视频

true：需要音视频直出，输出带台词以及背景音的视频注1：该参数为true时，voice_id参数才生效注2：该参数为true时，仅q3模型支持错峰注3：当model 为q3 时，该参数默认值为true
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-pro 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-pro 1-16秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q3/image-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/image-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "这个人在跑马拉松",
  "image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建文生视频任务

POST

/queue/fal-ai/vidu/q3/text-to-video/pro

创建文生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
stylestring
风格默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制注：使用q2模型时该参数不生效
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-pro 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-pro 1-16秒：默认 720p，可选：540p、720p、1080p
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q3/text-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/text-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
  "seed": 1,
  "duration": 5,
  "resolution": "1080p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建首尾帧生视频任务

POST

/queue/fal-ai/vidu/q3/start-end-to-video/pro

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
start_image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
end_image_urlstring, 必填
尾帧图像模型将以此参数中传入的图片为尾帧画面来生成视频。要求同上
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-pro 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-pro 1-16秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q3/start-end-to-video/pro

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/start-end-to-video/pro?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Dragon lands on a rock",
  "start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
  "end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建参考生视频任务

POST

/queue/fal-ai/vidu/q3/reference-to-video/turbo

使用 Vidu Q3 Turbo 模型创建参考生视频任务。

API 路径带 /turbo 后缀，服务端内部模型 ID 为 viduq3-turbo。支持 1 到 7 张参考图片，不支持 reference_video_urls。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频生成提示词，Vidu Q3 系列最长 2000 字符。
reference_image_urlsstring[], 必填
参考图片 URL 列表，支持 HTTP(S) 图片 URL 或 data:image/* Base64 图片。 Vidu Q3 / Q3 Turbo 参考生视频支持 1 到 7 张参考图片。
durationinteger
视频时长，单位秒；未传时默认 5 秒，取值范围为 3 到 16。
default: 5; minimum: 3; maximum: 16
- 540p
- 720p
- 1080p
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
seedinteger
随机种子；不传或传 0 时由系统自动生成。
- auto
- small
- medium
- large
bgmboolean | null
是否添加背景音乐；不传表示未指定。
audioboolean | null
是否音视频直出；不传表示未指定。

请求

POST/queue/fal-ai/vidu/q3/reference-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/reference-to-video/turbo?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 character walking through a beach catching an apple.",
  "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"
  ]
}'

响应

object

任务提交成功，返回排队状态和查询地址

响应体属性

statusstring, 必填
任务状态，创建成功后通常为 IN_QUEUE。
request_idstring, 必填
视频任务唯一 ID，用于查询状态和结果。
response_urlstring<uri>, 必填
查询任务最终结果的 URL。
status_urlstring<uri>, 必填
查询任务状态的 URL。
cancel_urlstring
取消任务的 URL（暂不支持）。
queue_positioninteger
队列位置（入队时为 0）。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status"
}

创建图生视频任务

POST

/queue/fal-ai/vidu/q3/image-to-video/turbo

创建图生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
audioboolean
是否使用音视频直出能力，默认为false，枚举值为：

false：不需要音视频直出，输出静音视频

true：需要音视频直出，输出带台词以及背景音的视频注1：该参数为true时，voice_id参数才生效注2：该参数为true时，仅q3模型支持错峰注3：当model 为q3 时，该参数默认值为true
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q3/image-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/image-to-video/turbo?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "这个人在跑马拉松",
  "image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建文生视频任务

POST

/queue/fal-ai/vidu/q3/text-to-video/turbo

创建文生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
stylestring
风格默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制注：使用q2模型时该参数不生效
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
aspect_ratiostring
比例默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large
bgmboolean
是否为生成的视频添加背景音乐。默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q3/text-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/text-to-video/turbo?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
  "seed": 1,
  "duration": 5,
  "resolution": "1080p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建首尾帧生视频任务

POST

/queue/fal-ai/vidu/q3/start-end-to-video/turbo

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring
文本提示词生成视频的文本描述。注：字符长度不能超过 2000 个字符
start_image_urlstring, 必填
首帧图像模型将以此参数中传入的图片为首帧画面来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
end_image_urlstring, 必填
尾帧图像模型将以此参数中传入的图片为尾帧画面来生成视频。要求同上
is_recboolean
是否使用推荐提示词

true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1

false：否，根据输入的prompt生成视频
seedinteger
随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
movement_amplitudestring
运动幅度默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q3/start-end-to-video/turbo

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/start-end-to-video/turbo?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Dragon lands on a rock",
  "start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
  "end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
  "seed": 2,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
视频任务状态
request_idstring, 必填
视频任务唯一 ID
response_urlstring, 必填
查询任务结果的URL
status_urlstring, 必填
查询任务状态的URL
cancel_urlstring, 必填
取消任务的URL（暂未支持）

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建参考生视频任务

POST

/queue/fal-ai/vidu/q3/reference-to-video

使用 Vidu Q3 标准模型创建参考生视频任务。

API 路径为裸路径 /q3/reference-to-video，服务端内部模型市场 ID 为 vidu/viduq3。支持 1 到 7 张参考图片，不支持 reference_video_urls。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频生成提示词，Vidu Q3 系列最长 2000 字符。
reference_image_urlsstring[], 必填
参考图片 URL 列表，支持 HTTP(S) 图片 URL 或 data:image/* Base64 图片。 Vidu Q3 / Q3 Turbo 参考生视频支持 1 到 7 张参考图片。
durationinteger
视频时长，单位秒；未传时默认 5 秒，取值范围为 3 到 16。
default: 5; minimum: 3; maximum: 16
- 540p
- 720p
- 1080p
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
seedinteger
随机种子；不传或传 0 时由系统自动生成。
- auto
- small
- medium
- large
bgmboolean | null
是否添加背景音乐；不传表示未指定。
audioboolean | null
是否音视频直出；不传表示未指定。

请求

POST/queue/fal-ai/vidu/q3/reference-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/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": "A character walking through a beach catching an apple.",
  "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"
  ]
}'

响应

object

任务提交成功，返回排队状态和查询地址

响应体属性

statusstring, 必填
任务状态，创建成功后通常为 IN_QUEUE。
request_idstring, 必填
视频任务唯一 ID，用于查询状态和结果。
response_urlstring<uri>, 必填
查询任务最终结果的 URL。
status_urlstring<uri>, 必填
查询任务状态的 URL。
cancel_urlstring
取消任务的 URL（暂不支持）。
queue_positioninteger
队列位置（入队时为 0）。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status"
}

文生视频

POST

/queue/fal-ai/kling-video/v2.5-turbo/{mode}/text-to-video

v2.5-turbo text-to-video 仅支持 pro mode。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
v2.5-turbo text-to-video 仅支持 pro。

查询参数

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

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填，最长 2500 个字符。
negative_promptstring
负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
default: blur, distort, and low quality
- 5
- 10
- 16:9
- 9:16
- 1:1
cfg_scalenumber
提示词遵循强度，数值越大越贴近提示词。默认 0.5。
default: 0.5; minimum: 0; maximum: 1

请求

POST/queue/fal-ai/kling-video/v2.5-turbo/{mode}/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v2.5-turbo/{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 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."
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v2.5-turbo/{mode}/image-to-video

v2.5-turbo 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
v2.5-turbo image-to-video 支持 standard/pro。

查询参数

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

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填，最长 2500 个字符。
image_urlstring<uri>, 必填
视频首帧参考图 URL，必填。
tail_image_urlstring<uri>
可选的视频尾帧参考图 URL。
negative_promptstring
负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
default: blur, distort, and low quality
- 5
- 10
cfg_scalenumber
提示词遵循强度，数值越大越贴近提示词。默认 0.5。
default: 0.5; minimum: 0; maximum: 1

请求

POST/queue/fal-ai/kling-video/v2.5-turbo/{mode}/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v2.5-turbo/{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": "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.",
  "image_url": "https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v2.6/{mode}/text-to-video

v2.6 text-to-video 仅支持 pro mode。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
仅支持 pro。

查询参数

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

请求体

请求体属性

- promptstring, 必填
  视频内容提示词，必填，最长 2500 个字符。
- negative_promptstring
  负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
  default: blur, distort, and low quality
- - 5
  - 10
- - 16:9
  - 9:16
  - 1:1
- cfg_scalenumber
  提示词遵循强度，数值越大越贴近提示词。默认 0.5。
  default: 0.5; minimum: 0; maximum: 1
- generate_audioboolean
  是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。
  default: true

请求

POST/queue/fal-ai/kling-video/v2.6/{mode}/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v2.6/{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": "Old friends reuniting at a train station after 20 years, one exclaims '\''Is that really you?!'\'' other tearfully replies '\''I promised I'\''d come back, didn'\''t I?'\'', train whistle, steam hissing, emotional orchestral swell, crowd murmur"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v2.6/{mode}/image-to-video

v2.6 image-to-video 仅支持 pro mode。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
仅支持 pro。

查询参数

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

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填，最长 2500 个字符。
start_image_urlstring<uri>, 必填
视频首帧参考图 URL，必填。
end_image_urlstring<uri>
可选的视频尾帧参考图 URL。
negative_promptstring
负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
default: blur, distort, and low quality
- 5
- 10
generate_audioboolean
是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。
default: true
voice_idsstring[]
可选的声音 ID，最多 2 个。在提示词中使用 <<<voice_1>>> 和 <<<voice_2>>> 引用。

请求

POST/queue/fal-ai/kling-video/v2.6/{mode}/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v2.6/{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": "A king walks slowly and says \"My people, here I am! I am here to save you all\"",
  "start_image_url": "https://v3b.fal.media/files/b/0a84ab29/BSJXz9Ht-jgRgMf4IGxLU_upscaled.png"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v2.6/{mode}/motion-control

v2.6 motion-control 支持 standard/pro。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

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

查询参数

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

请求体

请求体属性

promptstring
可选的动作与画面补充提示词，最长 2500 个字符。
image_urlstring<uri>, 必填
角色参考图 URL，必填。角色身体比例应清晰、无遮挡，且主体面积应大于画面的 5%。
video_urlstring<uri>, 必填
动作参考视频 URL，必填。视频应包含无遮挡的真人全身或上半身（含头部）；character_orientation=image 时最长 10 秒，video 时最长 30 秒。
- image
- video
keep_original_soundboolean
是否保留动作参考视频的原始声音。默认 true。
default: true

请求

POST/queue/fal-ai/kling-video/v2.6/{mode}/motion-control

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v2.6/{mode}/motion-control?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "image_url": "https://v3b.fal.media/files/b/0a90ffa7/TNErq9yD7ZxGRATjfAqnh_EIgJSN67.png",
  "video_url": "https://v3b.fal.media/files/b/0a90ff92/hklvF__w53diz6Rve7f5__JuDW2xl0mr6sJ_Kjz3Vxe_vidoeook%20(1)_1.mp4",
  "character_orientation": "image"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v3/{mode}/text-to-video

v3 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 个字符。
negative_promptstring
负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
default: blur, distort, and low quality
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
generate_audioboolean
是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。
default: true
- customize
- intelligent
- 16:9
- 9:16
- 1:1
cfg_scalenumber
提示词遵循强度，数值越大越贴近提示词。默认 0.5。
default: 0.5; minimum: 0; maximum: 1

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/{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": "Close-up of glowing fireflies dancing in a dark forest at twilight. Soft bioluminescent particles float through the air. Shallow depth of field, bokeh lights in background. Magical atmosphere, gentle movement."
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v3/{mode}/image-to-video

v3 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 互斥，最长 2500 个字符。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
start_image_urlstring<uri>, 必填
视频首帧参考图 URL，必填。
end_image_urlstring<uri>
可选的视频尾帧参考图 URL。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
generate_audioboolean
是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。
default: true
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
- customize
- intelligent
negative_promptstring
负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。
default: blur, distort, and low quality
cfg_scalenumber
提示词遵循强度，数值越大越贴近提示词。默认 0.5。
default: 0.5; minimum: 0; maximum: 1

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/{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": "生成一个视频",
  "start_image_url": "https://storage.googleapis.com/falserverless/example_inputs/kling-v3/pro-i2v/start_image.png"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v3/{mode}/motion-control

当前分支代码中，v3 motion-control 支持 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
  可选的动作与画面补充提示词，最长 2500 个字符。
- image_urlstring<uri>, 必填
  角色参考图 URL，必填。角色身体比例应清晰、无遮挡，且主体面积应大于画面的 5%。
- video_urlstring<uri>, 必填
  动作参考视频 URL，必填。视频应包含无遮挡的真人全身或上半身（含头部）；character_orientation=image 时最长 10 秒，video 时最长 30 秒。
- - image
  - video
- keep_original_soundboolean
  是否保留动作参考视频的原始声音。默认 true。
  default: true
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
  - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
    reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。

请求

POST/queue/fal-ai/kling-video/v3/{mode}/motion-control

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/{mode}/motion-control?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "image_url": "https://v3b.fal.media/files/b/0a90ffa7/TNErq9yD7ZxGRATjfAqnh_EIgJSN67.png",
  "video_url": "https://v3b.fal.media/files/b/0a90ff92/hklvF__w53diz6Rve7f5__JuDW2xl0mr6sJ_Kjz3Vxe_vidoeook%20(1)_1.mp4",
  "character_orientation": "image"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v3/turbo/{mode}/text-to-video

可灵 3.0 Turbo 文生视频。mode 仅支持 pro(1080P)/standard(720P)；含声音、按秒计费（720P 0.8 元/s、1080P 1.0 元/s）。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
清晰度档位：pro=1080P，standard=720P。

查询参数

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

请求体

请求体属性

promptstring
文本提示词。与 multi_prompt 互斥。建议不超过 2500 字符。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
- 16:9
- 9:16
- 1:1
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/turbo/{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": "一只红色的狐狸在雪地森林中行走，电影质感",
  "aspect_ratio": "16:9",
  "duration": "5"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/v3/turbo/{mode}/image-to-video

可灵 3.0 Turbo 图生视频。mode 仅支持 pro(1080P)/standard(720P)；image_url 为首帧参考图，必填；图生视频画幅由首帧决定，不支持 aspect_ratio。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
清晰度档位：pro=1080P，standard=720P。

查询参数

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

请求体

请求体属性

promptstring
文本提示词。与 multi_prompt 互斥。建议不超过 2500 字符。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
image_urlstring, 必填
首帧参考图 URL 或 base64。必填。格式 .jpg/.jpeg/.png，≤50MB，宽高 ≥300px，宽高比 1:2.5 ~ 2.5:1。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/turbo/{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": "让画面中的角色微笑并看向镜头",
  "image_url": "https://your-cdn.com/first-frame.jpg",
  "duration": "5"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/o1/{mode}/image-to-video

o1 image-to-video 支持 standard/pro，不支持 4k；pro 也兼容 /queue/fal-ai/kling-video/o1/image-to-video 省略 mode 路径。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

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

查询参数

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

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填。可使用 @Image1 引用首帧、@Image2 引用尾帧。
start_image_urlstring<uri>, 必填
视频首帧图像 URL，必填。图片不超过 10MB，宽高均不少于 300px，宽高比为 1:2.5～2.5:1。
end_image_urlstring<uri>
可选的视频尾帧图像 URL。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o1/{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": "Create a magical timelapse transition. The snow melts rapidly to reveal green grass, and the tree branches burst into bloom with pink flowers in real-time. The lighting shifts from cold winter light to warm spring sunshine. The camera pushes in slowly towards the tree. Disney-style magical transformation, cinematic, 8k.",
  "start_image_url": "https://v3b.fal.media/files/b/rabbit/NaslJIC7F2WodS6DFZRRJ.png"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/o1/{mode}/reference-to-video

o1 reference-to-video 支持 standard/pro，不支持 4k；pro 也兼容 /queue/fal-ai/kling-video/o1/reference-to-video 省略 mode 路径。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

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

查询参数

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

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填。使用 @Image1、@Element1 等按顺序引用参考图片和主体。
image_urlsstring[]
风格或外观参考图 URL 列表，在提示词中按 @Image1、@Image2 顺序引用。与 elements 合计最多 7 项。
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 16:9
- 9:16
- 1:1

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/o1/{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": "Create a magical timelapse transition. The snow melts rapidly to reveal green grass, and the tree branches burst into bloom with pink flowers in real-time. The lighting shifts from cold winter light to warm spring sunshine. The camera pushes in slowly towards the tree. Disney-style magical transformation, cinematic, 8k.",
  "image_urls": [
    "https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg"
  ]
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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}/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 个字符。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16:9
- 9:16
- 1:1
generate_audioboolean
是否生成原生音频。默认 false。
default: false
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
- 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

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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。
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
generate_audioboolean
是否生成原生音频。默认 false。
default: false
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
- customize
- intelligent
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - 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

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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 等引用输入素材。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
start_image_urlstring<uri>
可选的视频首帧图像 URL。
end_image_urlstring<uri>
可选的视频尾帧图像 URL。
image_urlsstring[]
风格或外观参考图 URL 列表，在提示词中按 @Image1、@Image2 顺序引用。
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
generate_audioboolean
是否生成原生音频。默认 false。
default: false
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- customize
- intelligent
- 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

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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"
    }
  ]
}

查询任务状态

GET

/queue/fal-ai/kling-video/requests/{request_id}/status

查询当前用户的 Kling Video 任务状态。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务返回的 request_id。

请求体

暂无请求体

请求

GET/queue/fal-ai/kling-video/requests/{request_id}/status

curl https://api.qnaigc.com/queue/fal-ai/kling-video/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务已完成或失败

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

object

任务排队中或处理中

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

查询任务结果

GET

/queue/fal-ai/kling-video/requests/{request_id}

查询当前用户的 Kling Video 任务结果。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务返回的 request_id。

请求体

暂无请求体

请求

GET/queue/fal-ai/kling-video/requests/{request_id}

curl https://api.qnaigc.com/queue/fal-ai/kling-video/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务完成，返回视频结果

响应体属性

- urlstring, 必填
  图片下载链接（Kodo 签名 URL）。
- content_typestring, 必填
  必填。
- file_namestring
  可选。
- file_sizeinteger<int64>
  可选。
- widthinteger
  可选。
- heightinteger
  可选。
- urlstring, 必填
  视频下载链接（有效期有限，建议尽快下载）。
- content_typestring, 必填
  必填。
- durationnumber<double>
  视频时长（秒）。
- file_namestring
  可选。
- file_sizeinteger<int64>
  文件大小（字节）。

object | object

任务仍在处理中，或请求参数错误

响应体属性

- - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
  - FAILED
- request_idstring, 必填
  必填。
- response_urlstring<uri>, 必填
  必填。
- status_urlstring<uri>, 必填
  必填。
- cancel_urlstring
  取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
- queue_positioninteger
  可选。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- - inference_timenumber<double>
    推理耗时（秒）。
- - locstring[]
    错误位置。
    msgstring
    人类可读的错误描述。
    typestring
    机器可读的错误分类标识符。
    urlstring
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - oneOf[1]null
    可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。

响应

{
  "images": [
    {
      "url": "string",
      "content_type": "string",
      "file_name": "string",
      "file_size": 42,
      "width": 42,
      "height": 42
    }
  ],
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  }
}

文生视频

POST

/queue/byteplus/seedance-2.0/fast/text-to-video

提交文生视频任务，返回 IN_QUEUE 状态和 request_id。 prompt 最大 2500 字符。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
pattern: ^([4-9]|1[0-5])$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
promptstring, 必填
视频描述文本，最大 2500 字符。
auto_create_assetsboolean
可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/fast/text-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/fast/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": "一只猫在阳光下慵懒地伸展，4K 高清",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-abc123",
  "response_url": "https://api.aitoken.com/queue/byteplus/seedance-2.0/fast/requests/qvideo-abc123",
  "status_url": "https://api.aitoken.com/queue/byteplus/seedance-2.0/fast/requests/qvideo-abc123/status",
  "queue_position": 0,
  "logs": []
}

图生视频（首帧/首尾帧）

POST

/queue/byteplus/seedance-2.0/fast/image-to-video

提交图生视频任务。

image_url（必填）：首帧图片，支持 HTTPS URL、base64 data URI（data:image/...）、qasset:// 引用
end_image_url（可选）：末帧图片，提供后走「首尾帧」模式
auto_create_assets（可选）：含人像 HTTP(S) 图片时可开启临时素材审核，详见 Seedance 虚拟人像生视频自动临时素材 prompt 最大 2500 字符。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
pattern: ^([4-9]|1[0-5])$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlstring, 必填
首帧图片。支持：

HTTPS URL

base64 data URI（data:image/jpeg;base64,...），最大 50MB

qasset 引用（qasset://qasset-{uid}-{ts}）
end_image_urlstring
末帧图片（可选）。提供后走「首尾帧」模式。支持格式同 image_url。
auto_create_assetsboolean
可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/fast/image-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/fast/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": "镜头缓慢推进，阳光透过树叶洒落",
  "image_url": "https://example.com/frame.jpg",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/fast/reference-to-video

提交多模态参考生视频任务，支持图片、视频、音频参考素材混合输入。

数量限制

类型	最大数量
image_urls	9
video_urls	3
audio_urls	3
总计	12

约束

image_urls 或 video_urls 至少提供其一
单独提供 audio_urls 而不提供图片/视频时报错
URL 支持 HTTPS URL 和 qasset:// 引用

prompt 最大 2500 字符。

含人像的 HTTP(S) 媒体可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
pattern: ^([4-9]|1[0-5])$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlsstring[]
参考图片列表，最多 9 张，支持 HTTPS URL 和 qasset 引用。
video_urlsstring[]
参考视频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。
audio_urlsstring[]
参考音频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。注意：单独提供 audio_urls 而不提供 image_urls/video_urls 时请求会被拒绝。
auto_create_assetsboolean
可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/fast/reference-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/fast/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": "参考图片中的风格，生成一段动态场景",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "resolution": "720p",
  "duration": "5"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/bytedance/seedance-2.0/mini/text-to-video

提交文生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/mini/text-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/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": "星空下的城市夜景延时摄影",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

图生视频

POST

/queue/bytedance/seedance-2.0/mini/image-to-video

提交图生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

含人像的 HTTP(S) 图片可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlstring, 必填
首帧图片。支持 HTTPS URL、最大 50MB 的 base64 data URI 和 qasset 引用。
end_image_urlstring
末帧图片（可选）。提供后走首尾帧模式，支持格式同 image_url。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/mini/image-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/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": "镜头缓慢推进，阳光透过树叶洒落",
  "image_url": "https://example.com/frame.jpg",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "auto_create_assets": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

多模态参考生视频

POST

/queue/bytedance/seedance-2.0/mini/reference-to-video

提交参考生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

含人像的 HTTP(S) 媒体可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlsstring[]
参考图片列表，最多 9 张，支持 HTTPS URL 和 qasset 引用。
video_urlsstring[]
参考视频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。
audio_urlsstring[]
参考音频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。单独提供 audio_urls 而不提供 image_urls 或 video_urls 时，请求会被拒绝。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.0/mini/reference-to-video

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/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": "参考图片风格，生成一段动态场景",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "resolution": "720p",
  "duration": "5",
  "auto_create_assets": true
}'

响应

object

任务已入队

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

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

创建图生视频任务

POST

/queue/fal-ai/vidu/q1/image-to-video

创建图生视频任务，返回任务ID和查询任务状态及结果的URL。 viduq1 图生视频固定时长 5 秒、分辨率 1080p，不支持尾帧和背景音乐。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
文本提示词生成视频的文本描述。注：字符长度不能超过 1500 个字符
image_urlstring, 必填
首帧图像
seedinteger
随机种子，用于提高结果的可复现性；不填时随机生成。
- auto
- small
- medium
- large

请求

POST/queue/fal-ai/vidu/q1/image-to-video

curl https://api.qnaigc.com/queue/fal-ai/vidu/q1/image-to-video \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "这个人在跑马拉松",
  "image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
  "seed": 2,
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
必填。
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。

响应

{
  "status": "IN_QUEUE",
  "request_id": "qvideo-root-1770718628185826174",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
  "cancel_url": ""
}

创建首尾帧生视频任务

POST

/queue/fal-ai/vidu/q1/start-end-to-video

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL。 viduq1 首尾帧生视频固定时长 5 秒、分辨率 1080p；start_image_url 和 end_image_url 均为必填。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

请求头

Name
Content-Type
Type
string
Description
操作参数。

请求体

请求体属性

promptstring, 必填
视频内容提示词，必填，最长 1500 个字符。
start_image_urlstring<uri>, 必填
视频首帧图像 URL，必填。
end_image_urlstring<uri>, 必填
视频尾帧图像 URL，必填。
seedinteger
随机种子，用于提高结果的可复现性；不填时随机生成。
- auto
- small
- medium
- large

请求

POST/queue/fal-ai/vidu/q1/start-end-to-video

curl https://api.qnaigc.com/queue/fal-ai/vidu/q1/start-end-to-video \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Dragon lands on a rock",
  "start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
  "end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
  "seed": 2,
  "movement_amplitude": "auto"
}'

响应

object

响应.

响应体属性

statusstring, 必填
必填。
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。

响应

{
  "status": "string",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string"
}

文生视频

POST

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

根据文字提示生成视频，支持风格参考图（image_urls）和主体参考（elements）。

注意： mode 仅支持 std/standard/pro，不支持 4k。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
分辨率档位（不支持 4k）：std/standard = 720P，pro = 1080P。

请求体

请求体属性

promptstring
视频生成提示词，最多 2500 字符
image_urlsstring[]
风格参考图片 URL 列表（可选，≤7 张，每张≤10MB）
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
- 5
- 10
- 16:9
- 9:16
- 1:1

请求

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

curl https://api.qnaigc.com/queue/fal-ai/kling-video/o1/{mode}/text-to-video \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "在星空下的草原上，萤火虫点点闪烁",
  "duration": "5",
  "aspect_ratio": "16:9"
}'

响应

object & object

任务提交成功

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/o1/{mode}/video-to-video/edit

对已有视频进行 AI 编辑，例如背景替换、风格迁移等。

注意： mode 仅支持 std/standard/pro，不支持 4k。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
分辨率档位（不支持 4k）

请求体

请求体属性

promptstring, 必填
编辑指令（必填），描述对视频的修改意图
video_urlstring, 必填
待编辑的原始视频 URL（必填），MP4/MOV，3-10s
image_urlsstring[]
风格参考图片 URL 列表（可选）
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留原视频音频

请求

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

curl https://api.qnaigc.com/queue/fal-ai/kling-video/o1/{mode}/video-to-video/edit \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "把背景替换成日落时的沙滩",
  "video_url": "https://example.com/original.mp4",
  "keep_audio": true
}'

响应

object & object

任务提交成功

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/o1/{mode}/video-to-video/reference

以参考视频的动作或镜头语言为基础，生成全新内容的视频。

注意： mode 仅支持 std/standard/pro，不支持 4k。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
分辨率档位（不支持 4k）

请求体

请求体属性

promptstring, 必填
视频生成提示词（必填）
video_urlstring, 必填
动作/镜头参考视频 URL（必填），MP4/MOV，3-10s
image_urlsstring[]
风格或主体参考图片 URL 列表（可选）
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留参考视频音频
- 16:9
- 9:16
- 1:1
- 5
- 10

请求

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

curl https://api.qnaigc.com/queue/fal-ai/kling-video/o1/{mode}/video-to-video/reference \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "基于参考视频的运镜方式，展示一片金色麦田",
  "video_url": "https://example.com/motion.mp4",
  "aspect_ratio": "16:9",
  "duration": "5",
  "keep_audio": false
}'

响应

object & object

任务提交成功

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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 列表（可选）。
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留输入视频原声，默认 true。
- customize
- 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

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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 列表（可选）。
- - oneOf[0]string
    可选。
    oneOf[1]integer<int64>
    可选。
- - frontal_image_urlstring, 必填
    主体正面图 URL（必填），需公网可访问并通过 SSRF 白名单。
  - reference_image_urlsstring[]
    其他角度参考图 URL 列表（选填），0~3 张。
keep_audioboolean
是否保留输入视频原声，默认 true。
- 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

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/text-to-video

提交文生视频任务，返回 IN_QUEUE 状态和 request_id。 prompt 最大 2500 字符。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- - 480p
  - 720p
  - 1080p
  - 4k
- durationstring
  视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
  pattern: ^([4-9]|1[0-5])$
- - 21:9
  - 16:9
  - 4:3
  - 1:1
  - 3:4
  - 9:16
  - auto
- generate_audioboolean
  是否生成背景音频。
- promptstring, 必填
  视频描述文本，最大 2500 字符。
- auto_create_assetsboolean
  可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/text-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/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": "一只在草原奔跑的猎豹，电影级画质",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/image-to-video

提交图生视频任务。

image_url（必填）：首帧图片
end_image_url（可选）：末帧图片，提供后走「首尾帧」模式 prompt 最大 2500 字符。

含人像的 HTTP(S) 图片可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- - 480p
  - 720p
  - 1080p
  - 4k
- durationstring
  视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
  pattern: ^([4-9]|1[0-5])$
- - 21:9
  - 16:9
  - 4:3
  - 1:1
  - 3:4
  - 9:16
  - auto
- generate_audioboolean
  是否生成背景音频。
- promptstring, 必填
  视频描述文本，最大 2500 字符。
- image_urlstring, 必填
  首帧图片。支持：
  
  HTTPS URL
  
  base64 data URI（data:image/jpeg;base64,...），最大 50MB
  
  qasset 引用（qasset://qasset-{uid}-{ts}）
- end_image_urlstring
  末帧图片（可选）。提供后走「首尾帧」模式。支持格式同 image_url。
- auto_create_assetsboolean
  可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/image-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/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": "图中人物自然转身并对镜头微笑",
  "image_url": "https://example.com/person.jpg",
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": "5"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/reference-to-video

提交多模态参考生视频任务，支持图片、视频、音频参考素材混合输入。

含人像的 HTTP(S) 媒体可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

- - 480p
  - 720p
  - 1080p
  - 4k
- durationstring
  视频时长（秒），取值范围 4～15，传字符串格式。留空时由模型自动决定。
  pattern: ^([4-9]|1[0-5])$
- - 21:9
  - 16:9
  - 4:3
  - 1:1
  - 3:4
  - 9:16
  - auto
- generate_audioboolean
  是否生成背景音频。
- promptstring, 必填
  视频描述文本，最大 2500 字符。
- image_urlsstring[]
  参考图片列表，最多 9 张，支持 HTTPS URL 和 qasset 引用。
- video_urlsstring[]
  参考视频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。
- audio_urlsstring[]
  参考音频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。注意：单独提供 audio_urls 而不提供 image_urls/video_urls 时请求会被拒绝。
- auto_create_assetsboolean
  可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/reference-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/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": "参考图片中的人物与服装，自然走动",
  "image_urls": [
    "https://example.com/person.jpg"
  ],
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": "5"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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"
    }
  ]
}

查询任务状态

GET

/queue/byteplus/seedance-2.0/requests/{request_id}/status

轮询任务状态。fast 变体任务的状态查询与 fal 官方一致，路径中不含 /fast。

处理中：HTTP 202，status 为 IN_QUEUE 或 IN_PROGRESS
完成/失败：HTTP 200，status 为 COMPLETED

建议轮询间隔：2～5 秒

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务时返回的 request_id

请求体

暂无请求体

请求

GET/queue/byteplus/seedance-2.0/requests/{request_id}/status

curl https://api.qnaigc.com/queue/byteplus/seedance-2.0/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object & object

任务已完成（成功或失败）

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
- queue_positioninteger
  队列位置，仅 IN_QUEUE 状态有意义。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- - inference_timenumber<double>
    推理耗时（秒）。
- - locstring[]
    错误位置。
    msgstring
    人类可读的错误描述。
    typestring
    机器可读的错误分类标识符。
    urlstring
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。

object & object

任务处理中

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
- queue_positioninteger
  队列位置，仅 IN_QUEUE 状态有意义。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- - inference_timenumber<double>
    推理耗时（秒）。
- - locstring[]
    错误位置。
    msgstring
    人类可读的错误描述。
    typestring
    机器可读的错误分类标识符。
    urlstring
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "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"
    }
  ],
  "metrics": {
    "inference_time": 42
  }
}

获取任务结果

GET

/queue/byteplus/seedance-2.0/requests/{request_id}

获取已完成任务的视频结果。fast 变体任务的结果查询与 fal 官方一致，路径中不含 /fast。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务时返回的 request_id

请求体

暂无请求体

请求

GET/queue/byteplus/seedance-2.0/requests/{request_id}

curl https://api.qnaigc.com/queue/byteplus/seedance-2.0/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务成功，返回视频结果

响应体属性

- urlstring, 必填
  视频下载链接（有效期有限，建议尽快下载）。
- content_typestring, 必填
  必填。
- durationnumber<double>
  视频时长（秒）。
- file_namestring
  可选。
- file_sizeinteger<int64>
  文件大小（字节）。

object & object

任务仍在处理中

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
- queue_positioninteger
  队列位置，仅 IN_QUEUE 状态有意义。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- - inference_timenumber<double>
    推理耗时（秒）。
- - locstring[]
    错误位置。
    msgstring
    人类可读的错误描述。
    typestring
    机器可读的错误分类标识符。
    urlstring
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  }
}

文生视频

POST

/queue/byteplus/seedance-2.0/mini/text-to-video

提交文生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。文生视频通常无媒体 URL，传 true 通常不额外建素材；与图生/参考生视频字段语义一致。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/mini/text-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/mini/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": "string",
  "resolution": "720p",
  "duration": "string",
  "aspect_ratio": "21:9",
  "generate_audio": true,
  "auto_create_assets": true
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/mini/image-to-video

提交图生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

含人像的 HTTP(S) 图片可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlstring, 必填
首帧图片。支持 HTTPS URL、最大 50MB 的 base64 data URI 和 qasset 引用。
end_image_urlstring
末帧图片（可选）。提供后走首尾帧模式，支持格式同 image_url。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。为 true 时，对 image_url / end_image_url 中的 HTTP(S) 图片自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/mini/image-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/mini/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": "图中人物自然转身并对镜头微笑",
  "image_url": "https://example.com/person.jpg",
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": "5"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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/byteplus/seedance-2.0/mini/reference-to-video

提交参考生视频任务（mini 变体）。成功时返回 IN_QUEUE 及 request_id、状态/结果 URL。

含人像的 HTTP(S) 媒体可传 auto_create_assets: true 由平台自动创建临时素材，详见 Seedance 虚拟人像生视频自动临时素材。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
视频描述文本，最大 2500 字符。
image_urlsstring[]
参考图片列表，最多 9 张，支持 HTTPS URL 和 qasset 引用。
video_urlsstring[]
参考视频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。
audio_urlsstring[]
参考音频列表，最多 3 个，支持 HTTPS URL 和 qasset 引用。单独提供 audio_urls 而不提供 image_urls 或 video_urls 时，请求会被拒绝。
- 480p
- 720p
durationstring
视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。
pattern: ^([4-9]|1[0-5]|auto)$
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- auto
generate_audioboolean
是否生成背景音频。
auto_create_assetsboolean
可选。为 true 时，对请求中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.0/mini/reference-to-video

curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/mini/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": "参考图片中的人物与服装，自然走动",
  "image_urls": [
    "https://example.com/person.jpg"
  ],
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": "5"
}'

响应

object & object

任务已入队

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - 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"
    }
  ]
}