跳至正文
EN
获取 API Key
☰

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 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。