我可以在 Hermes Agent 中使用 Seedance 嗎？

可以。在 Hermes Agent 中將 RunAPI 設定為 custom provider 並設定 base_url 為 https://runapi.ai/v1，然後呼叫 text_to_video 端點並將 model 設為 seedance-2.0。同一把 API key 可同時處理聊天和影片生成。

Seedance 按秒計費如何運作？

計費基於生成影片的實際時長和你選擇的輸出解析度。480p 影片的每秒費用低於 1080p。費用在影片完成後扣除，而非在任務建立時。

Hermes Agent 需要安裝外掛才能生成影片嗎？

不需要。Hermes Agent 透過 custom:runapi provider 發送 HTTP 請求，方式與聊天請求相同。text_to_video 端點接受 JSON body 並回傳 task ID。不需要額外的外掛或擴充功能。

Seedance 能從圖片生成影片嗎？

可以。在 first_frame_image_url 參數中傳入圖片 URL 並搭配文字 prompt。Seedance 會以該圖片作為開頭畫面，從中生成動態。你也可以設定 last_frame_image_url 來限定結尾。

Seedance 2.0 影片最長可以多長？

Seedance 2.0 可生成 4 到 15 秒的影片。使用 duration_seconds 參數設定你想要的長度。舊版本（v1-pro、v1-lite）僅支援 5 或 10 秒的固定時長。若需更長內容，可串接多個影片，使用角色一致的 prompt 搭配首尾幀錨點。

HERMES + SEEDANCE

在 Hermes Agent 中使用 Seedance。

Seedance 2.0 可生成 4–15 秒、最高 1080p 的影片，按秒計費起價約 $0.05/秒 — 是 RunAPI 影片模型中每秒成本最低的選擇。它支援多模態參考輸入（圖片、影片和音訊 URL）、首尾幀控制及原生音訊同步。Hermes Agent 透過 RunAPI custom 端點呼叫 — 設定一次 custom:runapi 即可沿用同一把 key。

取得 API Key 閱讀說明文件

一個 API key · 文生影片端點 · 按秒計費

Generate a product showcase video using Seedance 2.0 through RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/seedance/text_to_video
- Set model to "seedance-2.0".
- Set prompt to describe the video scene.
- Set duration_seconds to the desired length (4–15).
- Set aspect_ratio to "16:9" for landscape video.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.

curl -X POST https://runapi.ai/api/v1/seedance/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A ceramic coffee mug rotates slowly on a wooden table, steam rising, warm morning light from a window, cinematic",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "output_resolution": "1080p"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedance-2.0"
}

複製 curl 指令進行測試 seedance

運作原理

三步驟在 Hermes Agent 中使用 Seedance

設定 RunAPI

在 Hermes Agent 運行的環境中設定 RUNAPI_API_KEY。如果你已將 RunAPI 新增為 custom:runapi provider 用於聊天，同一把 key 和 base_url 即可處理影片生成。如果尚未設定，請新增 custom provider 並設定 base_url 為 https://runapi.ai/v1，然後執行 hermes doctor。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Seedance text_to_video

發送 POST 請求至 text_to_video 端點，將 model 設為 seedance-2.0。加入 prompt、duration_seconds（4–15）、aspect_ratio 和 output_resolution。可選擇附加 first_frame_image_url、reference_image_urls 或 reference_audio_urls 進行多模態控制。Hermes Agent 透過 custom:runapi provider 發送此請求。

POST /api/v1/seedance/text_to_video

輪詢取得結果

端點會立即回傳 task_id。輪詢任務狀態端點，直到 status 為 completed，然後從回應中讀取輸出影片 URL。計費按生成影片的時長和解析度按秒收取。

GET /api/v1/seedance/text_to_video/tsk_abc123

參數

Seedance API 參數

參數	類型	說明
`model`	`string`	必填。seedance-2.0、seedance-2.0-fast、seedance-1.5-pro、seedance-v1-pro、seedance-v1-lite。
`prompt`	`string`	必填。描述要生成的影片場景的文字。
`duration_seconds`	`integer`	影片長度（秒）。Seedance 2.0 支援 4–15 秒，v1 版本支援 5 或 10 秒。
`aspect_ratio`	`string`	輸出長寬比。可接受的值：1:1、4:3、3:4、16:9、9:16、21:9、auto。
`output_resolution`	`string`	影片解析度。可接受的值：480p、720p、1080p。解析度越高，每秒費用越高。
`first_frame_image_url`	`string`	選填。用作第一幀的圖片 URL。可實現圖生影片工作流。
`last_frame_image_url`	`string`	選填。用作最後一幀的圖片 URL。可限定結尾場景。
`reference_image_urls`	`array`	選填。用於姿態、深度或邊緣引導的參考圖片 URL。
`reference_audio_urls`	`array`	選填。用於在生成影片中進行原生音訊同步的參考音訊檔案 URL。
`reference_video_urls`	`array`	選填。用於動態或風格轉移的參考影片 URL。
`callback_url`	`string`	選填。任務完成時接收 POST 通知的 Webhook URL。

Hermes Agent 上的 Seedance 是什麼？

ByteDance 的 Seedance 2.0 提供單次生成的統一音視覺輸出。使用者稱其在多鏡頭敘事和嘴型同步準確度方面是同類最佳。透過 Hermes Agent 的 custom:runapi provider，可生成 4 至 15 秒、最高 1080p 的片段，採按秒計費——是 RunAPI 影片模型中每秒費用最低的。