OpenClaw plugin for BytePlus Seedream image generation and Seedance video generation via ARK API
Install
$
openclaw plugins install clawhub:openclaw-plugin-byteplus-modelarkopenclaw-plugin-byteplus-modelark
OpenClaw plugin for BytePlus ARK API — language models, image generation, and video generation.
- Language models — Seed 2.0 Pro/Lite, Seed 1.8, Kimi K2.5, GLM 4.7, Ark Code (via providers
byteplus-modelark/byteplus-modelark-plan) - Seedream — text-to-image generation (models: Seedream 5.0, 4.5, 4.0)
- Seedance — text-to-video and image-to-video generation (models: Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite)
All capabilities share a single BYTEPLUS_API_KEY.
Installation
openclaw plugins install openclaw-plugin-byteplus-modelark
Or link locally for development:
git clone https://github.com/xieyongliang/openclaw-plugin-byteplus-modelark.git
cd openclaw-plugin-byteplus-modelark
npm install
openclaw plugins install --link .
Configuration
Set your BytePlus API key before starting OpenClaw:
export BYTEPLUS_API_KEY="your-api-key"
Or run the onboarding wizard after installation (for language models):
openclaw onboard
# Select "BytePlus ModelArk" → "BytePlus ModelArk API key" → enter your key
Get your API key from the BytePlus ModelArk Console.
Usage
Once installed and the API key is configured, the plugin registers language model providers and image/video generation tools automatically.
Language models (Seed / Kimi / GLM)
Use byteplus-modelark as your model provider in OpenClaw:
What is the capital of France?
Review this code and suggest improvements
Enable deep thinking for complex reasoning (Seed models only):
--thinking high: Solve this math problem step by step: ...
--thinking medium: Analyze the pros and cons of microservices architecture
Switch models explicitly:
Using seed-2-0-lite, summarize this article in 3 bullet points
Using kimi-k2-5, translate this document to Chinese
Image generation (Seedream)
Generate an image of a mountain landscape at sunrise
Generate a 4K image of a cute cat with seed 42 and guidance scale 7.5
Video generation (Seedance)
Generate a 5 second video of ocean waves crashing on a beach
Generate a 10 second 1080p video of a cityscape timelapse in 16:9
List available models
List all available image generation models
List all available video generation models
Supported Models
Language Models
byteplus-modelark (general)
| Model ID | Name | Input | Context |
|---|---|---|---|
seed-2-0-pro-260328 | Seed 2.0 Pro (default) | text, image | 256K |
seed-2-0-lite-260228 | Seed 2.0 Lite | text, image | 256K |
seed-1-8-251228 | Seed 1.8 | text, image | 256K |
kimi-k2-5 | Kimi K2.5 | text | 131K |
glm-4-7 | GLM 4.7 | text, image | 128K |
byteplus-modelark-plan (coding)
| Model ID | Name | Input | Context |
|---|---|---|---|
ark-code-latest | Ark Code (Latest) | text | 256K |
Seed models support deep thinking: pass --thinking high/medium/low or set reasoning_effort via extraParams.
Seedream (Image)
| Model ID | Description |
|---|---|
seedream-5-0-260128 | Seedream 5.0 (default) |
seedream-4-5-251128 | Seedream 4.5 |
seedream-4-0-250828 | Seedream 4.0 |
Seedance (Video)
| Model ID | Description |
|---|---|
seedance-1-5-pro-251215 | Seedance 1.5 Pro (default) |
seedance-1-0-pro-250528 | Seedance 1.0 Pro |
seedance-1-0-pro-fast-251015 | Seedance 1.0 Pro Fast |
seedance-1-0-lite-t2v-250428 | Seedance 1.0 Lite (text-to-video) |
seedance-1-0-lite-i2v-250428 | Seedance 1.0 Lite (image-to-video) |
Supported Parameters
Image Generation
| Parameter | Type | Description |
|---|---|---|
prompt | string | Text description |
model | string | Model ID (default: seedream-5-0-260128) |
resolution | string | 1K, 2K, or 4K (default: 2K) |
seed | number | Random seed for reproducibility |
watermark | boolean | Add watermark (default: false) |
guidanceScale | number | Prompt adherence (1.0-20.0) |
optimizePrompt | boolean | Auto-optimize prompt |
inputImages | image[] | Reference images for editing |
Video Generation
| Parameter | Type | Description |
|---|---|---|
prompt | string | Text description |
model | string | Model ID (default: seedance-1-5-pro-251215) |
duration | number | Duration in seconds (4-12) |
aspectRatio | string | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
resolution | string | 480p, 720p, 1080p (default: 720p) |
seed | number | Random seed for reproducibility |
watermark | boolean | Add watermark (default: false) |
firstFrameImageUrl | string | First frame reference image URL (I2V) |
lastFrameImageUrl | string | Last frame reference image URL (I2V) |
camerafixed | boolean | Fix camera position |
draft | boolean | Draft mode (forces 480p, faster) |
Requirements
License
MIT