# xSkill AI

AI content generation toolkit with 50+ models. Image/video generation (Seedance 2.0, FLUX, Kling, Sora), TTS, voice cloning, and more.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add hexiaochun/xskill-ai

# Browse available tools
npx -y @smithery/cli@latest tool list hexiaochun/xskill-ai

# Get full schema for a tool
npx -y @smithery/cli@latest tool get hexiaochun/xskill-ai list_models

# Call a tool
npx -y @smithery/cli@latest tool call hexiaochun/xskill-ai list_models '{}'
```

## Direct MCP Connection

Endpoint: `https://xskill-ai--hexiaochun.run.tools`

**Required config:**
- `apiKey` (header) — Bearer token. Format: Bearer sk-xxx. Get key at https://xskill.ai

## Tools (19)

- `list_models` — 获取所有可用的 AI 生成模型列表，包括图像生成、视频生成等模型
- `get_model_info` — 获取指定模型的详细信息，包括参数要求和 Schema。调用 submit_task 前应先调用此工具了解参数要求
- `submit_task` — 提交 AI 生成任务。需要指定模型 ID 和对应参数，参数要求可通过 get_model_info 获取
- `get_task` — 查询单个任务的状态和结果
- `list_tasks` — 查询任务列表，支持按状态和模型筛选
- `get_balance` — 获取当前用户的账户余额。返回积分数量和对应的人民币金额（1积分=0.01元）
- `daily_check_in` — 每日签到领取积分奖励。根据会员等级不同，赠送不同积分：非会员10积分，VIP1会员20积分，VIP2会员30积分。每日只能签到一次
- `parse_video` — 解析视频分享链接，获取无水印视频下载地址。支持抖音、快手、小红书、B站、微博等平台。此工具免费使用，无需认证
- `upload_image` — 上传图片到云存储，返回公开访问 URL。支持两种方式：1) 提供 Base64 编码的图片数据；2) 提供网络图片 URL 进行转存。此工具免费使用，适合将本地图片转换为可访问的 URL 链接
- `list_voices` — 获取可用的音色列表，包括系统音色和用户创建的克隆/设计音色。系统音色可直接使用，用户音色需先创建
- `text_to_audio` — 语音合成 - 将文本转换为语音。需要先通过 list_voices 获取可用的音色ID。按字符数计费：HD模型 3.5元/万字符，Turbo模型 2元/万字符（1汉字=2字符，英文/标点=1字符）
- `voice_design` — 语音设计 - 用自然语言描述创建自定义音色。无需上传音频，直接用文字描述想要的声音特征。费用：首次使用该音色时收取 9.9元（990积分），试听按字符计费（2元/万字符）。创建的音色有效期7天
- `voice_clone` — 声音克隆 - 通过音频样本创建克隆音色。需要先通过 upload_audio 上传音频获取 file_id。费用：首次使用该音色时收取 9.9元（990积分），试听按所选模型收费。创建的音色有效期7天
- `upload_audio` — 上传音频文件到 Minimax 平台，用于声音克隆。支持 mp3/m4a/wav 格式，最大 20MB。返回 file_id 用于后续克隆操作。此工具免费使用
- `sync_generate_image` — 同步图像生成 - 直接返回生成结果，支持文生图和图生图。所有即梦模型都支持图生图（提供image_url即可）。耗时约30-70秒
- `sync_generate_video` — 同步视频生成 - 直接返回生成结果。支持文生视频、图生视频、首尾帧视频。耗时约60-160秒。使用即梦3.5 Pro系列模型
- `list_sync_models` — 获取支持同步调用的模型列表，包含价格信息
- `list_points_packages` — 获取积分充值套餐列表。返回所有可购买的积分套餐，包含套餐ID、价格（元）、积分数量等信息。用户选择套餐后，使用 create_payment_qrcode 工具传入套餐ID生成 Stripe 支付链接
- `create_payment_qrcode` — 为选定的积分套餐生成 Stripe 支付链接。传入套餐ID，返回支付页面URL，用户点击链接即可在 Stripe 托管页面完成支付（支持信用卡、微信支付、支付宝等）。支付成功后积分自动到账

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get hexiaochun/xskill-ai <tool-name>
```
