OmniHuman 2.0 API 接入文档

使用 VezAPI 密钥接入 OmniHuman 2.0。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

OmniHuman 2.0

POST/api/v1/jobs/createTask

模型标识： omnihuman-2-0

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。必填字段。 - 该端点必须使用 `omnihuman-2-0` 模型可选值：`"omnihuman-2-0"` 默认：`"omnihuman-2-0"`
`input` 必填	`object`	OmniHuman 2.0 视频生成任务的输入参数。
`input.image_urls` 必填	`array`	作为画面来源的图片 URL。仅支持 1 张图片，以只含一个元素的数组传入。 - 格式：jpeg、png、webp、bmp、tiff、gif、heic、heif（`image/jpeg`、`image/png`、`image/webp`、`image/bmp`、`image/tiff`、`image/gif`、`image/heic`、`image/heif`） - 大小：小于 30 MB - 宽高比（宽/高）：`[0.4, 2.5]` - 尺寸：`[300, 6000]` px
`input.audio_url` 必填	`string`	驱动动作与口型的音频 URL。 - 时长：`[4, 300]` 秒 - 格式：wav、mp3（`audio/wav`、`audio/x-wav`、`audio/mpeg`） - 大小：小于 15 MB
`input.prompt` 可选	`string`	可选文本提示词，用于精确控制场景、人物动作和运镜。支持中文、英文、日文、韩文、墨西哥西班牙语、印尼文。最多 300 字符。 `maxLength: 300`
`input.enable_watermark` 可选	`boolean`	是否在输出视频上添加水印。默认值：`true`（开启）。默认：`true`
`callBackUrl` 可选	`string`	用于接收生成任务完成通知的 URL。选填，生产环境建议使用。 - 生成完成（成功或失败）后，系统会向该地址 POST 任务状态和结果 - 成功时，`data.resultJson` 中的 `resultUrls` 为生成的 MP4 视频地址 - `data.param` 会回显已提交的 OmniHuman 2.0 入参（`image_urls`、`audio_url`、`prompt`、`enable_watermark`） - 你的接口需要接受 JSON 格式的 POST 请求 - 也可以通过「查询任务详情」接口轮询任务状态 - 回调签名校验见 [Webhook 签名校验指南](/cn/common-api/webhook-verification)

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "omnihuman-2-0",
  "input": {
    "image_urls": [
      "https://example.com/input.png"
    ],
    "audio_url": "https://example.com/input.png",
    "prompt": "Your prompt"
  }
}'

返回值与错误

HTTP 200

请求成功

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。