---
title: "通过 RunAPI 在龙虾 (OpenClaw) 中使用 Seedance — 视频 API 指南"
url: "https://runapi.ai/zh-CN/openclaw-seedance.md"
canonical: "https://runapi.ai/zh-CN/openclaw-seedance"
locale: "zh-CN"
model: "seedance"
---

# 在 OpenClaw 中使用 Seedance。

Seedance 2.0 可生成 4–15 秒、最高 1080p 的视频，按秒计费起价约 $0.05/秒——是 RunAPI 视频模型中每秒成本最低的。它支持多模态参考输入（图像、视频和音频 URL）、首/末帧控制以及原生音频同步。OpenClaw agent 通过与聊天相同的 RunAPI 密钥和端点调用它。

## 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. **Configure RunAPI** — Set RUNAPI_API_KEY in your environment. If you already configured RunAPI for chat in OpenClaw, the same key works for Seedance video generation — no extra provider setup needed.
2. **Call Seedance text_to_video** — Send a POST to the text_to_video endpoint with model set to seedance-2.0. Include a prompt, duration_seconds (4–15), aspect_ratio, and output_resolution. Optionally attach first_frame_image_url, reference_image_urls, or reference_audio_urls for multimodal control.
3. **Poll for the result** — The endpoint returns a task_id immediately. Poll the task status endpoint until the status is completed, then read the output video URL from the response. Billing is per-second based on the generated video duration and resolution.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Required. seedance-2.0, seedance-2.0-fast, seedance-1.5-pro, seedance-v1-pro, seedance-v1-lite. |
| `prompt` | `string` | Required. Text description of the video scene to generate. |
| `duration_seconds` | `integer` | Video length in seconds. 4–15 for Seedance 2.0, 5 or 10 for v1 variants. |
| `aspect_ratio` | `string` | Output aspect ratio. Accepted: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto. |
| `output_resolution` | `string` | Video resolution. Accepted: 480p, 720p, 1080p. Higher resolution costs more per second. |
| `first_frame_image_url` | `string` | Optional. URL of an image to use as the first frame. Enables image-to-video workflows. |
| `last_frame_image_url` | `string` | Optional. URL of an image to use as the last frame. Constrains the ending scene. |
| `reference_image_urls` | `array` | Optional. URLs of reference images for pose, depth, or edge guidance. |
| `reference_audio_urls` | `array` | Optional. URLs of reference audio files for native audio sync in the generated video. |
| `reference_video_urls` | `array` | Optional. URLs of reference videos for motion or style transfer. |
| `callback_url` | `string` | Optional. Webhook URL that receives a POST when the task completes. |

## FAQ

### Can I use Seedance in OpenClaw?

Yes. Configure RunAPI as an OpenAI-compatible provider in OpenClaw, then call the text_to_video endpoint with model set to seedance-2.0. The same API key handles both chat and video generation.

### How does Seedance per-second billing work?

You are billed based on the actual duration of the generated video and the output resolution you select. A 480p video costs less per second than 1080p. The cost is deducted after the video completes, not when the task is created.

### Can I use English prompts for non-Chinese content on Seedance?

Yes. Seedance accepts English prompts and generates multi-language content. It supports both English and Chinese prompt input regardless of the target video content language.

### Can Seedance generate video from an image?

Yes. Pass an image URL in the first_frame_image_url parameter along with a text prompt. Seedance uses the image as the opening frame and generates motion from there. You can also set last_frame_image_url to constrain the ending.

### How do reference_audio_urls work with Seedance?

Seedance 2.0 can sync generated video motion to an audio track. Pass the audio file URL in reference_audio_urls and the model aligns visual motion to the audio -- useful for music videos or dialogue-driven scenes without a separate audio-to-video step.


## Links

- [OpenClaw 配置指南 →](https://runapi.ai/zh-CN/openclaw)
- [RunAPI 上的 Seedance →](https://runapi.ai/zh-CN/models/seedance)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [API docs](https://runapi.ai/zh-CN/docs)