OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建文生视频任务

POST

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
文本提示词，去除首尾空格后不能为空且不超过 2500 个字符。
resolutionenum
输出分辨率。Seedance 2.5 支持 480p、720p、1080p，不支持 4k；默认为 720p。
default: 720p
- 480p
- 720p
- 1080p
durationstring
视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。
aspect_ratioenum
画面比例。留空或传 auto 时由模型自动决定。
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- 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 字段区分成功/失败。
  - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
  - FAILED
- request_idstring, 必填
  必填。
- response_urlstring<uri>, 必填
  必填。
- status_urlstring<uri>, 必填
  必填。
- cancel_urlstring
  取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
- queue_positioninteger
  可选。
- logsobject[]
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- metricsobject
  - inference_timenumber<double>
    推理耗时（秒）。
- detailobject | null
  任务失败或进行中时的错误/状态详情；成功或排队时为 null。
  - oneOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - oneOf[1]null
    可选。
- resultobject
  任务结果。图片类任务返回 images，视频类任务返回 video。
  - 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>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。
  - allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    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>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

响应

{
  "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

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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
- 480p
- 720p
- 1080p
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 字段区分成功/失败。
  - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
  - FAILED
- request_idstring, 必填
  必填。
- response_urlstring<uri>, 必填
  必填。
- status_urlstring<uri>, 必填
  必填。
- cancel_urlstring
  取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
- queue_positioninteger
  可选。
- logsobject[]
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- metricsobject
  - inference_timenumber<double>
    推理耗时（秒）。
- detailobject | null
  任务失败或进行中时的错误/状态详情；成功或排队时为 null。
  - oneOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - oneOf[1]null
    可选。
- resultobject
  任务结果。图片类任务返回 images，视频类任务返回 video。
  - 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>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。
  - allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    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>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

响应

{
  "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

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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
- 480p
- 720p
- 1080p
durationstring
视频时长，传字符串形式的整数秒 4–30；省略或传 auto 时由模型自动决定。
aspect_ratioenum
画面比例。留空或传 auto 时由模型自动决定。
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- 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 字段区分成功/失败。
  - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
  - FAILED
- request_idstring, 必填
  必填。
- response_urlstring<uri>, 必填
  必填。
- status_urlstring<uri>, 必填
  必填。
- cancel_urlstring
  取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
- queue_positioninteger
  可选。
- logsobject[]
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- metricsobject
  - inference_timenumber<double>
    推理耗时（秒）。
- detailobject | null
  任务失败或进行中时的错误/状态详情；成功或排队时为 null。
  - oneOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - oneOf[1]null
    可选。
- resultobject
  任务结果。图片类任务返回 images，视频类任务返回 video。
  - 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>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens；进行中、全零或历史缺失用量时省略该字段。
  - allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    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>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

响应

{
  "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
  }
}