--- title: Hermes Agent x HeyGen Video 使用指南 | RunAPI description: 透過 RunAPI 在 Hermes Agent 中使用 HeyGen Video。比較目前的模型 ID、端點與價格，再依對應流程完成設定。 url: https://runapi.ai/zh-TW/hermes-heygen-video.md canonical: https://runapi.ai/zh-TW/hermes-heygen-video locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/hermes-heygen-video zh-CN: https://runapi.ai/zh-CN/hermes-heygen-video es: https://runapi.ai/es/hermes-heygen-video ja: https://runapi.ai/ja/hermes-heygen-video de: https://runapi.ai/de/hermes-heygen-video fr: https://runapi.ai/fr/hermes-heygen-video pt-BR: https://runapi.ai/pt-BR/hermes-heygen-video ko: https://runapi.ai/ko/hermes-heygen-video it: https://runapi.ai/it/hermes-heygen-video nl: https://runapi.ai/nl/hermes-heygen-video pl: https://runapi.ai/pl/hermes-heygen-video tr: https://runapi.ai/tr/hermes-heygen-video zh-TW: https://runapi.ai/zh-TW/hermes-heygen-video zh-HK: https://runapi.ai/zh-HK/hermes-heygen-video ar: https://runapi.ai/ar/hermes-heygen-video x-default: https://runapi.ai/hermes-heygen-video model_line: heygen-video --- > HTML version: https://runapi.ai/zh-TW/hermes-heygen-video > Site index for agents: https://runapi.ai/llms.txt [Hermes Agent](https://runapi.ai/zh-TW/hermes-agent.md) / [HeyGen Video](https://runapi.ai/zh-TW/models/heygen-video.md) # Hermes Agent x HeyGen Video 文字生成影片、圖片生成影片與參考引導生成共用一個 RunAPI 模型 ID。輸出解析度為 480p 至 2K；參考模式最多支援 9 張圖片、3 段影片與 3 段音訊，參考檔案總數不超過 12 個。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [查看 Hermes Agent 文件](https://runapi.ai/zh-TW/docs/guides) 1 variants · 起價 $0.09 / 秒 · 可商用 ## Prompt Prerequisite: `npx runapi mcp install` ```text You have access to RunAPI task tools for HeyGen Video. Available HeyGen Video models: - heygen-video-1: heygen-video-1 endpoints: /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video request fields: model, prompt, output_resolution, aspect_ratio Use the model ID and endpoint that match the user's request. Example prompt: 生成一段 10 秒 1080p 的產品影片：陽光灑落的廚房檯面上放著一只陶瓷馬克杯，使用參考圖片保持杯子設計一致，並加入輕柔的環境音。 /api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/text_to_video，並儲存回傳的 Task ID。 GET /api/v1/heygen_video/text_to_video/，直到狀態為 completed 或 failed。 確認 completed 回應包含 API 參考中記載的端點專屬輸出。 /api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/image_to_video，並儲存回傳的 Task ID。 GET /api/v1/heygen_video/image_to_video/，直到狀態為 completed 或 failed。 確認 completed 回應包含 API 參考中記載的端點專屬輸出。 ``` ## Prompt 模型 透過本指南使用 RunAPI 與 HeyGen Video。 - `heygen-video-1`: heygen-video-1 任務合適時使用 heygen-video-1：heygen-video-1。 ## 公開版本與端點 | 模型 ID | 版本 | 端點 | 起始價格 | | --- | --- | --- | --- | | `heygen-video-1` | heygen-video-1 | /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video | $0.09 / 秒 | ## 驗證 輪詢，直到 Task 進入終態 ``` POST /api/v1/heygen_video/text_to_video，並儲存回傳的 Task ID。 GET /api/v1/heygen_video/text_to_video/，直到狀態為 completed 或 failed。 確認 completed 回應包含 API 參考中記載的端點專屬輸出。 ``` ## 設定 設定 `RUNAPI_API_KEY`，再向 `` 傳送包含 `` 的請求。只有端點回傳非同步 Task 時才需輪詢。 ```shell export RUNAPI_API_KEY=your_api_key curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \ -H "Authorization: Bearer $RUNAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "heygen-video-1", "prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.", "output_resolution": "768p", "aspect_ratio": "16:9" }' ``` ## 三步開始使用 1. **選擇模型 ID.** 選擇公開模型 ID，並查看其端點與目前起始價格。 2. **設定 RunAPI.** 呼叫端點前設定 RUNAPI_API_KEY。 3. **驗證結果.** 對非同步端點輪詢同一路徑，直到 Task 進入終態。 ## 使用 Hermes Agent + HeyGen Video 可以打造什麼 **產品與行銷短片** 根據文字需求為商品頁、廣告和到達頁製作簡短的宣傳短片。 **社群媒體短影音** 為社群平台製作短影音，並針對同一創意產生多個版本後再挑選。 **圖片動畫與影片編輯** 在模型提供圖片轉影片或影片編輯端點時，讓靜態圖片動起來或修改現有影片。 ## 為什麼透過 RunAPI + Hermes Agent 使用 HeyGen Video **1 個變體，一個 API 金鑰** 透過一個 RunAPI 連線選擇可用的模型變體，無需變更現有整合。 **清楚的用量價格** 送出請求前查看目錄中的目前價格，無需訂閱或最低消費。 **自動化工作流程** 透過一致的工作流程提交工作、查詢狀態並收集非同步結果，無需撰寫手動輪詢程式碼。 ## Hermes Agent + HeyGen Video 常見問題 ### HeyGen Video API 的模型 ID 是什麼？ 將 model 的值設為 heygen-video-1。文字生影片端點接收提示詞與選用的參考圖片、影片或音訊；圖片生影片端點接收提示詞與首幀圖片。 ### HeyGen Video 支援哪些輸入方式？ 支援文字提示詞、首幀圖片，以及參考圖片、影片與音訊。輸出為 5 到 15 秒，解析度可選 480p、768p、1080p 或 2K，並包含生成的聲音。 ### HeyGen Video 會生成聲音嗎？ 會。對白、環境音與音效會與影片在同一次請求中生成。 ### HeyGen Video 在 RunAPI 上如何計費？ 依影片秒數計費。本頁的價格表列出每種解析度與輸入類型的目前費率，生成失敗不計費。 ### 這是 HeyGen 的數位人（avatar）API 嗎？ 不是。HeyGen Video 是 HeyGen 的通用影片模型，依據提示詞或圖片生成包含聲音在內的完整畫面。由腳本與所選聲音生成的數位人口播影片，來自 HeyGen 另外提供的 avatar API，RunAPI 不提供該 API。 ### 應該使用哪個模型 ID？ 從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。 ### 本指南會設定聊天模型嗎？ 不會。此 Model Line 使用頁面所示的端點流程，不會被描述為 Agent 聊天模型。 ## 更多 Hermes Agent 指南 - [Hermes Agent x Claude](https://runapi.ai/zh-TW/hermes-claude.md) - Anthropic · 文字 · 起價 $0.08 / 百萬 tokens - [Hermes Agent x DeepSeek](https://runapi.ai/zh-TW/hermes-deepseek.md) - DeepSeek · 文字 · 起價 $0.30 / 百萬 tokens - [Hermes Agent x ElevenLabs](https://runapi.ai/zh-TW/hermes-elevenlabs.md) - ElevenLabs · 音訊與音樂 · 起價 $0.03 / 1K 字元 - [Hermes Agent x Embedding](https://runapi.ai/zh-TW/hermes-embedding.md) - OpenAI · 文字 · 起價 $0.02 / 百萬 tokens ## 開始在 Hermes Agent 中使用 HeyGen Video - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀快速入門](https://runapi.ai/zh-TW/docs/guides) ## 正在與團隊一起打造？ 我們可以協助企業接入、整合與技術問題。 [聯絡我們](https://runapi.ai/zh-TW/contact.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-TW/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [x402](https://runapi.ai/zh-TW/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) ### 法律 - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "SoftwareApplication", "name": "Hermes Agent x HeyGen Video", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI 在 Hermes Agent 中使用 HeyGen Video。比較目前的模型 ID、端點與價格，再依對應流程完成設定。", "url": "https://runapi.ai/zh-TW/hermes-heygen-video" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "HeyGen Video API 的模型 ID 是什麼？", "acceptedAnswer": { "@type": "Answer", "text": "將 model 的值設為 heygen-video-1。文字生影片端點接收提示詞與選用的參考圖片、影片或音訊；圖片生影片端點接收提示詞與首幀圖片。" } }, { "@type": "Question", "name": "HeyGen Video 支援哪些輸入方式？", "acceptedAnswer": { "@type": "Answer", "text": "支援文字提示詞、首幀圖片，以及參考圖片、影片與音訊。輸出為 5 到 15 秒，解析度可選 480p、768p、1080p 或 2K，並包含生成的聲音。" } }, { "@type": "Question", "name": "HeyGen Video 會生成聲音嗎？", "acceptedAnswer": { "@type": "Answer", "text": "會。對白、環境音與音效會與影片在同一次請求中生成。" } }, { "@type": "Question", "name": "HeyGen Video 在 RunAPI 上如何計費？", "acceptedAnswer": { "@type": "Answer", "text": "依影片秒數計費。本頁的價格表列出每種解析度與輸入類型的目前費率，生成失敗不計費。" } }, { "@type": "Question", "name": "這是 HeyGen 的數位人（avatar）API 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "不是。HeyGen Video 是 HeyGen 的通用影片模型，依據提示詞或圖片生成包含聲音在內的完整畫面。由腳本與所選聲音生成的數位人口播影片，來自 HeyGen 另外提供的 avatar API，RunAPI 不提供該 API。" } }, { "@type": "Question", "name": "應該使用哪個模型 ID？", "acceptedAnswer": { "@type": "Answer", "text": "從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。" } }, { "@type": "Question", "name": "本指南會設定聊天模型嗎？", "acceptedAnswer": { "@type": "Answer", "text": "不會。此 Model Line 使用頁面所示的端點流程，不會被描述為 Agent 聊天模型。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "在 Hermes Agent 中使用 HeyGen Video", "step": [ { "@type": "HowToStep", "position": 1, "name": "選擇模型 ID", "text": "選擇公開模型 ID，並查看其端點與目前起始價格。", "url": "https://runapi.ai/zh-TW/hermes-heygen-video#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "設定 RunAPI", "text": "呼叫端點前設定 RUNAPI_API_KEY。", "url": "https://runapi.ai/zh-TW/hermes-heygen-video#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "驗證結果", "text": "對非同步端點輪詢同一路徑，直到 Task 進入終態。", "url": "https://runapi.ai/zh-TW/hermes-heygen-video#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "Hermes Agent", "item": "https://runapi.ai/zh-TW/hermes-agent" }, { "@type": "ListItem", "position": 3, "name": "HeyGen Video", "item": "https://runapi.ai/zh-TW/hermes-heygen-video" } ] } ] ```