在 Hermes Agent 中使用 Seedance。
Seedance 2.0 可生成 4–15 秒、最高 1080p 的视频，按秒计费起价约 $0.05/秒 — 是 RunAPI 视频模型中每秒成本最低的选择。它支持多模态参考输入（图片、视频和音频 URL）、首尾帧控制及原生音频同步。Hermes Agent 通过 RunAPI custom 端点调用 — 设置一次 custom:runapi 即可复用同一把 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"
}
三步在 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 是什么？
字节跳动的 Seedance 2.0 实现单次生成音视频统一输出。通过 Hermes Agent 的 custom:runapi provider，可生成 4 至 15 秒、最高 1080p 的视频，按秒计费——是 RunAPI 视频模型中每秒成本最低的选择。
Seedance 使用场景
带场景转场的多镜头叙事
构建角色在场景切换间保持一致的多镜头视频序列。Seedance 在单次生成中处理镜头间的转场和连续性。
音频同步叙事
传入参考音轨，让 Seedance 生成与音频对齐的视频动作。适用于音乐视频、播客可视化或对话驱动的内容。
过场动画预可视化
创作带对白和场景指示的游戏或电影过场动画原型。Seedance 同时渲染视觉和音频，让导演在正式制作前预览效果。
Seedance + Hermes Agent 常见问题
可以。在 Hermes Agent 中将 RunAPI 设置为 custom provider 并设置 base_url 为 https://runapi.ai/v1，然后调用 text_to_video 端点并将 model 設为 seedance-2.0。同一把 API key 可同時处理聊天和视频生成。
计费基於生成视频的实际时长和你选择的输出分辨率。480p 视频的每秒費用低於 1080p。费用在视频完成後扣除，而非在任务创建时。
不需要。Hermes Agent 通过 custom:runapi provider 发送 HTTP 请求，方式与聊天请求相同。text_to_video 端点接受 JSON body 并返回 task ID。不需要额外的插件或扩展功能。
可以。在 first_frame_image_url 参数中传入图片 URL 并搭配文字 prompt。Seedance 会以該图片作为开头画面，从中生成动态。你也可以设置 last_frame_image_url 来限定结尾。
Seedance 2.0 可生成 4 到 15 秒的视频。使用 duration_seconds 参数设置想要的长度。舊版本（v1-pro、v1-lite）仅支持 5 或 10 秒的固定时长。若需更长内容，可串接多个视频，使用角色一致的 prompt 搭配首尾帧锚点。
立即在 Hermes Agent 中试用 Seedance。
获取免費 RunAPI key，设置 custom:runapi provider，即可开始使用 Seedance 2.0 按秒计费生成视频。