Seedance-2.0-APIze: Local Seedance 2.0 API written in GO

Unofficial REST API wrapper for Dreamina / Seedance 2.0 — no official API needed.

Since ByteDance hasn't released a public API for Seedance 2.0 yet, this project reverse-wraps the Dreamina web UI using Playwright and exposes it as a clean REST API you can call from any language or tool.

Built by @trannghiach a.k.a @lilsadfoqs

---

How it works

POST /v1/videos/generations
        ↓
  Playwright controls Chromium
        ↓
  Dreamina UI generates video
        ↓
GET /v1/videos/{id}/download

No API keys from ByteDance needed. Just a Dreamina account.

---

Quickstart

Requirements:

• Go 1.22+
• A Dreamina account with an active plan or at least free trial at dreamina.capcut.com

Free accounts get ~225 credits/day. One 4s video costs ~140 credits.

git clone https://github.com/trannghiach/Seedance-2.0-APIze
cd Seedance-2.0-APIze
go mod tidy

# 1. Login once — saves session to .dreamina-session/
go run . login

# 2. Start the API server
go run . serve --port 8080

# 3. Generate a video
curl -X POST http://localhost:8080/v1/videos/generations \
  -F "prompt=a cat sitting on the cloud, cinematic"

# 3.6. Only if you need to verify the whole Playwright process
go run . test "me and the boys at the pool party flirting girls"

---

API Reference

POST /v1/videos/generations

Submit a video generation job. Returns immediately with a job ID.

Accepts multipart/form-data.

Fields:

Field	Type	Default	Options
prompt	string	required	—
model	string	seedance-2.0-fast	seedance-2.0, seedance-2.0-fast
mode	string	omni	omni, start-end
aspect_ratio	string	16:9	16:9, 9:16, 1:1, 4:3, 3:4, 21:9
duration	int	5	4 – 15
references	file(s)	—	omni mode only, max 9 files
start_frame	file	—	start-end mode only
end_frame	file	—	start-end mode only

Example — omni mode with references:

curl -X POST http://localhost:8080/v1/videos/generations \
  -F "prompt=cinematic scene" \
  -F "model=seedance-2.0" \
  -F "mode=omni" \
  -F "aspect_ratio=16:9" \
  -F "duration=12" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]"

Example — start-end mode:

curl -X POST http://localhost:8080/v1/videos/generations \
  -F "prompt=smooth transition between two scenes" \
  -F "model=seedance-2.0-fast" \
  -F "mode=start-end" \
  -F "aspect_ratio=9:16" \
  -F "duration=5" \
  -F "[email protected]" \
  -F "[email protected]"

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "created_at": 1234567890
}

---

GET /v1/videos/{id}

Poll job status.

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "done",
  "download_url": "/v1/videos/550e8400.../download",
  "created_at": 1234567890,
  "updated_at": 1234567950
}

Status	Meaning
pending	Queued, not started yet
processing	Dreamina is generating
done	Ready to download
failed	Generation failed — check error field

When failed, the response includes an error field explaining why:

{
  "status": "failed",
  "error": "face detected in reference images — Dreamina rejected the request"
}

---

GET /v1/videos/{id}/download

Download the generated .mp4 file.

curl http://localhost:8080/v1/videos/{id}/download -o video.mp4

---

GET /health

{"status": "ok"}

---

CLI Commands

# Login (run once per account)
go run . login

# Start API server (headless by default)
go run . serve --port 8080 --key mysecretkey

# Show browser window (useful for debugging)
go run . serve --port 8080 --show

# Quick test — generate 1 video from terminal
go run . test "a futuristic city at night"

# Test omni mode: seedance-2.0, 9 refs, 16:9, 12s
go run . test1

# Test start-end mode: seedance-2.0-fast, 9:16, 5s
go run . test2

---

Using an API key (Untested seriously, if you need this you can test it yourself and report any issues you got. Thanks :Đ)

go run . serve --port 8080 --key mysecretkey

curl -X POST http://localhost:8080/v1/videos/generations \
  -H "Authorization: Bearer mysecretkey" \
  -F "prompt=..."

---

Project structure

Seedance-2.0-APIze/
├── main.go              # Entry point: login / serve / test
├── browser/manager.go   # Playwright setup, persistent session
├── scraper/scraper.go   # UI automation — core logic
├── queue/queue.go       # Async job queue
└── server/server.go     # HTTP API server

---

Notes

• Session is saved to .dreamina-session/ — gitignored, never commit it
• Default concurrency is 1 (one video at a time) to avoid rate limiting and any further conflict issues
• Generation takes 3~5 minutes depending on Dreamina server load and queue position
• If Dreamina detects faces in reference images, the job will fail with a clear error message
• Tested on Windows

---

Disclaimer

This is an unofficial project not affiliated with ByteDance or Dreamina. It may break at any time if Dreamina updates their UI. Use at your own risk.

---

License

MIT