---
title: "通过 RunAPI 在爱马仕 (Hermes Agent) 中使用 Seedance — 视频 API 指南"
url: "https://runapi.ai/zh-CN/hermes-seedance.md"
canonical: "https://runapi.ai/zh-CN/hermes-seedance"
locale: "zh-CN"
model: "seedance"
---

# 在 Hermes Agent 中使用 Seedance。

Seedance 2.0 可生成 4–15 秒、最高 1080p 的视频，按秒计费起价约 $0.05/秒 — 是 RunAPI 视频模型中每秒成本最低的选择。它支持多模态参考输入（图片、视频和音频 URL）、首尾帧控制及原生音频同步。Hermes Agent 通过 RunAPI custom 端点调用 — 设置一次 custom:runapi 即可复用同一把 key。

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **设置 RunAPI** — 在 Hermes Agent 运行的环境中设置 RUNAPI_API_KEY。如果你已将 RunAPI 添加为 custom:runapi provider 用于聊天，同一把 key 和 base_url 即可处理视频生成。如果尚未设置，请添加 custom provider 并设置 base_url 为 https://runapi.ai/v1，然后执行 hermes doctor。
2. **调用 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 发送此请求。
3. **轮询获取结果** — 端点会立即返回 task_id。轮询任务状态端点，直到 status 为 completed，然后从响应中读取输出视频 URL。计费按生成视频的时长和分辨率按秒收取。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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。 |

## FAQ

### 我可以在 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 搭配首尾帧锚点。


## Links

- [Hermes Agent 设置指南 →](https://runapi.ai/zh-CN/hermes-agent)
- [Seedance on RunAPI →](https://runapi.ai/zh-CN/models/seedance)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [API docs](https://runapi.ai/zh-CN/docs)