Bytedance · 工具

Hermes Agent x OmniHuman

OmniHuman 属于 RunAPI 的 Bytedance catalog,提供 audio-to-video 生成,以及 human-identification 和 subject-detection 辅助接口;API、SDK、CLI、Bruno 和文档中保持统一调用方式。

3 variants 起价 $0.32 / 秒 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任务匹配时使用 omnihuman-1.5:基于肖像和驱动音频生成数字人视频。

You have access to RunAPI task tools for OmniHuman.

Available OmniHuman models:
- omnihuman-1.5: 基于肖像和驱动音频生成数字人视频
  endpoints: /api/v1/omnihuman/audio_to_video
  request fields: model, source_image_url, source_audio_url, prompt
- omnihuman-1.5-human-identification: 识别源图片中的人体区域的辅助任务
  endpoints: /api/v1/omnihuman/human_identification
  request fields: model, source_image_url
- omnihuman-1.5-subject-detection: 返回可用于 OmniHuman 生成的主体 mask
  endpoints: /api/v1/omnihuman/subject_detection
  request fields: model, source_image_url

Use the model ID and endpoint that match the user's request.
Example prompt: 基于这张肖像和旁白音频生成一段 720p 数字人视频,并使用主体 mask 保持人物边界稳定。
/api/v1/omnihuman/audio_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/audio_to_video,并保存返回的 Task ID。
GET /api/v1/omnihuman/audio_to_video/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/omnihuman/human_identification: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/human_identification,并保存返回的 Task ID。
GET /api/v1/omnihuman/human_identification/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/omnihuman/subject_detection: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/subject_detection,并保存返回的 Task ID。
GET /api/v1/omnihuman/subject_detection/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。

公开版本与端点

模型 ID 端点 起步价格 模型目录
omnihuman-1.5
/api/v1/omnihuman/audio_to_video
$0.32 / 秒 模型详情
omnihuman-1.5-human-identification
/api/v1/omnihuman/human_identification
免费 模型详情
omnihuman-1.5-subject-detection
/api/v1/omnihuman/subject_detection
免费 模型详情

验证

轮询,直到 Task 进入终态

选择 <model-id> 后生成验证命令。

配置

指南端点: <endpoint>

选择 <model-id> 后,按端点的公开输入契约生成请求。
使用流程

三步开始使用

  1. 选择模型 ID

    选择公开模型 ID,并查看其端点与当前起步价格。

  2. 配置 RunAPI

    调用端点前设置 RUNAPI_API_KEY。

  3. 验证结果

    对于异步端点,轮询同一端点,直到 Task 进入终态。

使用 Hermes Agent + OmniHuman 可以构建什么

  • 产品与营销短片

    根据文字需求为商品页、广告和落地页制作简短的宣传短片。

  • 社交媒体短视频

    为社交平台制作短视频,并对同一创意生成多个版本后再挑选。

  • 图片动画与视频编辑

    在模型提供图生视频或视频编辑端点时,让静态图片动起来或修改现有视频。

为什么通过 RunAPI + Hermes Agent 使用 OmniHuman

  • 3 个变体,一个 API 密钥

    通过一个 RunAPI 连接选择可用的模型变体,无需更改现有集成。

  • 清晰的用量价格

    发送请求前查看目录中的当前价格,无需订阅或最低消费。

  • 自动化任务流程

    通过一致的任务流程提交任务、查询状态并收集异步结果,无需编写手动轮询代码。

Hermes Agent + OmniHuman 常见问题

OmniHuman audio-to-video 需要哪些输入?

需要源图片 URL 和源音频 URL。也可以传入 mask URL、提示词、分辨率、快速模式、seed 和回调地址来细化请求。

Human Identification 会返回什么?

Human Identification 会分析一张源图片,并返回用于标识人体区域的图像结果,适合检查或预处理。

Subject Detection 会返回什么?

Subject Detection 会分析一张源图片,并返回主体 mask;这些 mask 可以作为 `mask_urls` 传入 OmniHuman audio-to-video 请求。

什么时候应该传入 `mask_urls`?

当你希望加强主体隔离,或已经为同一源图片运行过 Subject Detection 并拿到 mask 时,可以传入 `mask_urls`。

支持哪些输出分辨率?

OmniHuman audio-to-video 支持 720p 和 1080p 输出;请求未指定时默认使用 1080p。

应该使用哪个模型 ID?

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

本指南会配置聊天模型吗?

不会。该 Model Line 使用页面所示的端点流程,不会被描述为 Agent 聊天模型。

开始在 Hermes Agent 中使用 OmniHuman

需要团队接入支持?

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们