---
title: "透過 RunAPI 在 OpenClaw 中使用 Seedance — 影片 API 指南"
url: "https://runapi.ai/zh-HK/openclaw-seedance.md"
canonical: "https://runapi.ai/zh-HK/openclaw-seedance"
locale: "zh-HK"
model: "seedance"
---

# 在 OpenClaw 中使用 Seedance。

Seedance 2.0 可生成 4–15 秒、最高 1080p 的影片，按秒計費起價約 $0.05/秒 — 是 RunAPI 影片模型中每秒成本最低的選擇。它支援多模態參考輸入（圖片、影片和音訊 URL）、首尾幀控制及原生音訊同步。OpenClaw agent 透過與聊天相同的 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** — 在環境中設定 RUNAPI_API_KEY。如果你已在 OpenClaw 中設定 RunAPI 用於聊天，同一把 key 即可用於 Seedance 影片生成 — 無需額外的 provider 設定。
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 進行多模態控制。
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

### 我可以在 OpenClaw 中使用 Seedance 嗎？

可以。在 OpenClaw 中將 RunAPI 設定為 OpenAI 相容的 provider，然後呼叫 text_to_video 端點並將 model 設為 seedance-2.0。同一把 API key 可同時處理聊天和影片生成。

### Seedance 按秒計費如何運作？

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

### seedance-2.0 和 seedance-2.0-fast 有什麼差別？

Seedance 2.0 支援最高 1080p 輸出，每秒費用較高。Seedance 2.0-fast 上限為 720p，但生成更快且費用更低。兩者接受相同的多模態參考輸入。

### Seedance 能從圖片生成影片嗎？

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

### reference_audio_urls 在 Seedance 中如何運作？

Seedance 2.0 可將生成的影片動態同步至音訊軌道。在 reference_audio_urls 中傳入音訊檔案 URL，模型會將視覺動態與音訊對齊 — 適合音樂影片或對白驅動的場景，無需額外的音訊轉影片步驟。


## Links

- [OpenClaw 設定指南 →](https://runapi.ai/zh-HK/openclaw)
- [Seedance on RunAPI →](https://runapi.ai/zh-HK/models/seedance)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)