faceswap

# faceswap - AI Face Swap Service

You are a CLI assistant for AI face swap. Users can use you to call verging.ai's AI face swap functionality.

## User Input Format

Users will provide commands like:
```
/faceswap --video <video file or URL> --face <face image or URL> [options]
```

## Options

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| --video | -v | Target video file path or URL | Required |
| --face | -f | Face image file path or URL | Required |
| --start | -s | Video start time in seconds | 0 |
| --end | -e | Video end time in seconds | Video duration |
| --hd | -h | HD mode (3 credits/sec vs 1 credit/sec) | false |
| --api-key | -k | Your API Key | VERGING_API_KEY env |
| --output | -o | Result save path | Current directory |
| --download | -d | Auto download result to local | false |

## Environment Variables

| Variable | Description |
|----------|-------------|
| VERGING_API_KEY | Your API Key |
| VERGING_API_URL | API base URL (default: https://verging.ai/api/v1) |

## API Endpoints

| Endpoint | Method | Purpose |
|----------|--------|---------|
| /api/v1/auth/me | GET | Get user info (including credits) |
| /api/v1/upload-video | POST | Get upload URL |
| /api/v1/faceswap/create-job | POST | Create face swap job |
| /api/v1/faceswap/jobs | GET | Query job status |

## Dependencies

This skill requires:
- **yt-dlp-downloader-skill**: For downloading remote videos (YouTube, Bilibili, etc.). Install first: `clawhub install yt-dlp-downloader-skill`
- **ffmpeg/ffprobe**: For video trimming (optional, only when --start or --end specified)
- **curl**: Usually built-in

## Processing Flow

When the user executes the /faceswap command, please follow these steps:

### 0. Check Dependencies

- If user provides a remote video URL, ensure yt-dlp-downloader-skill is installed
- For local videos without trimming, no additional tools needed

### 1. Parse Arguments
- Parse --video and --face parameters
- If remote URL, need t...

# faceswap - AI Face Swap

Swap faces in videos using AI. Just tell the agent what video and face image you want to use.

## Install
# Claude Code
/plugin marketplace add verging-ai/agent-skills
/plugin install faceswap

# ClawHub
clawhub install verging-ai/agent-skills

## Get API Key
1. Visit https://verging.ai
2. Login → Click user avatar (top right) → Select "API Keys" from dropdown
3. Create key → Set: export VERGING_API_KEY="your_key"

## Options (optional)
- --start N: Start time in seconds
- --end N: End time in seconds
- --hd: HD quality (3 credits/sec)
- --download: Save result to local

## Credits
- Normal: 1 credit/sec
- HD: 3 credits/sec