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/text-to-video

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/text-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

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

响应

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

创建图生视频任务

POST

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

curl 'https://api.qnaigc.com/queue/bytedance/seedance-2.0/image-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
  "image_url": "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
}'

响应

object

任务已入队

响应体属性

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

响应

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

创建参考生视频任务

POST

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

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

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

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

请求

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

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

响应

object

任务已入队

响应体属性

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

响应

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