Modelink

Seedance 虚拟人像生视频自动临时素材

本能力面向虚拟人像单次生视频：当请求里的 HTTP(S) 图片/视频/音频含人像时，供应商通常要求先创建素材并审核通过。手动路径需要调用方自行编排：建组 → 创建素材 → 轮询审核 → 引用 qasset:// / asset:// → 用完后删除。

若业务只需单次生成且属于虚拟人像场景，可不走常驻素材库，改在以下入口开启可选开关 auto_create_assets：平台在单个视频任务内部完成临时素材的创建、审核、URL 改写与终态清理。

协议入口
火山格式视频 / 火山格式 · Seedance 2.0
Fal 队列Doubao Seedance 2.0、Dreamina Seedance

工作流程

flowchart LR
    A["提交请求<br/>auto_create_assets: true"] --> B{"存在需要审核的<br/>HTTP(S) 素材？"}
    B -- 否 --> E["提交视频生成任务"]
    B -- 是 --> C["创建临时素材并等待审核"]
    C -- 审核失败 --> X["任务失败并清理临时素材"]
    C -- 审核通过 --> D["将媒体 URL 改写为<br/>qasset:// 或 asset://"]
    D --> E
    E --> F["等待视频任务终态并清理临时素材"]
    F --> G["返回生成结果或触发回调"]

需要长期复用同一虚拟形象时，仍应使用虚拟人像素材管理，通过 qasset:// 引用已审核素材。同时，auto_create_assets 只能用于虚拟人像临时素材路径，不能用于需要刷脸活体认证的真人人像（如需核验本人授权的公众人物形象），真人人像请使用真人人像素材管理。

适用场景

场景推荐做法
单次图生视频 / 多模态参考，输入含人像的 HTTP(S) 图片、视频或音频"auto_create_assets": true
形象需跨多次任务反复复用素材 API + qasset://
已持有火山的公开素材 asset:// 或已审核 qasset://直接引用；可与开关并存
请求中无 HTTP(S) 图片 / 视频 / 音频可不传该字段；传 true 也不会额外创建素材

未传或显式 "auto_create_assets": false 时，行为与历史一致：含人像的 HTTP 素材可能被供应商拒绝（例如提示 input image may contain real person）。

字段语义

取值行为
未传等价于关闭，保持当前流程
false显式关闭，效果与未传相同
true对请求中符合条件的 HTTP(S) 图片、视频与音频自动创建临时素材并审核

媒体字段因协议而异，开关语义相同：

协议会被自动建临时素材的字段
火山格式content[] 中的 image_url / video_url / audio_url（HTTP(S)）
Fal 图生视频image_url、end_image_url
Fal 参考生视频image_urls、video_urls、audio_urls

任务查询、计费与回调协议不变，也不对外新增状态值。其他视频协议（可灵、Vidu、Veo 等）不提供该字段。

请求示例

火山格式：开启自动临时素材

export MODELINK_API_KEY="替换为你的 Modelink API Key"
export MODELINK_BASE_URL="https://api.qnaigc.com"
# 海外：export MODELINK_BASE_URL="https://api.modelink.ai"

curl "$MODELINK_BASE_URL/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $MODELINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "图中人物自然转身并对镜头微笑"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/person.jpg"
        },
        "role": "reference_image"
      }
    ],
    "auto_create_assets": true,
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 5,
    "generate_audio": true
  }'

成功受理后仍只返回任务 id，随后按现有方式轮询查询视频生成任务或等待回调。

Fal 队列：图生视频

curl "$MODELINK_BASE_URL/queue/bytedance/seedance-2.0/image-to-video" \
  -H "Authorization: Bearer $MODELINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "图中人物自然转身并对镜头微笑",
    "image_url": "https://example.com/person.jpg",
    "auto_create_assets": true,
    "resolution": "720p",
    "duration": "5",
    "generate_audio": true
  }'

成功入队后按 Fal 协议轮询 status_url / response_url 或等待回调。

Fal 队列：参考生视频（图 + 视频 + 音频）

{
  "prompt": "参考图片中的人物与服装，融合视频转场节奏与音频氛围",
  "image_urls": ["https://example.com/person.jpg"],
  "video_urls": ["https://example.com/transition.mp4"],
  "audio_urls": ["https://example.com/bgm.wav"],
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true
}

火山格式：首尾帧

{
  "model": "bytedance/doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "从首帧自然过渡到尾帧，人物面对镜头"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first_frame.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last_frame.jpg"
      },
      "role": "last_frame"
    }
  ],
  "auto_create_assets": true,
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5
}

混用已有素材

HTTP 人像与已有 asset:// / qasset:// 可以同时出现：平台只为需要审核的 HTTP(S) 媒体创建临时素材，已有引用不重复创建。

{
  "model": "bytedance/doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "图片1中的人物穿上图片2的服装，自然走动"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/person.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://asset-xxxxxxxxxxxxxxxx"
      },
      "role": "reference_image"
    }
  ],
  "auto_create_assets": true,
  "resolution": "720p",
  "duration": 5
}

完整参数见火山格式 API与 Fal · Doubao Seedance。更多产品层说明见 Seedance 2.0 产品 FAQ。

耗时情况

开启 auto_create_assets 后，完整的生视频任务通常会多耗时数秒到一分钟不等，具体受参考素材数量与上游素材审核耗时影响。测试方法与明细见 Seedance 自动临时素材任务耗时测试。

常见问题

auto_create_assets: true 创建的临时分组和临时素材会计入账号素材配额吗？

不会。无论视频任务处于素材审核阶段还是视频生成阶段，平台自动创建的临时分组和临时素材均不计入账号素材配额。

多个视频任务并发创建临时素材时，是否存在账号级临时素材数量上限？

不存在账号级临时素材数量上限。临时素材仅服务于单个视频生成任务，生命周期较短，并会在任务进入终态后自动清理。

同一模型同时运行 5 个任务，每个任务使用 9 张 HTTP 图片，共创建 45 个临时素材，会触发素材配额限制吗？

不会。这 45 个素材均属于视频任务内部使用的临时素材，不计入账号素材配额，因此不会触发素材配额限制。

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify