Volcengine Ark Plugin

Image generation (Seedream 5.0) and video generation (Seedance 1.5) via Volcengine Ark API.

Configuration

Add the plugin to your openclaw.json:

{
  "plugins": {
    "volcengine": {
      "imageApiKey": "your-ark-api-key",
      "imageModel": "ep-your-image-endpoint-id",
      "videoApiKey": "your-ark-api-key",
      "videoModel": "ep-your-video-endpoint-id"
    }
  }
}

Base URL

The baseUrl defaults to the Volcengine China region. Set it explicitly if you use a different region or BytePlus.

| Provider | Region | Base URL | | ---------- | --------------- | ---------------------------------------------------- | | Volcengine | China (Beijing) | https://ark.cn-beijing.volces.com/api/v3 (default) | | BytePlus | Southeast Asia | https://ark.ap-southeast.bytepluses.com/api/v3 |

Example for BytePlus:

{
  "plugins": {
    "volcengine": {
      "baseUrl": "https://ark.ap-southeast.bytepluses.com/api/v3",
      "imageApiKey": "...",
      "imageModel": "ep-...",
      "videoApiKey": "...",
      "videoModel": "ep-..."
    }
  }
}

Config Fields

| Field | Required | Description | | ------------- | -------- | ---------------------------------------------- | | baseUrl | No | Ark API base URL (see table above) | | imageApiKey | No | API key for Seedream image generation | | imageModel | No | Model endpoint ID for Seedream (e.g. ep-...) | | videoApiKey | No | API key for Seedance video generation | | videoModel | No | Model endpoint ID for Seedance (e.g. ep-...) |

You only need to configure the fields for the features you use. For example, if you only need image generation, you can omit videoApiKey and videoModel.

Tools

seedream_generate_image

Generate images from text prompts using Seedream 5.0.

seedance_create_video

Start an async video generation task using Seedance 1.5. Returns a task ID.

seedance_query_video

Poll for video generation task completion. Returns the video file path on success.