动作迁移 · 提交任务

提交动作迁移异步任务。接口接收一张或多张参考人物图片、一个输入视频、可选提示词、生成模式和处理人数,返回平台任务 ID。任务完成后使用“动作迁移 · 查询任务”接口获取结果。

接口地址

POST /api/v1/apps/action_transfer/submit

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

计费说明

本接口按输入视频时长计费,先冻结、按成片时长结算,多退少补。

mode售价(点/秒)折合说明
fast2¥0.02/秒最快、最省
standard4¥0.04/秒默认,性价比最高
max6¥0.06/秒细节最好

实测:8 秒视频、standard 档,提交时冻结 32 点,完成后按成片时长结算。

注意:本接口走云端算力,不占用你账号下的 GPU 实例。即使有实例正在运行,也可以直接调用,无需关机。

请求参数

参数类型必填默认值说明
typestring否action_transfer固定值;不传时平台会按当前应用补齐。
file_urlstring / array是-参考人物图片 URL。单图传字符串,多图参考传 URL 数组。
video_urlstring是-输入视频 URL,也是本接口计费时长来源。
promptstring否-提示词,例如动作、人物、场景补充描述。
modestring否standard生成模式:fast、standard、max。
face_countinteger否1处理人数,取值范围 1 到 7。
durationnumber否-输入视频时长,单位秒;通常可不传,由平台自动探测。

请求示例

单图参考:

{
  "type": "action_transfer",
  "file_url": "https://example.com/person.png",
  "video_url": "https://example.com/input.mp4",
  "prompt": "一个女生在跳舞",
  "mode": "standard",
  "face_count": 1
}

多图参考:

{
  "type": "action_transfer",
  "file_url": [
    "https://example.com/person-1.png",
    "https://example.com/person-2.png"
  ],
  "video_url": "https://example.com/input.mp4",
  "prompt": "一个女生在跳舞",
  "mode": "max",
  "face_count": 2
}

cURL 示例

curl -X POST "https://你的域名/api/v1/apps/action_transfer/submit" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "action_transfer",
    "file_url": "https://example.com/person.png",
    "video_url": "https://example.com/input.mp4",
    "prompt": "一个女生在跳舞",
    "mode": "standard",
    "face_count": 1
  }'

成功响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "processing",
    "app": "action_transfer",
    "api": "submit",
    "frozen_points": 31.39,
    "actual_points": 0,
    "created_at": "2026-06-25T00:00:00Z"
  }
}
字段说明
data.task_id平台任务 ID,查询任务时传入。
data.status平台任务状态,提交成功通常为 processing。
data.frozen_points本次任务预冻结点数。
data.actual_points已实际结算点数;任务完成前通常为 0。

失败响应

{
  "code": 0,
  "msg": "face_count 必须为 1 到 7 的整数",
  "data": []
}

常见错误:

HTTPcode说明
400invalid_request参数缺失或格式错误。
400billing_duration_unresolved无法解析输入视频时长,可显式传入 duration 后重试。
400billing_sku_unmatchedmode 未命中可用 SKU。
401auth_failedAPI Key 缺失或无效。
402insufficient_points用户或租户点数不足。
402key_quota_exceeded当前 API Key 点数额度不足。
403permission_denied当前 API Key 无权调用应用 API。
404not_found应用、API 或任务不存在。
429queue_limit_exceeded应用排队任务已达上限。

同类文章