Bytedance · 工具

Hermes Agent x OmniHuman

OmniHuman 屬於 RunAPI 的 Bytedance 目錄,提供 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 生成所需主體遮罩的輔助任務
  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 說話頭像影片,並使用主體遮罩讓說話者保持穩定分離。
/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。也可以傳入遮罩 URL、提示詞、解析度、快速模式、seed 和回呼網址來細化請求。

Human Identification 會回傳什麼?

Human Identification 會分析一張來源圖片,並回傳用於標示人體區域的圖片結果,適合檢查或前處理。

Subject Detection 會回傳什麼?

Subject Detection 會分析一張來源圖片,並回傳主體遮罩;這些遮罩可以作為 `mask_urls` 傳入 OmniHuman audio-to-video 請求。

什麼時候應該傳入 `mask_urls`?

當你希望加強主體分離,或已經為同一來源圖片執行過 Subject Detection 並取得遮罩時,可以傳入 `mask_urls`。

支援哪些輸出解析度?

OmniHuman audio-to-video 支援 720p 和 1080p 輸出;請求未指定時預設使用 1080p。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

開始在 Hermes Agent 中使用 OmniHuman

正在與團隊一起打造?

我們可以協助企業接入、整合與技術問題。

聯絡我們