ByteDance · 模型接口

OmniHuman 1.5 API

OmniHuman 1.5 API 的模型能力、计价规格、请求参数和接入示例。使用 VezAPI 账号密钥统一接入。

口型同步

OmniHuman 1.5 API 接入文档

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

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

OmniHuman 1.5

POST/api/v1/jobs/createTask

模型标识： omnihuman-1-5

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。必填字段。 - 该端点必须使用 `omnihuman-1-5` 模型可选值：`"omnihuman-1-5"` 默认：`"omnihuman-1-5"`
`input` 必填	`object`	音频驱动肖像动画任务的输入参数。
`input.image_url` 必填	`string`	肖像图片 URL。支持任意宽高比，主体可以是人物、宠物、动漫角色等。支持的文件类型：image/jpeg、image/png、image/webp。最大文件大小：10MB。
`input.mask_url` 可选	`array`	可选的蒙版图片 URL。如需让图片中的特定主体说话，请使用「主体检测」功能获取对应的蒙版图片并作为输入传入。支持的文件类型：image/jpeg、image/png、image/webp。最大文件大小：10MB。支持多文件上传，最多 5 个文件。 `maxItems: 5`
`input.audio_url` 必填	`string`	音频 URL。时长必须小于 60 秒（建议 15 秒以内；超过此时长会导致质量下降）。支持的文件类型：audio/mpeg、audio/wav、audio/x-wav、audio/aac、audio/ogg、audio/mp4。最大文件大小：10MB。
`input.prompt` 可选	`string`	可选。支持中文、英文、日文、韩文、西班牙文、印尼文。最多 300 字符。 `maxLength: 300`
`input.output_resolution` 可选	`string`	输出视频分辨率。 - `720`：720P - `1080`：1080P（默认）输出保持输入图片的比例；720、1080 是清晰度档位，不是确切高度。输出为 MP4，时长与音频一致。可选值：`"720", "1080"` 默认：`"1080"`
`input.pe_fast_mode` 可选	`boolean`	快速模式。牺牲部分质量以加快生成速度。默认值：`false`。默认：`false`
`input.seed` 可选	`integer`	随机种子。默认为 `-1`（随机）。使用相同的正整数且其他参数完全一致时，生成结果将高度一致。默认：`-1`
`callBackUrl` 可选	`string`	回调 URL。任务完成后，VezAPI 会将结果发送到该业务回调地址。回调签名校验见 [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-1-5",
  "input": {
    "image_url": "https://example.com/input.png",
    "audio_url": "https://example.com/input.png",
    "prompt": "Your prompt"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

Omnihuman 1.5 主体识别

POST/api/v1/jobs/createTask

模型标识： omnihuman-1-5/human-identification

参数	类型	说明与限制
`model` 必填	`string`	用于人像识别的模型名称。必填字段。 - 该端点必须使用 `omnihuman-1-5/human-identification` 模型可选值：`"omnihuman-1-5/human-identification"` 默认：`"omnihuman-1-5/human-identification"`
`input` 必填	`object`	人像识别任务的输入参数。
`input.image_url` 必填	`string`	肖像图片 URL。要求：JPG/PNG/JPEG 格式，小于 5MB，分辨率低于 4096x4096。建议：单人正面照，面部占比较大。支持的文件类型：image/jpeg、image/png、image/jpg。最大文件大小：5MB。
`callBackUrl` 可选	`string`	回调 URL。任务完成后，VezAPI 会将结果发送到该业务回调地址。回调签名校验见 [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-1-5/human-identification",
  "input": {
    "image_url": "https://example.com/input.png"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

Omnihuman 1.5 主体检测

POST/api/v1/jobs/createTask

模型标识： omnihuman-1-5/subject-detection

参数	类型	说明与限制
`model` 必填	`string`	用于主体检测的模型名称。必填字段。 - 该端点必须使用 `omnihuman-1-5/subject-detection` 模型可选值：`"omnihuman-1-5/subject-detection"` 默认：`"omnihuman-1-5/subject-detection"`
`input` 必填	`object`	主体检测任务的输入参数。
`input.image_url` 必填	`string`	肖像图片 URL。支持检测图片中最多 5 个主体。支持的文件类型：image/jpeg、image/png、image/jpg。最大文件大小：5MB。
`callBackUrl` 可选	`string`	回调 URL。任务完成后，VezAPI 会将结果发送到该业务回调地址。回调签名校验见 [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-1-5/subject-detection",
  "input": {
    "image_url": "https://example.com/input.png"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

任务状态与回调

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

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

文件、日志与计费

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

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

打开完整文档 →

使用你的 VezAPI 密钥发送请求。成功生成将消耗账号积分。

VezAPI API Key

POST/api/v1/jobs/createTask

请求内容

{
  "model": "omnihuman-1-5",
  "input": {
    "image_url": "https://example.com/input.png",
    "audio_url": "https://example.com/input.png",
    "prompt": "Your prompt"
  }
}

返回结果

返回结果将在这里显示。

OmniHuman 1.5 API 价格

下方费率为参考估算，最终按实际优惠扣分 1:1 结算。按标准充值包换算，1,000 积分约为 10 美元，大额充值包可降低每积分实际单价。

规格	积分	计价单位	美元参考
omnihuman-1-5, lip sync	27	每秒	$0.27
OmniHuman 1.5, Human Identification	0	每次请求	$0
OmniHuman 1.5, Subject Detection	0	每次请求	$0