---
title: "RunAPI 経由で OpenClaw から Seedance を使う — 動画 API ガイド"
url: "https://runapi.ai/ja/openclaw-seedance.md"
canonical: "https://runapi.ai/ja/openclaw-seedance"
locale: "ja"
model: "seedance"
---

# OpenClaw で Seedance を使う。

Seedance 2.0 は 4〜15秒・最大 1080p の動画を生成し、秒単位の課金は約 $0.05/秒から——RunAPI の動画モデルの中で秒あたりのコストが最も低いものです。マルチモーダル参照入力（画像、動画、音声 URL）、最初/最後のフレーム制御、ネイティブ音声同期に対応します。OpenClaw のエージェントはチャットと同じ 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/ja/openclaw)
- [RunAPI の Seedance →](https://runapi.ai/ja/models/seedance)
- [Model catalog](https://runapi.ai/ja/models)
- [API docs](https://runapi.ai/ja/docs)