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
/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
}

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify