星海智算开发文档
模型 API视频生成

Wan 角色动画与角色替换

使用人物图和动作视频,并区分清晰度、处理速度与计费。

Wan2.2-Animate-14B 通过 POST /media/generations 接入。它不是普通提示词驱动文生视频:两种模式都使用角色图和源视频。

选择 characterMode

模式值用途
动作迁移motion_transfer把视频动作迁移到人物图
角色替换character_replace按服务能力替换视频角色

先分别通过 image 和 video 字段上传,保存两个素材 ID。

{
  "model":"<MODEL_ALIAS>",
  "characterMode":"motion_transfer",
  "input_image_asset_id":"<IMAGE_ASSET_ID>",
  "input_video_asset_id":"<VIDEO_ASSET_ID>",
  "resolutionTier":"720p",
  "speedMultiplier":1.5
}

角色替换使用以下独立请求,其余输入准备相同:

{"model":"<MODEL_ALIAS>","characterMode":"character_replace","input_image_asset_id":"<IMAGE_ASSET_ID>","input_video_asset_id":"<VIDEO_ASSET_ID>","resolutionTier":"720p","speedMultiplier":1}

该模型不传提示词、任意秒数、画幅、FPS 或普通视频服务的 enableRife。按 快速开始 配置环境,将所选完整 JSON 保存为 request.json:

curl --fail-with-body --max-time 60 "$JUSP_BASE_URL/media/generations" \
  -H "Authorization: Bearer $JUSP_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: character-shot-001' \
  --data-binary @request.json --output create.json

处理速度与价格

当前开放 480p / 720p;720p 可选 1x 或 1.5x。1.5x 的基础报价按对应速度系数调整,不是免费加速。服务是否接受该组合、输入时长和输出帧上限均以当前合同为准。

清晰度处理速度当前有效帧上限分段上限
480p1x3054
720p1x3054
720p1.5x6098

每段按 77 帧的合同处理;30 FPS 下上表约对应 10.2 秒和 20.3 秒,但不得用这个近似值替代服务对有效帧的校验。480p 不支持 1.5x。两种角色模式均需满足当前服务输入限制。

上传与解码、排队等耗时不与速度倍数简单成反比;不承诺整条请求必然快 1.5 倍。最终按实际请求规格和生效价格规则计费。

完成链路

使用服务要求的幂等键创建后,按照 异步任务 查询和下载;不要复用 H3 的全能参考数组作为本服务输入。

本页目录