OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建视频生成任务

POST

/v3/contents/generations/tasks

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

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

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

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

请求头

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

请求体

请求体属性

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

请求

POST/v3/contents/generations/tasks

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

响应

object

创建成功，返回任务 ID。

响应体属性

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

响应

{
  "id": "qvideo-xxxxxxxxxxxxxxxx"
}

查询视频生成任务

GET

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

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

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

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

请求头

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

请求体

暂无请求体

请求

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

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

响应

object

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

响应体属性

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

响应

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