Seedance Video Generation

Generate AI videos using ByteDance Seedance models via the Volcengine Ark API.

Prerequisites

The user must set the ARK_API_KEY environment variable. You can set it by running:

CODEBLOCK0

Base URL: INLINECODE1

Supported Models

Default model: doubao-seedance-1-5-pro-251215 (latest, supports audio)

Execution (Recommended: Python CLI Tool)

A Python CLI tool is provided at ~/.claude/skills/seedance-video/seedance.py for robust execution with proper error handling, automatic retries, and local image base64 conversion. Prefer using this tool over raw curl commands.

Quick Examples with Python CLI

CODEBLOCK1

Alternative: Raw curl Commands

Step 1: Create Video Generation Task

Determine the generation mode based on user input, then call the API.

Mode A: Text-to-Video

CODEBLOCK2

Mode B: Image-to-Video (First Frame)

The user provides one image as the first frame. The image can be a URL or local file path (convert to base64).

With image URL:
CODEBLOCK3

With local image file (convert to base64):
CODEBLOCK4

Mode C: Image-to-Video (First + Last Frame)

Requires two images. Supported by: Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite I2V.

CODEBLOCK5

Mode D: Reference Image-to-Video (Seedance 1.0 Lite I2V only)

Provide 1-4 reference images. Use [图1], [图2] in prompt to reference specific images.

CODEBLOCK6

Step 2: Poll for Task Completion

Video generation is asynchronous. Poll the task status until it completes.

CODEBLOCK7

Step 3: Download and Open Video

CODEBLOCK8

Optional Parameters Reference

Additional Operations

Query Task Status

CODEBLOCK9

List Tasks

CODEBLOCK10

Cancel or Delete Task

CODEBLOCK11

Note: queued tasks will be cancelled; succeeded/failed/expired tasks will be deleted from history.

Generate Consecutive Videos (Using Last Frame)

Set return_last_frame: true on the first task, then use the returned last_frame_url as the first frame of the next task.

CODEBLOCK12

Draft Mode (Seedance 1.5 Pro)

Generate a cheap preview first, then produce the final video if satisfied:

CODEBLOCK13

Image Requirements

• - Formats: jpeg, png, webp, bmp, tiff, gif (1.5 Pro also supports heic, heif)
• Aspect ratio (width/height): between 0.4 and 2.5
• Dimensions: 300-6000 px per side
• Max file size: 30 MB

通过飞书发送视频文件（OpenClaw）

详见 howtosendvideoviafeishu_app.md

Rules

1. 1. Always check that ARK_API_KEY is set before making API calls: INLINECODE56
2. Default to Seedance 1.5 Pro (doubao-seedance-1-5-pro-251215) unless user requests a specific model.
3. Default to 720p, 16:9, 5 seconds, with audio for text-to-video.
4. Default to adaptive ratio for image-to-video (auto-adapts to the input image).
5. Poll interval: 15 seconds between status checks.
6. Video URLs expire in 24 hours - always download immediately after generation.
7. Task history is kept for 7 days only.
8. For local image files, convert to base64 data URL format before sending.
9. Always show the user the task ID so they can check status later.
10. When generation fails, display the error message clearly and suggest possible fixes.