KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

seedance2.0_api_web_interface_Lite

★ 11 Open GitHub ↗

A seedance2.0 api web interface

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Seedance 2.0 AI Video Generation Workbench (Lite Open Source)

[![FastAPI](https://img.shields.io/badge/FastAPI-0.135.3-teal.svg?style=flat&logo=fastapi)](https://fastapi.tiangolo.com)
[![Python](https://img.shields.io/badge/Python-3.12+-blue.svg?style=flat&logo=python)](https://www.python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/LICENSE)

[中文版](./README_CN.md) | **English Version**

A private-deployable, lightweight AI video generation workbench built on **Seedance 2.0**. This Lite open-source version uses local **SQLite3** for data persistence and supports multi-modal reference inputs with zero mandatory cloud dependencies. OSS is optional — reference images work out of the box without any cloud storage.

---

## Lite vs Pro

| Feature | Lite (Open Source) | Pro |
|---------|:-----------------:|:---:|
| Seedance 2.0 video generation | ✅ | ✅ |
| Conversation-based workflow | ✅ | ✅ |
| Media library | ✅ | ✅ |
| Local SQLite storage | ✅ | ✅ |
| OSS-free local mode (reference images) | ✅ | ✅ |
| Reference video / reference audio | Requires OSS | ✅ |
| Multi-user / Workspaces | ❌ | ✅ |
| User quota management | ❌ | ✅ |
| Supabase cloud database | ❌ | ✅ |
| ByteDance real-person asset library | ❌ | ✅ |
| REST API access | ❌ | ✅ |

> Need the Pro version (multi-user, quota management, Supabase)? Contact: giordanoshai@gmail.com
---
## deamon
>Lite:https://sd-lite.smartled.cc    non-api
>Pro:https://sd.xinrentong.com       with seedance api

---
## 📸 Screenshots

### Lite Version

#### Main Interface
![Main Interface](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/main.png)

#### Conversations & History
![History](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/history.png)

#### Media Library
![Media Library](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/media.png)

### Pro Version Preview

#### Home
![Pro Home](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/pro_home.png)

#### Media Library
![Pro Media Library](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/pro_medialib.png)

#### User Management
![Pro User Management](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/pro_user.png)

#### Admin Panel
![Pro Admin Panel](https://raw.githubusercontent.com/giordanoshai/seedance2.0_api_web_interface_Lite/master/screenshot/pro_admin.png)

---

## ✨ Features

- 🚀 **Model Support**: Full support for Seedance 2.0 multi-modal protocols (image, video, audio references).
- 💾 **Local Storage**: Lightweight SQLite3 database — no complex infrastructure required.
- ☁️ **OSS Optional**: Without OSS, the app automatically switches to local mode — reference images are sent as base64 directly to the API. Zero barrier to getting started.
- 🖼️ **Auto Preview**: Automatically extracts keyframes and generates thumbnails for all generated videos.
- 🔄 **Async Processing**: Built-in background worker polls task status and saves results to local storage.
- ⚡ **Lightweight**: Single-user mode, no login required, ready out of the box.

---

## 🛠️ Installation & Deployment

### 1. Prerequisites
- Python 3.12+
- **FFmpeg** installed and added to your system PATH (required for video metadata and thumbnail extraction).

### 2. Clone the Repository
```bash
git clone https://github.com/your-username/seedance2.0_api_web_Lite.git
cd seedance2.0_api_web_Lite
```

### 3. Create Virtual Environment & Install Dependencies
```bash
python -m venv .venv

# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install aiosqlite fastapi httpx jinja2 oss2 pillow pydantic python-dotenv python-multipart uvicorn[standard]
```

### 4. Configure .env

Copy `.env.example` to `.env` and fill in the required fields:

```bash
# Required: Volcengine API Key
SEEDANCE20_KEY=Your_Seedance2.0_Key

# Optional: Alibaba Cloud OSS (leave empty to use local mode)
OSS_KEY_ID=
OSS_ACCESSKEY=
OSS_BUCKET_NAME=
```

#### Two Operating Modes

| Mode | Trigger | Reference Image | Reference Video | Reference Audio |
|------|---------|:--------------:|:---------------:|:---------------:|
| **Local mode** (default) | Leave OSS fields empty | ✅ sent as base64 | ❌ | ❌ |
| **OSS mode** | Fill in OSS_KEY_ID / OSS_ACCESSKEY / OSS_BUCKET_NAME | ✅ | ✅ | ✅ |

> Modes are detected automatically — no manual switch needed.

---

## 🚀 Running the App

```bash
python main.py
# or
uvicorn main:app --host 127.0.0.1 --port 8001 --reload
```

Default URL: `http://127.0.0.1:8001`

---

## 📁 Project Structure

```text
├── app/
│   ├── routers/          # API Routes (task creation, status query, media lib)
│   ├── static/           # Frontend UI (HTML/JS/CSS)
│   ├── template/         # Jinja2 Templates
│   ├── config.py         # Config module (auto OSS_ENABLED detection)
│   ├── database.py       # SQLite3 interactions
│   ├── oss_client.py     # Dual-mode storage (OSS / local + base64)
│   ├── task_worker.py    # Background polling worker
│   └── volcano_api.py    # Volcengine API wrapper
├── data/                 # SQLite database
├── outputs/              # Local videos, thumbnails, and uploaded assets
├── screenshot/           # UI screenshots
├── main.py               # Entry point
└── .env.example          # Configuration template
```

---

## 🤝 Contribution & Feedback

If you find this project helpful, please give it a Star or submit a Pull Request.

---

## ⚠️ Disclaimer

This project is developed based on Volcengine and Seedance APIs. All generative rights belong to the respective creators. Please comply with relevant laws and platform terms during use.

seedance2.0_api_web_interface_Lite

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README