🎨 Doubao Seedream & Seedance API Skill

> Professional AI Generation Suite - Powered by Doubao Seed Models

A comprehensive AI generation skill featuring Doubao Seedream for image generation, Doubao Seedance for video creation, and Doubao Seed Vision for visual understanding.




🌟 Core Features

🎨 Doubao Seedream 4.0 - Image Generation

State-of-the-art text-to-image generation with exceptional quality and control.

Model ID: doubao-seedream-4-0-250828

Generate an image: sunset beach with palm trees and golden waves, photorealistic style

🎬 Doubao Seedance 1.5 - Video Generation

Professional video creation with advanced camera control and motion dynamics.

Model ID: doubao-seedance-1-5-pro-251215

Generate a 5-second video: camera slowly pulls out revealing mountain vista at dawn

👁️ Doubao Seed Vision - Visual Understanding

Advanced image analysis and comprehension powered by multimodal AI.

Model ID: doubao-seed-1-6-vision-250815

Analyze this image: https://example.com/photo.jpg - describe the scene and identify objects

📊 Model Comparison

🚀 Quick Start

Prerequisites

• Python 3.9 or higher
• Volcengine API Key (Get it here)
• pip or Docker

Installation (Choose One)

Option 1: One-Click Install ⚡ (Recommended)

# Clone and install
git clone https://github.com/Lychee-AI-Team/seedream-skill.git
cd seedream-skill
./install.sh

Option 2: Docker 🐳

# Clone
git clone https://github.com/Lychee-AI-Team/seedream-skill.git
cd seedream-skill

# Configure
echo "ARK_API_KEY=your-api-key" > .env

# Run
docker compose up --build

Option 3: Manual 🛠️

# Clone
git clone https://github.com/Lychee-AI-Team/seedream-skill.git
cd seedream-skill

# Install dependencies
pip install -r volcengine-api/requirements.txt

# Configure
export ARK_API_KEY="your-api-key"

Configuration

# Method 1: Environment Variable (Recommended ✅ Most Secure)
export ARK_API_KEY="your-api-key-here"

# Method 2: Interactive Wizard
./scripts/configure.sh

# Method 3: Config File
mkdir -p ~/.volcengine
echo 'api_key: "your-api-key"' > ~/.volcengine/config.yaml
chmod 600 ~/.volcengine/config.yaml  # Important!

Verify Installation

./scripts/verify_install.sh

📖 Usage Guide

🎨 Image Generation

Basic Usage:

Generate an image: sunset beach with palm trees

Advanced Usage:

Generate image with parameters:
- Content: futuristic city skyline at night
- Size: 1920x1080
- Style: cyberpunk aesthetic
- Negative prompt: blurry, low quality

Parameters:

🎬 Video Generation

Basic Usage:

Generate a 5-second video: ocean waves crashing on rocks

Advanced Usage:

Generate video with parameters:
- Content: drone shot of forest canopy
- Duration: 8 seconds
- Motion: slow vertical ascent
- Aspect ratio: 16:9

Parameters:

👁️ Vision Understanding

Basic Usage:

Analyze this image: https://example.com/image.jpg

Advanced Usage:

Analyze image with focus on:
- Identify all objects present
- Describe the scene composition
- Detect any text in the image
- Suggest improvements for photography

Parameters:

📋 Task Management

View Tasks:

Show my task list
List all pending tasks

Check Status:

Check status of task-123
What's the progress of my video generation?

Download Results:

Download result of task-123
Save the generated image to output folder

🔒 Security Best Practices

> ⚠️ Important: API Keys are sensitive credentials. Follow these security practices.

✅ Recommended Methods

🔑 Environment Variable Setup

# Temporary (current session)
export ARK_API_KEY="your-api-key"

# Permanent (add to shell config)
echo 'export ARK_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# Verify (should show first 4 characters)
echo $ARK_API_KEY | head -c 4

🔐 Config File Security

# Create config
mkdir -p ~/.volcengine
cat > ~/.volcengine/config.yaml << 'EOF'
api_key: "your-api-key"
base_url: "https://ark.cn-beijing.volces.com/api/v3"
EOF

# Set permissions (CRITICAL!)
chmod 700 ~/.volcengine
chmod 600 ~/.volcengine/config.yaml

❌ Prohibited Actions

🔄 Key Rotation

# Rotate every 90 days (recommended)
# 1. Generate new key in Volcengine console
# 2. Update environment/config
# 3. Verify new key works
# 4. Delete old key

⚙️ Configuration

Environment Variables

Configuration File

Location: ~/.volcengine/config.yaml

# api_key: "your-api-key"  # Recommended: use environment variable
base_url: "https://ark.cn-beijing.volces.com/api/v3"
timeout: 30
max_retries: 3
output_dir: "./output"

Priority Order

1. Environment variable ARK_API_KEY ⭐ Recommended
2. Project config .volcengine/config.yaml
3. Global config ~/.volcengine/config.yaml
4. Default values

💾 Data Persistence

Security Tips:

• Set config file permissions to 600
• Add .volcengine/ to .gitignore
• Clean up old history regularly

❌ Error Handling

📝 Example Workflows

🎨 Complete Image Generation Flow

1. Set API Key
   → export ARK_API_KEY="sk-xxx"

2. Generate Image
   → Generate an image: serene mountain lake at sunrise

3. Check Status
   → Check task status

4. Download Result
   → Download image to ./output/

🎬 Image-to-Video Pipeline

1. Generate Source Image
   → Generate an image: ancient temple in misty forest

2. Animate to Video
   → Generate video from image with slow camera push in

3. Monitor Progress
   → Check video generation status

4. Export Video
   → Download completed video

🐳 Deployment

📖 Detailed Guide: INSTALLATION.md

📚 Documentation

🆘 Get Help

# View help
./scripts/help.sh

# Verify installation
./scripts/verify_install.sh

Need more help? Say "help" or "帮助" for interactive assistance.

📄 License

MIT License - See LICENSE file

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md

📞 Support

• 🐛 Issue Tracker
• 💬 Discussions