Modelink

OpenAPI 参考

Modelink API · 视频

Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo、MiniMax H3/H3 Max 等多厂商的文生视频、图生视频与任务查询能力。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

请求体

请求体属性

  • oneOf[0]object

    additionalProperties: false

    • modelenum, 必填

      模型名称。对应可灵文档 model_name 字段。

      default: kling-v3-omni

    • multi_shotboolean

      是否生成多镜头视频。当前参数为 true 时，prompt 参数无效；当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。

      default: false

    • shot_typeenum

      分镜方式。枚举值：customize。当 multi_shot 参数为 true 时，当前参数必填。

    • promptstring

      文本提示词，可包含正向描述和负向描述。可将提示词模板化来满足不同的视频生成需求。Omni 模型可通过 Prompt 与主体、图片、视频等内容实现多种能力：通过 <<<>>> 的格式来指定某个主体、图片、视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>。长度不能超过 2500 个字符。当 multi_shot 参数为 false 或 shot_type 参数为 intelligence 时，当前参数不得为空。不同模型版本、视频模式支持范围不同，详见能力地图。

    • multi_promptobject[]

      各分镜信息，如提示词、时长等。通过 index、prompt、duration 参数定义分镜序号及相应提示词和时长，其中：最多支持 6 个分镜，最少支持 1 个分镜；每个分镜相关内容的最大长度不超过 512；每个分镜的时长不大于当前任务的总时长，不小于 1；所有分镜的时长之和等于当前任务的总时长。当 multi_shot 参数为 true 且 shot_type 参数为 customize 时，当前参数不得为空。

    • image_listobject[]

      参考图列表。包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频。当作为首帧或尾帧生成视频时：通过 type 参数来定义图片是否为首尾帧（first_frame 为首帧，end_frame 为尾帧）；暂不支持仅尾帧，即有尾帧图时必须有首帧图；首帧或首尾帧生视频时，不能使用视频编辑功能。支持传入图片 Base64 编码或图片 URL（确保可访问）。图片格式支持 .jpg/.jpeg/.png，文件大小不超过 10MB，宽高尺寸不小于 300px，宽高比在 1:2.5~2.5:1 之间。有参考视频时，参考图片数量不得超过 4；无参考视频时，参考图片数量不得超过 7。数组中超过 2 张图片时，不支持设置尾帧。image_url 参数值不得为空。

    • video_listobject[]

      参考视频，通过 URL 方式获取。可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声。通过 refer_type 参数区分参考视频类型：feature 为特征参考视频，base 为待编辑视频。参考视频为待编辑视频时，不能定义视频首尾帧。通过 keep_original_sound 参数选择是否保留视频原声（yes 为保留，no 为不保留），当前参数对特征参考视频（feature）也生效。有参考视频时，sound 参数值只能为 off。视频格式仅支持 MP4/MOV；视频时长不少于 3 秒，上限与模型版本有关；视频宽高尺寸需介于 720px（含）和 2160px（含）之间；视频帧率基于 24fps~60fps，生成视频时会输出为 24fps。至多仅支持上传 1 段视频，视频大小不超过 200MB。video_url 参数值不得为空。不同模型版本、视频模式支持范围不同，详见能力地图。

    • soundenum

      生成视频时是否同时生成声音。

      default: off

    • modeenum

      生成视频的模式。枚举值：std，pro，4k。其中 std：标准模式（720P），基础模式，性价比高；其中 pro：专家模式（1080P），高表现模式，生成视频质量更佳；4k：4K模式，高表现（同pro），生成视频质量更佳，输出视频分辨率为4K。不同模型版本、视频模式支持范围不同，详见能力地图https://docs.qingque.cn/d/home/eZQAyImcbaS0fz-8ANjXvU5ed?identityId=2Cn18n4EIHT。

      default: pro

    • sizestring

      生成视频的画面纵横比（宽:高）。对应可灵的 aspect_ratio 字段，服务内部自动将 size（如 1280x720）转换为 aspect_ratio（如 16:9）。可灵文档枚举值：16:9, 9:16, 1:1。未使用首帧参考或视频编辑功能时，当前参数必填。

    • secondsenum

      生成视频时长，单位 s。对应可灵文档 duration 字段。枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15。使用视频编辑功能（refer_type 为 base）时，输出结果与传入视频时长相同，此时当前参数无效，按输入视频时长四舍五入取整计量计费。不同模型版本、视频模式支持范围不同，详见能力地图。

      default: 5

    • watermark_infoobject

      是否同时生成含水印的结果。通过 enabled 参数定义。暂不支持自定义水印。

  • oneOf[1]object

    Sora 视频创建请求体（用于 POST /v1/videos，model 以 sora 开头时）。支持文生视频与图生视频。

    additionalProperties: false

    • modelenum, 必填

      模型名称。可选值：sora-2、sora-2-pro。

    • promptstring, 必填

      文本提示词，描述希望生成的视频内容。最大 2500 字符。

    • input_referencestring<uri>

      参考图片 URL，用于图生视频。传入该字段后自动走图生视频流程，图片尺寸需与 size 一致。仅支持文生视频时可省略。

    • secondsenum

      视频时长（秒）。枚举值：4、8、12。

      default: 4

    • sizeenum

      视频分辨率（宽 x 高）。sora-2 仅支持 1280x720 / 720x1280；sora-2-pro 额外支持 1792x1024 / 1024x1792。

      default: 720x1280

请求

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，用于后续查询任务状态

  • objectenum, 必填

    对象类型，固定为 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

    计费类型描述。

响应

application/json
{
  "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

  • objectenum, 必填

    对象类型，固定为 video

  • modelstring

    使用的模型名称

  • modestring

    生成模式，std 或 pro，仅在成功时返回

  • statusenum, 必填

    任务状态：initializing(初始化中)、queued(排队中)、in_progress(处理中)、downloading(下载中)、uploading(上传中)、completed(已完成)、failed(失败)、cancelled(已取消)

  • created_atinteger

    创建时间（Unix 时间戳，秒）

  • updated_atinteger

    更新时间（Unix 时间戳，秒）

  • completed_atinteger

    完成时间（Unix 时间戳，秒），仅在已完成或失败时返回

  • secondsstring

    视频时长（秒）

  • sizestring

    视频分辨率（宽 x 高）

  • task_resultobject

    任务结果，包含生成的视频列表，仅在已完成时返回

    • videosobject[]

      生成的视频列表

  • errorobject

    错误信息，仅在失败时返回

    • codestring

      错误码

    • messagestring

      错误描述

响应

application/json
{
  "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 任务创建成功

响应体属性

  • allOf[0]object
    • idstring, 必填

      视频任务唯一 ID，用于后续查询任务状态

    • objectenum, 必填

      对象类型，固定为 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

      计费类型描述。

  • allOf[1]object
    • remixed_from_video_idstring, 必填

      源视频任务 ID。

响应

application/json
{
  "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 虚拟人像生视频自动临时素材。

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

模型能力

能力Seedance 2.5Seedance 2.0 标准版Seedance 2.0 Fast / Mini
最高分辨率1080p4K720p
最长输出30 秒15 秒15 秒
输出格式MP4、MOVMP4MP4
纯音频参考支持不支持不支持
参考图片上限3099
参考视频 / 音频上限各 10各 3各 3
素材总上限501212
返回尾帧、有声视频支持支持支持

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选的视频结果格式。设为 origin 时，创建任务返回 cgt-* 火山格式的任务 ID，后续查询和成功回调返回火山原始生成物 URL；省略时，返回默认的 qvideo-* 任务 ID 和平台转存后的结果 URL。唯一支持的非空值为 origin，其他值会返回 HTTP 400。该请求头仅在创建任务时读取，查询任务时无需重复传入。

请求体

请求体属性

  • modelenum, 必填

    要调用的模型 ID（Model ID）。

  • contentobject | object | object | object | object[], 必填

    输入给模型的内容片段数组，可组合文本、图片、视频、音频或样片任务 ID（draft_task 仅 1.5 pro）。

    多模态参考数量：Seedance 2.0 / Fast / Mini 为图最多 9、视频最多 3、音频最多 3（合计不超过 12）；Seedance 2.5 为图最多 30、视频最多 10、音频最多 10（合计不超过 50）。仅音频参考（可带 text）仅 Seedance 2.5 允许。

    • oneOf[0]object

      additionalProperties: true

    • oneOf[1]object

      additionalProperties: true

    • oneOf[2]object

      additionalProperties: true

    • oneOf[3]object

      additionalProperties: true

    • oneOf[4]object

      additionalProperties: true

  • callback_urlstring

    任务状态变更时，服务端向该地址发起 POST 回调；回调体结构与「查询视频生成任务」接口的返回体一致。

  • return_last_frameboolean

    为 true 时可通过查询接口获取生成视频的尾帧 PNG，用于多段连续视频衔接。

    default: false

  • service_tierenum

    服务等级：default 为在线推理；flex 为离线推理（配额更高、价更低、时延更高）。已提交任务不可修改。Seedance 2.0 / 2.0 fast / 2.5 不支持 flex。

    default: default

  • execution_expires_after3600

    任务超时阈值，固定为 3600 秒且不可修改。超过后任务标记为 expired，超时任务不计费。

    const: 3600

  • generate_audioboolean

    是否生成与画面同步的声音。Seedance 2.0 / 2.0 fast / 2.5、Seedance 1.5 pro 等模型支持。

    default: true

  • draftboolean

    是否开启样片（Draft）模式。仅 Seedance 1.5 pro 支持；Seedance 2.5 不支持。

    default: false

  • toolsobject[]

    模型工具配置。Seedance 2.0 / 2.0 fast 等支持，例如联网搜索。

    • typestring

      工具类型，例如联网搜索。

  • safety_identifierstring

    终端用户唯一标识（英文字符串），用于合规检测；建议对用户名等做哈希，长度不超过 64。

  • omni_reference_task_typeenum

    Seedance 2.5 全模态参考任务类型，仅用于多模态参考生视频任务。edit 和 extend 必须在 content 中包含 role: reference_video 的视频；这两类任务传入 ratio 时必须为 adaptive，使用 edit 时传入的 duration 必须为 -1。

    default: auto

  • output_formatenum

    输出封装格式。仅 Seedance 2.5 支持。mp4 通用；mov（yuv444p + PCM）更适合多次延长/剪辑。

    default: mp4

  • priorityinteger

    队列优先级，取值 [0, 9]。Seedance 2.0 / 2.5 支持。

    minimum: 0; maximum: 9

  • resolutionenum

    输出视频分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；2.0 fast/mini 支持 480p、720p；Seedance 2.5 支持 480p、720p、1080p，不支持 4k。默认为 720p。

    default: 720p

  • ratioenum

    输出宽高比。Seedance 2.5 的视频编辑、视频延长、首帧 / 首尾帧生视频任务仅支持 adaptive。

  • durationinteger

    生成视频时长（秒，整数）。与 frames 二选一，若同时存在 frames 则 frames 优先。Seedance 2.0：4–15 或 -1；Seedance 2.5：4–30 或 -1。未传时网关不发明默认秒数（2.5 上游按智能时长处理）。计费走 completion_tokens。

  • framesinteger

    生成帧数，用于小数秒时长。与 duration 二选一。Seedance 2.0 / 2.0 fast、1.5 pro 等可能不支持；Seedance 2.5 不支持传 frames。

  • seedinteger

    随机种子，控制可重复性；范围 [-1, 2^32-1]。-1 表示随机。Seedance 2.5 不支持。

    default: -1

  • camera_fixedboolean

    是否固定摄像头视角。参考图场景不支持；Seedance 2.0 / 2.0 fast / 2.5 不支持。

    default: false

  • watermarkboolean

    生成视频是否包含水印。

    default: false

  • auto_create_assetsboolean

    可选。为 true 时，对 content 中的 HTTP(S) 图片/视频/音频自动创建临时素材并审核后再生成视频；未传或 false 保持历史行为。详见 Seedance 虚拟人像生视频自动临时素材。

  • reference_video_task_idstring

    可选。显式指定 content 中 role: reference_video 的已完成 Seedance 源任务 ID，用于固定续创渠道。支持 qvideo-* 或 cgt-* 格式；平台会校验租户、供应商、任务状态和渠道一致性。开启 auto_create_assets=true 时忽略此字段。

请求

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。

响应

application/json
{
  "id": "qvideo-xxxxxxxxxxxxxxxx"
}

查询视频生成任务

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

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

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

  • Name
    id
    Type
    string, 必填
    Description

    待查询的视频生成任务 ID。

请求体

暂无请求体

请求

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

    任务使用的模型名称和版本，格式为 模型名称-版本。

  • statusenum

    任务状态。

  • errorobject | null

    任务成功时为 null；失败时为错误对象。

    • codestring

      错误码。

    • messagestring

      错误提示信息。

  • created_atinteger<int64>

    任务创建时间的 Unix 时间戳（秒）。

  • updated_atinteger<int64>

    当前状态更新时间的 Unix 时间戳（秒）。

  • contentobject

    视频生成任务的输出内容。

    • 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

    生成视频是否含同步音频（可从创建请求回填）。

  • toolsobject[]

    本次请求实际使用的工具；未使用工具时可能不返回该字段。

    • typeenum

      实际使用的工具类型。

  • safety_identifierstring

    创建任务时传入的终端用户标识；未设置则不返回或为空。

  • draftboolean

    是否为 Draft 样片视频。仅部分模型返回。

  • draft_task_idstring

    Draft 视频任务 ID；基于 Draft 生成正式成片时可能返回。

  • output_formatenum

    输出封装格式（从创建请求回填）。仅 Seedance 2.5：mp4 / mov。

  • priorityinteger

    创建时传入的队列优先级（从创建请求回填）。Seedance 2.0 / 2.5 支持。

  • service_tierstring

    实际处理使用的服务等级（如 default / flex）。

  • execution_expires_after3600

    任务超时阈值，固定为 3600 秒且不可修改。超过后任务标记为 expired，超时任务不计费。

    const: 3600

  • usageobject

    本次请求的 Token 用量。部分视频模型只返回输出 Token，因此 total_tokens 可能与 completion_tokens 相等；详见 Usage 字段与计费对账。

    • completion_tokensinteger

      模型输出视频消耗的 token 数。

    • total_tokensinteger

      总消耗 token；视频模型输入 token 计为 0，故通常等于 completion_tokens。

    • tool_usageobject

      工具用量；仅在使用对应工具时返回。

响应

application/json
{
  "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": 3600
}

创建文生视频任务

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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填，去除首尾空格后长度不超过 2500 字符。

  • resolutionenum

    输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

    default: 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/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 & object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

查询参数

  • 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。

  • resolutionenum

    输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

    default: 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/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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填。

  • image_urlsstring[]

    参考图片 URL 列表，最多 9 张。

  • video_urlsstring[]

    参考视频 URL 列表，最多 3 段。

  • audio_urlsstring[]

    参考音频 URL 列表，最多 3 段；若仅传音频而不传图/视频则非法。

  • resolutionenum

    输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

    default: 720p

  • 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

路径参数

  • 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 & object

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

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

路径参数

  • 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 & object

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

响应体属性

  • allOf[0]object

    任务结果。图片类任务返回 images，视频类任务返回 video。

    • imagesobject[]

      图片结果列表（图片类任务）。

    • videoobject
  • allOf[1]object
    • usageobject

      Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。

响应

application/json
{
  "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
  },
  "usage": {
    "completion_tokens": 42,
    "total_tokens": 42
  }
}

创建文生视频任务

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

使用 Doubao Seedance 2.5 创建文生视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • aspect_ratioenum

    画面比例。留空或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。纯文生视频通常不会创建素材。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.5/text-to-video
curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.5/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": "30",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "status": "IN_QUEUE",
  "request_id": "qvideo-example",
  "response_url": "https://api.qnaigc.com/queue/bytedance/seedance-2.5/requests/qvideo-example",
  "status_url": "https://api.qnaigc.com/queue/bytedance/seedance-2.5/requests/qvideo-example/status",
  "cancel_url": "",
  "queue_position": 0,
  "logs": []
}

创建图生视频任务

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

使用首帧图片及可选尾帧图片创建 Doubao Seedance 2.5 视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • image_urlstring, 必填

    首帧图片。支持公网 HTTP(S) URL、data:image/... Base64 或 qasset:// 素材引用。

  • end_image_urlstring

    可选的尾帧图片，格式规则同 image_url。提供后按首尾帧模式生成。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.5/image-to-video
curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.5/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/first-frame.jpg",
  "end_image_url": "https://example.com/last-frame.jpg",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "auto_create_assets": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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.5/reference-to-video

使用多模态参考素材创建 Doubao Seedance 2.5 视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • image_urlsstring[]

    参考图片列表，与 video_urls 至少提供其一。支持公网 HTTP(S) URL、data:image/... Base64 或 qasset:// 素材引用。

  • video_urlsstring[]

    参考视频列表，与 image_urls 至少提供其一。支持公网 HTTP(S) URL 或 qasset:// 素材引用。

  • audio_urlsstring[]

    参考音频列表。支持公网 HTTP(S) URL 或 qasset:// 素材引用。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • aspect_ratioenum

    画面比例。留空或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/bytedance/seedance-2.5/reference-to-video
curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.5/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/character.jpg"
  ],
  "video_urls": [
    "https://example.com/camera-motion.mp4"
  ],
  "audio_urls": [
    "https://example.com/background.mp3"
  ],
  "resolution": "720p",
  "duration": "12",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "auto_create_assets": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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.5/requests/{request_id}/status

查询 Doubao Seedance 2.5 任务状态。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    创建任务时返回的 request_id。

请求体

暂无请求体

请求

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

响应

object & object

任务已结束（成功或失败）

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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.5/requests/{request_id}

获取 Doubao Seedance 2.5 任务的最终视频结果。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    创建任务时返回的 request_id。

请求体

暂无请求体

请求

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

响应

object & object

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

响应体属性

  • allOf[0]object

    任务结果。图片类任务返回 images，视频类任务返回 video。

    • imagesobject[]

      图片结果列表（图片类任务）。

    • videoobject
  • allOf[1]object
    • usageobject

      Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。

响应

application/json
{
  "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
  },
  "usage": {
    "completion_tokens": 42,
    "total_tokens": 42
  }
}

创建文生视频任务

POST
/queue/fal-ai/veo3.1

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    The text prompt describing the video you want to generate

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

查询参数

  • 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

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    The text prompt describing the video you want to generate

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • 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.

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

路径参数

  • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

路径参数

  • 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.

响应体属性

  • imagesobject[]

    图片结果列表（图片类任务）。

    • urlstring, 必填

      图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • file_namestring
      可选。
    • file_sizeinteger<int64>
      可选。
    • widthinteger
      可选。
    • heightinteger
      可选。
  • videoobject
    • urlstring, 必填

      视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • durationnumber<double>

      视频时长（秒）。

    • file_namestring
      可选。
    • file_sizeinteger<int64>

      文件大小（字节）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    The text prompt describing the video you want to generate

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

查询参数

  • 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

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    The text prompt describing the video you want to generate

  • durationenum

    The duration of the generated video.

    default: 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

  • aspect_ratioenum

    The aspect ratio of the generated video. Only 16:9 and 9:16 are supported.

    default: auto

  • resolutionenum

    The resolution of the generated video.

    default: 720p

  • 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.

  • safety_toleranceenum

    The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

    default: 4

  • seedinteger | null

    The seed for the random number generator.

    • anyOf[0]integer
      可选。
    • anyOf[1]null
      可选。
  • negative_promptstring | null

    A negative prompt to guide the video generation.

    • 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.

响应体属性

  • statusenum, 必填

    任务状态。失败时也可能返回 COMPLETED，通过 detail 区分。

  • 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.

  • resultobject | null

    任务完成时的结果（COMPLETED 状态）；未完成时为 null。

    • oneOf[0]object

      任务结果。图片类任务返回 images，视频类任务返回 video。

    • oneOf[1]null
      可选。
  • detailobject | null

    任务失败或进行中时的详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。

响应

application/json
{
  "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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填，去除首尾空格后长度不超过 2500 字符。

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 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 & object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

基于首帧图片（及可选尾帧）与文本提示词生成视频。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

查询参数

  • 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。

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

基于多模态参考（图片、视频、音频）与提示词生成视频。至少需提供 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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填。

  • image_urlsstring[]

    参考图片 URL 列表，最多 9 张。

  • video_urlsstring[]

    参考视频 URL 列表，最多 3 段。

  • audio_urlsstring[]

    参考音频 URL 列表，最多 3 段；若仅传音频而不传图/视频则非法。

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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 在一起吃火锅，并且旁白音说火锅大家都爱吃。"

  • subjectsobject[], 必填

    图片主体信息支持1-7个主体，主体图片共1 ～ 7张

    • 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（暂未支持）

响应

application/json
{
  "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

路径参数

  • 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
响应.

响应体属性

  • statusenum, 必填

    任务状态。失败时也返回 COMPLETED，通过 detail 区分。

  • request_idstring, 必填
    必填。
  • response_urlstring, 必填
    必填。
  • status_urlstring, 必填
    必填。
  • cancel_urlstring, 必填
    必填。
  • metricsobject
    • inference_timeinteger, 必填
      必填。
  • resultobject
    • videoobject, 必填

响应

application/json
{
  "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

路径参数

  • 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
响应.

响应体属性

  • videoobject, 必填
    • urlstring, 必填
      必填。
    • content_typestring, 必填
      必填。

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • 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 在一起吃火锅，并且旁白音说火锅大家都爱吃。"

  • subjectsobject[], 必填

    图片主体信息支持1-7个主体，主体图片共1 ～ 7张

    • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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

  • resolutionenum

    输出分辨率，Vidu Q3 系列默认 720p。

    default: 720p

  • aspect_ratioenum

    视频宽高比；Vidu Q3 系列支持 16:9、9:16、1:1、4:3、3:4。

    default: 16:9

  • seedinteger

    随机种子；不传或传 0 时由系统自动生成。

  • movement_amplitudeenum

    运动幅度。

    default: auto

  • 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）。

  • logsobject[]

    日志条目（入队时为空/ null）。

    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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（暂未支持）

响应

application/json
{
  "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

查询参数

  • 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

  • resolutionenum

    输出分辨率，Vidu Q3 系列默认 720p。

    default: 720p

  • aspect_ratioenum

    视频宽高比；Vidu Q3 系列支持 16:9、9:16、1:1、4:3、3:4。

    default: 16:9

  • seedinteger

    随机种子；不传或传 0 时由系统自动生成。

  • movement_amplitudeenum

    运动幅度。

    default: auto

  • 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）。

  • logsobject[]

    日志条目（入队时为空/ null）。

    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

响应

application/json
{
  "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

路径参数

  • 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

  • durationenum

    生成视频的时长（秒）。默认 5。

    default: 5

  • aspect_ratioenum

    生成视频的画面宽高比。默认 16:9。

    default: 16:9

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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

  • durationenum

    生成视频的时长（秒）。默认 5。

    default: 5

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    仅支持 pro。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • allOf[0]object
    • promptstring, 必填

      视频内容提示词，必填，最长 2500 个字符。

    • negative_promptstring

      负向提示词，用于描述不希望出现的内容。默认 blur, distort, and low quality。

      default: blur, distort, and low quality

    • durationenum

      生成视频的时长（秒）。默认 5。

      default: 5

    • aspect_ratioenum

      生成视频的画面宽高比。默认 16:9。

      default: 16:9

    • cfg_scalenumber

      提示词遵循强度，数值越大越贴近提示词。默认 0.5。

      default: 0.5; minimum: 0; maximum: 1

  • allOf[1]object
    • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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

  • durationenum

    生成视频的时长（秒）。默认 5。

    default: 5

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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 秒。

  • character_orientationenum, 必填

    输出角色的朝向参考。image 表示匹配参考图朝向，适合运镜场景且视频最长 10 秒；video 表示匹配参考视频朝向，适合复杂动作且最长 30 秒。

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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

  • durationenum

    生成视频的时长（秒）。默认 5，支持 3～15 秒的整数。

    default: 5

  • multi_promptobject[]

    多镜头分镜列表。与 prompt 互斥；每个分镜分别指定提示词和时长。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • generate_audioboolean

    是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。

    default: true

  • shot_typeenum

    多镜头生成方式。使用 multi_prompt 时必填；customize 按分镜生成，intelligent 由模型规划镜头。默认 customize。

    default: customize

  • aspect_ratioenum

    生成视频的画面宽高比。默认 16:9。

    default: 16:9

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/pro/4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    视频内容提示词。与 multi_prompt 互斥，最长 2500 个字符。

  • multi_promptobject[]

    多镜头分镜列表。与 prompt 互斥；每个分镜分别指定提示词和时长。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • start_image_urlstring<uri>, 必填

    视频首帧参考图 URL，必填。

  • end_image_urlstring<uri>

    可选的视频尾帧参考图 URL。

  • durationenum

    生成视频的时长（秒）。默认 5，支持 3～15 秒的整数。

    default: 5

  • generate_audioboolean

    是否生成原生音频。默认 true；支持中英文语音，其他语言会自动翻译为英文。

    default: true

  • elementsobject | object[]

    主体参考列表，用于增强人物或物体的一致性。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • shot_typeenum

    多镜头生成方式。使用 multi_prompt 时必填；customize 按分镜生成，intelligent 由模型规划镜头。默认 customize。

    default: customize

  • 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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/pro/4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • allOf[0]object
    • promptstring

      可选的动作与画面补充提示词，最长 2500 个字符。

    • image_urlstring<uri>, 必填

      角色参考图 URL，必填。角色身体比例应清晰、无遮挡，且主体面积应大于画面的 5%。

    • video_urlstring<uri>, 必填

      动作参考视频 URL，必填。视频应包含无遮挡的真人全身或上半身（含头部）；character_orientation=image 时最长 10 秒，video 时最长 30 秒。

    • character_orientationenum, 必填

      输出角色的朝向参考。image 表示匹配参考图朝向，适合运镜场景且视频最长 10 秒；video 表示匹配参考视频朝向，适合复杂动作且最长 30 秒。

    • keep_original_soundboolean

      是否保留动作参考视频的原始声音。默认 true。

      default: true

  • allOf[1]object
    • elementsobject | object[]

      主体参考列表，仅 Kling v3 动作控制支持，可绑定人物面部以增强身份一致性。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

请求

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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    清晰度档位：pro=1080P，standard=720P。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    文本提示词。与 multi_prompt 互斥。建议不超过 2500 字符。

  • multi_promptobject[]

    多镜头分镜列表（1-6 个分镜）。与 prompt 互斥。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • aspect_ratioenum

    画面比例，默认 16:9。

  • durationenum

    视频时长（秒）。可选，默认 5；取值范围 3-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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    清晰度档位：pro=1080P，standard=720P。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    文本提示词。与 multi_prompt 互斥。建议不超过 2500 字符。

  • multi_promptobject[]

    多镜头分镜列表（1-6 个分镜）。与 prompt 互斥。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • image_urlstring, 必填

    首帧参考图 URL 或 base64。必填。格式 .jpg/.jpeg/.png，≤50MB，宽高 ≥300px，宽高比 1:2.5 ~ 2.5:1。

  • durationenum

    视频时长（秒）。可选，默认 5；取值范围 3-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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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。

  • durationenum

    生成视频的时长（秒）。默认 5，范围 3～10。

    default: 5

  • elementsobject | object[]

    主体（Element）参考列表。每项两种形态二选一：①通过 element_id 引用已有素材；②内联传入 frontal_image_url + reference_image_urls，由平台自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

请求

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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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 项。

  • elementsobject | object[]

    人物或物体主体参考列表，在提示词中按 @Element1、@Element2 顺序引用，与 image_urls 合计最多 7 项。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • durationenum

    生成视频的时长（秒）。默认 5，范围 3～10。

    default: 5

  • aspect_ratioenum

    生成视频的画面宽高比。默认 16:9。

    default: 16:9

请求

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

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/pro/4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    视频内容提示词。与 multi_prompt 互斥，最长 2500 个字符。

  • durationenum

    生成视频的时长（秒）。默认 5，支持 3～15 秒的整数。

    default: 5

  • aspect_ratioenum

    生成视频的画面宽高比。默认 16:9。

    default: 16:9

  • generate_audioboolean

    是否生成原生音频。默认 false。

    default: false

  • multi_promptobject[]

    多镜头分镜列表。与 prompt 互斥；每个分镜分别指定提示词和时长。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • shot_typeenum

    多镜头生成方式。使用 multi_prompt 时必填；customize 按分镜生成，intelligent 由模型规划镜头。默认 customize。

    default: customize

请求

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

响应

object & object

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/pro/4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    视频内容提示词。与 multi_prompt 互斥。

  • image_urlstring<uri>, 必填

    视频首帧图像 URL，必填。

  • end_image_urlstring<uri>

    可选的视频尾帧图像 URL。

  • durationenum

    生成视频的时长（秒）。默认 5，范围 3～15。

    default: 5

  • generate_audioboolean

    是否生成原生音频。默认 false。

    default: false

  • multi_promptobject[]

    多镜头分镜列表。与 prompt 互斥。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • shot_typeenum

    多镜头生成方式。customize 按分镜生成；intelligent 由模型自动规划镜头。默认 customize。

    default: customize

  • elementsobject | object[]

    主体（Element）参考列表。每项两种形态二选一：①通过 element_id 引用已有素材；②内联传入 frontal_image_url + reference_image_urls，由平台自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

请求

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

响应

object & object

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/pro/4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    视频内容提示词。与 multi_prompt 互斥；可使用 @Image1、@Element1 等引用输入素材。

  • multi_promptobject[]

    多镜头分镜列表。与 prompt 互斥。

    • indexinteger

      分镜序号，从 1 开始。

    • promptstring

      该分镜的内容提示词。

    • durationstring

      该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。

  • start_image_urlstring<uri>

    可选的视频首帧图像 URL。

  • end_image_urlstring<uri>

    可选的视频尾帧图像 URL。

  • image_urlsstring[]

    风格或外观参考图 URL 列表，在提示词中按 @Image1、@Image2 顺序引用。

  • elementsobject | object[]

    人物或物体主体参考列表，在提示词中按 @Element1、@Element2 顺序引用。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • generate_audioboolean

    是否生成原生音频。默认 false。

    default: false

  • durationenum

    生成视频的时长（秒）。默认 5，范围 3～15。

    default: 5

  • shot_typeenum

    多镜头生成方式。customize 按分镜生成；intelligent 由模型自动规划镜头。默认 customize。

    default: customize

  • aspect_ratioenum

    生成视频的画面宽高比。默认 16:9。

    default: 16:9

请求

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

响应

object & object

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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

任务已完成或失败

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    任务结果。图片类任务返回 images，视频类任务返回 video。

    • imagesobject[]

      图片结果列表（图片类任务）。

    • videoobject

响应

application/json
{
  "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

路径参数

  • 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

任务完成，返回视频结果

响应体属性

  • imagesobject[]

    图片结果列表（图片类任务）。

    • urlstring, 必填

      图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • file_namestring
      可选。
    • file_sizeinteger<int64>
      可选。
    • widthinteger
      可选。
    • heightinteger
      可选。
  • videoobject
    • urlstring, 必填

      视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • durationnumber<double>

      视频时长（秒）。

    • file_namestring
      可选。
    • file_sizeinteger<int64>

      文件大小（字节）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

    pattern: ^([4-9]|1[0-5])$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

    pattern: ^([4-9]|1[0-5])$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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_urls9
video_urls3
audio_urls3
总计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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • resolutionenum

    输出分辨率。Seedance 2.0 Fast 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

    pattern: ^([4-9]|1[0-5])$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    视频描述文本，最大 2500 字符。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

查询参数

  • 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。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

查询参数

  • 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 时，请求会被拒绝。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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 & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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

请求头

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

请求体

请求体属性

  • promptstring, 必填

    文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符

  • image_urlstring, 必填

    首帧图像

  • seedinteger

    随机种子，用于提高结果的可复现性；不填时随机生成。

  • movement_amplitudeenum

    画面中对象的运动幅度。默认 auto。

    default: auto

请求

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, 必填
    必填。

响应

application/json
{
  "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

请求头

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

请求体

请求体属性

  • promptstring, 必填

    视频内容提示词，必填，最长 1500 个字符。

  • start_image_urlstring<uri>, 必填

    视频首帧图像 URL，必填。

  • end_image_urlstring<uri>, 必填

    视频尾帧图像 URL，必填。

  • seedinteger

    随机种子，用于提高结果的可复现性；不填时随机生成。

  • movement_amplitudeenum

    画面中对象的运动幅度。默认 auto。

    default: auto

请求

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, 必填
    必填。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    分辨率档位（不支持 4k）：std/standard = 720P，pro = 1080P。

请求体

请求体属性

  • promptstring

    视频生成提示词，最多 2500 字符

  • image_urlsstring[]

    风格参考图片 URL 列表（可选，≤7 张，每张≤10MB）

  • elementsobject | object[]

    主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • durationenum

    视频时长（秒），支持 5 或 10

  • aspect_ratioenum

    视频画面比例

    default: 16:9

请求

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

任务提交成功

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    分辨率档位（不支持 4k）

请求体

请求体属性

  • promptstring, 必填

    编辑指令（必填），描述对视频的修改意图

  • video_urlstring, 必填

    待编辑的原始视频 URL（必填），MP4/MOV，3-10s

  • image_urlsstring[]

    风格参考图片 URL 列表（可选）

  • elementsobject | object[]

    主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • 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

任务提交成功

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    分辨率档位（不支持 4k）

请求体

请求体属性

  • promptstring, 必填

    视频生成提示词（必填）

  • video_urlstring, 必填

    动作/镜头参考视频 URL（必填），MP4/MOV，3-10s

  • image_urlsstring[]

    风格或主体参考图片 URL 列表（可选）

  • elementsobject | object[]

    主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • keep_audioboolean

    是否保留参考视频音频

  • aspect_ratioenum

    视频画面比例

    default: 16:9

  • durationenum

    视频时长（秒），支持 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

任务提交成功

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/std/pro，不支持 4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    视频生成文本描述。

  • video_urlstring, 必填

    输入参考视频的公网 URL。

  • image_urlsstring[]

    补充参考图片 URL 列表（可选）。

  • elementsobject | object[]

    主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • keep_audioboolean

    是否保留输入视频原声，默认 true。

  • shot_typeenum

    镜头类型（可选）。

  • aspect_ratioenum

    输出视频宽高比，不填时默认 auto（由 Kling 自行决定）。

  • durationstring

    输出视频时长（秒），有效范围 3~15。

请求

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

响应

object & object

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • Name
    mode
    Type
    enum, 必填
    Description

    支持 standard/std/pro，不支持 4k。

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    编辑指令，描述对视频的修改内容。

  • video_urlstring, 必填

    待编辑视频的公网 URL。

  • image_urlsstring[]

    补充参考图片 URL 列表（可选）。

  • elementsobject | object[]

    主体参考列表（可选）。内联传入主体源图时，平台会自动创建仅供本次视频任务使用的临时主体，并在任务结束后自动删除；也可通过 element_id 引用已有素材。详见 Kling 主体（Element）使用教程。

    • oneOf[0]object

      additionalProperties: false

    • oneOf[1]object

      additionalProperties: false

  • keep_audioboolean

    是否保留输入视频原声，默认 true。

  • shot_typeenum

    镜头类型（可选）。

请求

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

响应

object & object

任务已入队。

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • allOf[0]object
    • resolutionenum

      输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

      default: 720p

    • durationstring

      视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

      pattern: ^([4-9]|1[0-5])$

    • aspect_ratioenum

      画面比例。留空或传 auto 时由模型自动决定。

    • generate_audioboolean

      是否生成背景音频。

  • allOf[1]object
    • 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • allOf[0]object
    • resolutionenum

      输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

      default: 720p

    • durationstring

      视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

      pattern: ^([4-9]|1[0-5])$

    • aspect_ratioenum

      画面比例。留空或传 auto 时由模型自动决定。

    • generate_audioboolean

      是否生成背景音频。

  • allOf[1]object
    • 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • allOf[0]object
    • resolutionenum

      输出分辨率。Seedance 2.0 标准版支持 480p、720p、1080p、4k；默认为 720p。

      default: 720p

    • durationstring

      视频时长（秒），取值范围 4～15，传字符串格式。 留空时由模型自动决定。

      pattern: ^([4-9]|1[0-5])$

    • aspect_ratioenum

      画面比例。留空或传 auto 时由模型自动决定。

    • generate_audioboolean

      是否生成背景音频。

  • allOf[1]object
    • 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

路径参数

  • 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 & object

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

响应体属性

  • allOf[0]object & object

    状态查询响应。

    • allOf[0]object

      fal 标准 URL 集合，所有响应均内联此字段。

    • allOf[1]object
  • allOf[1]object
    • resultobject & object

      Dreamina Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens。

响应

application/json
{
  "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

路径参数

  • 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 & object

任务成功，返回视频结果

响应体属性

  • allOf[0]object

    任务成功时的结果响应体。

    • videoobject
  • allOf[1]object
    • usageobject

      Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。

响应

application/json
{
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  },
  "usage": {
    "completion_tokens": 42,
    "total_tokens": 42
  }
}

创建文生视频任务

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

使用 Dreamina Seedance 2.5 创建文生视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • aspect_ratioenum

    画面比例。留空或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。纯文生视频通常不会创建素材。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.5/text-to-video
curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.5/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 cinematic tracking shot through a neon-lit city street with synchronized ambient audio.",
  "resolution": "720p",
  "duration": "30",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "status": "IN_QUEUE",
  "request_id": "qvideo-example",
  "response_url": "https://api.modelink.ai/queue/byteplus/seedance-2.5/requests/qvideo-example",
  "status_url": "https://api.modelink.ai/queue/byteplus/seedance-2.5/requests/qvideo-example/status",
  "cancel_url": "",
  "queue_position": 0,
  "logs": []
}

创建图生视频任务

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

使用首帧图片及可选尾帧图片创建 Dreamina Seedance 2.5 视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • image_urlstring, 必填

    首帧图片。支持公网 HTTP(S) URL、data:image/... Base64 或 qasset:// 素材引用。

  • end_image_urlstring

    可选的尾帧图片，格式规则同 image_url。提供后按首尾帧模式生成。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.5/image-to-video
curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.5/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": "Slowly push the camera forward while keeping the subject sharp and adding natural ambient audio.",
  "image_url": "https://example.com/first-frame.jpg",
  "end_image_url": "https://example.com/last-frame.jpg",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "auto_create_assets": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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/byteplus/seedance-2.5/reference-to-video

使用多模态参考素材创建 Dreamina Seedance 2.5 视频任务。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 Fal 格式回调的 HTTPS 地址。详见 Fal 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。

  • image_urlsstring[]

    参考图片列表，与 video_urls 至少提供其一。支持公网 HTTP(S) URL、data:image/... Base64 或 qasset:// 素材引用。

  • video_urlsstring[]

    参考视频列表，与 image_urls 至少提供其一。支持公网 HTTP(S) URL 或 qasset:// 素材引用。

  • audio_urlsstring[]

    参考音频列表。支持公网 HTTP(S) URL 或 qasset:// 素材引用。

  • resolutionenum

    输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。

    default: 720p

  • durationstring

    视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。

  • aspect_ratioenum

    画面比例。留空或传 auto 时由模型自动决定。

  • generate_audioboolean

    是否生成与画面同步的音频。

  • auto_create_assetsboolean

    可选。为 true 时，平台自动为请求中的 HTTP(S) 媒体创建临时素材、完成审核与 URL 改写，并在任务终态后清理。详见 Seedance 虚拟人像生视频自动临时素材。

请求

POST/queue/byteplus/seedance-2.5/reference-to-video
curl 'https://api.qnaigc.com/queue/byteplus/seedance-2.5/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": "Keep the character and outfit from the image while following the reference video'\''s camera movement.",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/camera-motion.mp4"
  ],
  "audio_urls": [
    "https://example.com/background.mp3"
  ],
  "resolution": "720p",
  "duration": "12",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "auto_create_assets": true
}'

响应

object & object

任务已入队

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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/byteplus/seedance-2.5/requests/{request_id}/status

查询 Dreamina Seedance 2.5 任务状态。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    创建任务时返回的 request_id。

请求体

暂无请求体

请求

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

响应

object & object

任务已结束（成功或失败）

响应体属性

  • allOf[0]object
    • statusenum, 必填

      任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

    • request_idstring, 必填
      必填。
    • response_urlstring<uri>, 必填
      必填。
    • status_urlstring<uri>, 必填
      必填。
    • cancel_urlstring

      取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

    • queue_positioninteger
      可选。
    • logsobject[]
    • metricsobject
    • detailobject | null

      任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • resultobject

      任务结果。图片类任务返回 images，视频类任务返回 video。

  • allOf[1]object
    • resultobject & object

      Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。

响应

application/json
{
  "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/byteplus/seedance-2.5/requests/{request_id}

获取 Dreamina Seedance 2.5 任务的最终视频结果。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    创建任务时返回的 request_id。

请求体

暂无请求体

请求

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

响应

object & object

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

响应体属性

  • allOf[0]object

    任务结果。图片类任务返回 images，视频类任务返回 video。

    • imagesobject[]

      图片结果列表（图片类任务）。

    • videoobject
  • allOf[1]object
    • usageobject

      Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。

响应

application/json
{
  "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
  },
  "usage": {
    "completion_tokens": 42,
    "total_tokens": 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

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    视频描述文本，最大 2500 字符。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • 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。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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

查询参数

  • 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 时，请求会被拒绝。

  • resolutionenum

    输出分辨率。Seedance 2.0 Mini 仅支持 480p、720p；默认为 720p。

    default: 720p

  • durationstring

    视频时长（秒），取值范围 4～15，传字符串格式。留空或传 auto 时由模型自动决定。

    pattern: ^([4-9]|1[0-5]|auto)$

  • aspect_ratioenum

    画面比例。留空或传 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

任务已入队

响应体属性

  • allOf[0]object

    fal 标准 URL 集合，所有响应均内联此字段。

    • request_idstring, 必填

      任务唯一标识符。

    • response_urlstring, 必填

      获取结果的完整 URL。

    • status_urlstring, 必填

      查询状态的完整 URL。

    • cancel_urlstring

      取消任务的 URL（暂不支持）。

  • allOf[1]object
    • statusenum, 必填
    • queue_positioninteger

      队列位置（入队时为 0）。

    • logsobject[]

      日志条目（入队时为空数组）。

响应

application/json
{
  "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/minimax/h3/text-to-video

提交文本提示词生成 MiniMax H3 视频。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填，去除首尾空格后长度不超过 7000 字符。

  • durationinteger

    生成视频时长（秒）。取值范围 4–15；默认 5。

    default: 5; minimum: 4; maximum: 15

  • resolutionenum

    输出分辨率。支持 2K、768P；默认 2K。计费档位由请求分辨率决定。

    default: 2K

  • aspect_ratioenum

    画幅比例。文生视频支持 21:9、16:9、4:3、1:1、3:4、9:16；默认 16:9（不含 adaptive）。

    default: 16:9

  • callback_urlstring<uri>

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

请求

POST/queue/minimax/h3/text-to-video
curl 'https://api.qnaigc.com/queue/minimax/h3/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 white kitten chases a butterfly across a sunlit garden. Gentle camera tracking, natural movement, soft afternoon light filtering through the leaves.",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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/minimax/h3/image-to-video

基于首帧图片、尾帧图片或首尾帧图片与文本提示词生成 MiniMax H3 视频。image_url 与 end_image_url 至少提供一个；仅提供 end_image_url 时按尾帧模式生成，同时提供两者时按首尾帧模式生成。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填，去除首尾空格后长度不超过 7000 字符。

  • image_urlstring

    可选首帧图像公网 HTTP(S) URL。与 end_image_url 至少提供一个；同时提供两者时按首尾帧模式生成。

  • end_image_urlstring

    可选尾帧图像公网 HTTP(S) URL。仅提供该字段时按尾帧模式生成，同时提供 image_url 时用于首尾帧过渡生成。

  • durationinteger

    生成视频时长（秒）。取值范围 4–15；默认 5。

    default: 5; minimum: 4; maximum: 15

  • resolutionenum

    输出分辨率。支持 2K、768P；默认 2K。

    default: 2K

  • callback_urlstring<uri>

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

  • anyOf[0]

    提供 image_url 作为首帧图片；也可以同时提供 end_image_url 生成首尾帧视频。

  • anyOf[1]

    提供 end_image_url 作为尾帧图片；仅提供该字段时生成尾帧模式视频。

请求

POST/queue/minimax/h3/image-to-video
curl 'https://api.qnaigc.com/queue/minimax/h3/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 camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
  "duration": 5,
  "resolution": "2K"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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/minimax/h3/reference-to-video

基于多模态参考素材（图片 / 视频 / 音频）与文本提示词生成 MiniMax H3 视频。参考图片、视频、音频分别最多 9、3、3 个，不设合计数量上限；至少提供图片或视频，不能只提供音频。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，必填，去除首尾空格后长度不超过 7000 字符。按模态与列表顺序引用参考素材，例如 Image 1、Image 2、Video 1、Audio 1。

  • durationinteger

    生成视频时长（秒）。取值范围 4–15；默认 5。

    default: 5; minimum: 4; maximum: 15

  • resolutionenum

    输出分辨率。支持 2K、768P；默认 2K。

    default: 2K

  • aspect_ratioenum

    画幅比例。支持 adaptive、21:9、16:9、4:3、1:1、3:4、9:16；默认 adaptive。

    default: adaptive

  • reference_image_urlsstring[]

    主体/风格参考图 URL 列表，在 prompt 中按 Image 1、Image 2… 引用。最多 9 张。

  • reference_video_urlsstring[]

    动作/参考视频 URL 列表，在 prompt 中按 Video 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒。

  • reference_audio_urlsstring[]

    参考音频 URL 列表，在 prompt 中按 Audio 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒。不能只传音频，须同时提供至少一张参考图或一段参考视频。

  • callback_urlstring<uri>

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

请求

POST/queue/minimax/h3/reference-to-video
curl 'https://api.qnaigc.com/queue/minimax/h3/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 1 is the female protagonist. Image 2 is her small dog. Keep the woman and dog consistent with their respective reference images while they walk together through a sunlit garden.",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "reference_image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"
  ]
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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/minimax/h3/requests/{request_id}/status

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    任务 ID，与提交成功响应中的 request_id 一致。

请求体

暂无请求体

请求

GET/queue/minimax/h3/requests/{request_id}/status
curl https://api.qnaigc.com/queue/minimax/h3/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

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

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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/minimax/h3/requests/{request_id}

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    任务 ID。

请求体

暂无请求体

请求

GET/queue/minimax/h3/requests/{request_id}
curl https://api.qnaigc.com/queue/minimax/h3/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

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

响应体属性

  • videoobject
    • urlstring, 必填

      视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • durationnumber<double>

      视频时长（秒）。

    • file_namestring
      可选。
    • file_sizeinteger<int64>

      文件大小（字节）。

  • usageobject

    MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

    • total_secondsinteger

      总秒数（通常为输入秒与输出秒之和）。

    • input_secondsinteger

      参考视频输入时长（秒）；无参考视频时为 0 或省略。

    • output_secondsinteger

      生成视频输出时长（秒），为主要计费依据之一。

    • input_image_countinteger

      参考图片数量；用于超额参考图分项计费（通常前 5 张不额外计费）。

响应

application/json
{
  "video": {
    "url": "https://example.com/output.mp4",
    "content_type": "video/mp4",
    "file_name": "output.mp4",
    "duration": 5
  },
  "usage": {
    "total_seconds": 5,
    "input_seconds": 0,
    "output_seconds": 5,
    "input_image_count": 0
  }
}

创建 MiniMax H3 Max 文生视频任务

POST
/queue/minimax/h3-max/text-to-video

提交文本提示词生成 MiniMax H3 Max 视频。默认生成 5 秒、768P 视频；支持 5–15 秒和 480P/768P 两档分辨率。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空。

  • durationinteger

    生成视频时长（秒），支持 5–15 秒。

    default: 5; minimum: 5; maximum: 15

  • resolutionenum

    输出分辨率，支持 480P 和 768P。

    default: 768P

  • aspect_ratioenum

    文生视频画幅比例，默认 16:9。

    default: 16:9

  • callback_urlstring<uri>

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。

请求

POST/queue/minimax/h3-max/text-to-video
curl 'https://api.qnaigc.com/queue/minimax/h3-max/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 cinematic shot of waves breaking against a rocky coast at sunrise.",
  "duration": 5,
  "resolution": "768P",
  "aspect_ratio": "16:9"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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
  }
}

创建 MiniMax H3 Max 图生视频任务

POST
/queue/minimax/h3-max/image-to-video

基于首帧图片、尾帧图片或首尾帧图片生成 MiniMax H3 Max 视频。image_url 与 end_image_url 至少提供一个；同时提供两者时生成首尾帧视频。图片 URL 必须是可访问的 HTTP(S) 地址。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。

请求头

  • Name
    X-Qiniu-Video-API-Format
    Type
    enum
    Description

    可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

  • promptstring, 必填

    文本提示词，去除首尾空格后不能为空。

  • image_urlstring<uri>

    可选首帧图片公网 HTTP(S) URL。与 end_image_url 至少提供一个。

    pattern: ^https?://

  • end_image_urlstring<uri>

    可选尾帧图片公网 HTTP(S) URL。与 image_url 至少提供一个。

    pattern: ^https?://

  • durationinteger

    生成视频时长（秒），支持 5–15 秒。

    default: 5; minimum: 5; maximum: 15

  • resolutionenum

    输出分辨率，支持 480P 和 768P。

    default: 768P

  • callback_urlstring<uri>

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。

  • anyOf[0]
    可选。
  • anyOf[1]
    可选。

请求

POST/queue/minimax/h3-max/image-to-video
curl 'https://api.qnaigc.com/queue/minimax/h3-max/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 camera slowly moves forward through the scene.",
  "image_url": "https://example.com/first.jpg",
  "duration": 5,
  "resolution": "768P"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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
  }
}

查询 MiniMax H3 Max 任务状态

GET
/queue/minimax/h3-max/requests/{request_id}/status

根据创建任务返回的 request_id 查询 MiniMax H3 Max 任务状态。未完成时返回 HTTP 202；任务结束后返回 HTTP 200。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    任务 ID。

请求体

暂无请求体

请求

GET/queue/minimax/h3-max/requests/{request_id}/status
curl https://api.qnaigc.com/queue/minimax/h3-max/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

任务已结束（成功或失败）

响应体属性

  • statusenum, 必填

    任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。

  • request_idstring, 必填
    必填。
  • response_urlstring<uri>, 必填
    必填。
  • status_urlstring<uri>, 必填
    必填。
  • cancel_urlstring

    取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。

  • queue_positioninteger
    可选。
  • logsobject[]
    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

  • metricsobject
    • inference_timenumber<double>

      推理耗时（秒）。

  • detailobject | null

    任务失败或进行中时的错误/状态详情；成功或排队时为 null。

    • oneOf[0]object
    • oneOf[1]null
      可选。
  • resultobject

    MiniMax H3/H3 Max 任务结果，含生成视频与用量。

    • videoobject
    • usageobject

      MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

响应

application/json
{
  "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
  }
}

查询 MiniMax H3 Max 任务结果

GET
/queue/minimax/h3-max/requests/{request_id}

获取 MiniMax H3 Max 任务最终结果。任务成功时返回视频和 usage；usage.output_seconds 为输出视频秒数，也是 H3 Max 的计费依据。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

路径参数

  • Name
    request_id
    Type
    string, 必填
    Description

    任务 ID。

请求体

暂无请求体

请求

GET/queue/minimax/h3-max/requests/{request_id}
curl https://api.qnaigc.com/queue/minimax/h3-max/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

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

响应体属性

  • videoobject
    • urlstring, 必填

      视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。

    • content_typestring, 必填
      必填。
    • durationnumber<double>

      视频时长（秒）。

    • file_namestring
      可选。
    • file_sizeinteger<int64>

      文件大小（字节）。

  • usageobject

    MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。

    • total_secondsinteger

      总秒数（通常为输入秒与输出秒之和）。

    • input_secondsinteger

      参考视频输入时长（秒）；无参考视频时为 0 或省略。

    • output_secondsinteger

      生成视频输出时长（秒），为主要计费依据之一。

    • input_image_countinteger

      参考图片数量；用于超额参考图分项计费（通常前 5 张不额外计费）。

响应

application/json
{
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  },
  "usage": {
    "total_seconds": 42,
    "input_seconds": 42,
    "output_seconds": 42,
    "input_image_count": 42
  }
}

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify