OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

文生视频

POST

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/text-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "星空下的城市夜景延时摄影",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'

响应

object

任务已入队

响应体属性

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

响应

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

图生视频

POST

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

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/image-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "镜头缓慢推进，阳光透过树叶洒落",
  "image_url": "https://example.com/frame.jpg",
  "resolution": "720p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "auto_create_assets": true
}'

响应

object

任务已入队

响应体属性

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

响应

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

多模态参考生视频

POST

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

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/mini/reference-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "参考图片风格，生成一段动态场景",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "resolution": "720p",
  "duration": "5",
  "auto_create_assets": true
}'

响应

object

任务已入队

响应体属性

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

响应

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