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

codex-seedance-skill

★ 2 Open GitHub ↗

Codex skill for AI video generation via ByteDance Seedance 2.0 (doubao-seedance) and Volcano Ark API

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Seedance Skill for Codex

A [Codex](https://github.com/openai/codex) skill for AI video generation using ByteDance's **Seedance 2.0** (doubao-seedance) via Volcano Ark API.

## Features

- **Text-to-Video**: Generate videos from text prompts
- **Image-to-Video**: First-frame / first-last-frame control
- **Multi-modal**: Combine images, reference videos, and audio
- **Batch mode**: Generate multiple videos from a JSON config
- **Fast model**: `doubao-seedance-2-0-fast` for cheaper, faster generation
- **Draft mode**: Quick testing with minimal cost
- **Zero dependencies**: Python stdlib only — no pip install needed
- **Official prompt rules**: Built-in prompt engineering guide from Volcengine

## Prerequisites

1. A Volcano Engine (火山引擎) account with Ark API access
2. An API key from [Ark Console](https://console.volcengine.com/ark/)

## Installation

```bash
# Clone into your Codex skills directory
git clone https://github.com/YOUR_USERNAME/codex-seedance-skill.git $CODEX_HOME/skills/seedance
```

Or copy the `seedance/` folder into `~/.codex/skills/`.

## Quick Start

```powershell
# Set your API key
$env:ARK_API_KEY = "ark-xxxxxxxxx"

# Text-to-video
python scripts/seedance_api.py -p "A cat in a sunny garden, cinematic slow pan" -d 5

# Portrait mode for TikTok/Reels
python scripts/seedance_api.py -p "Product showcase" --portrait --resolution 1080p -d 10

# Fast + draft for cheap testing
python scripts/seedance_api.py -p "test prompt" --fast --draft -d 5

# Multi-modal: images + video + audio reference
python scripts/seedance_api.py -p "First-person tea ad..." --image https://.../pic1.jpg --video https://.../ref.mp4 --audio https://.../bgm.mp3 -d 11

# Check existing task
python scripts/seedance_api.py --query cgt-xxxxxxxxxxx

# Batch generation
python scripts/seedance_api.py --batch jobs.json
```

## Parameters

| Flag | Description |
|------|-------------|
| `-p, --prompt` | Video generation prompt |
| `-d, --duration` | Duration in seconds (4-15) |
| `--portrait` / `--landscape` / `--square` / `--ultrawide` | Ratio shortcuts |
| `--ratio` | Custom ratio: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive |
| `--resolution` | 480p, 720p, 1080p |
| `--fast` | Use fast (cheaper) model |
| `--draft` | Draft mode for testing |
| `--image` / `--video` / `--audio` | Reference media URLs |
| `--batch` | JSON batch config file |
| `--query` | Check existing task by ID |

## Models

| Model | ID | Max Resolution |
|-------|-----|---------------|
| Standard | `doubao-seedance-2-0-260128` | 1080p |
| Fast | `doubao-seedance-2-0-fast-260128` | 720p |

## Skill Structure

```
seedance/
├── SKILL.md                    # Codex skill definition
├── README.md                   # You are here
├── .gitignore
├── agents/
│   └── openai.yaml            # UI metadata
├── references/
│   ├── prompts.md             # Prompt engineering guide
│   └── sd2-pe-official.md     # Official Volcengine prompt skill
└── scripts/
    └── seedance_api.py        # API client (stdlib only)
```

## Official Docs

- [Seedance 2.0 API Reference](https://www.volcengine.com/docs/82379/2291680)
- [Volcano Ark Platform](https://www.volcengine.com/product/ark)

## License

MIT

codex-seedance-skill

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README