# Uking Aigc

> 虾盘云 AI 作图与 AI 视频本地工具。当用户要画图/作图/文生图/图生图/改图/生成图片/配图/生成视频/文生视频/图生视频/做短视频时使用本技能。用 `node scripts/gen-image.mjs` 出图、`node scripts/gen-video.mjs` 出片，脚本输出本地文件路径（--json 出 {ok,file}）；没有 Node 时按文末「纯 curl 用法」手调。作图模型 gpt-image-2(默认)/seedream-4-0/wanx2.1-t2i-turbo，视频模型 veo-3.1-lite/fast/generate-001。端点 https://api.u-claw.org.cn，API Key 自动读 ~/.uking/device.json（也可 --key 或环境变量 XIAPAN_API_KEY）。

- Skill: `dongsheng123132/uking-aigc` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dongsheng123132/uking-aigc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dongsheng123132/uking-aigc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dongsheng123132 (https://skillmd.com/u/dongsheng123132)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dongsheng123132/uking-aigc

---


# U-King AIGC（AI 作图 + AI 视频）

虾盘云作图与视频的本地工具。两种用法：**① 有 Node 直接跑脚本**（推荐，已封装好异步轮询、下载、国内域名改写等坑）；**② 没 Node 照「纯 curl 用法」手调**。

## 何时用本技能

画图 / 作图 / 文生图 / 图生图 / 改图 / 生成图片 / 给文章配图 / 生成视频 / 文生视频 / 图生视频 / 做个短视频。

## API Key（通常无需手动给）

脚本按以下优先级取 Key：
1. 命令行 `--key sk-...`
2. 环境变量 `XIAPAN_API_KEY`
3. `~/.uking/device.json` 的 `key` 字段（装了 U-King 就有，设备专属、恒定）

没充值会报「余额不足 / Invalid token」，去 https://u-claw.org.cn/recharge 充值（¥1 ≈ 50 万 token）。

## 作图：scripts/gen-image.mjs

```bash
# 文生图
node scripts/gen-image.mjs --prompt "一只橘猫宇航员，电影感光影" --model gpt-image-2 --size 1024x1024 --out cat.png --json

# 图生图 / 改图（带参考图，--ref 可重复多张做融合）
node scripts/gen-image.mjs --prompt "把背景换成星空" --ref cat.png --out cat-space.png --json
```

参数：`--prompt`(必填) `--model`(默认 gpt-image-2) `--size`(1024x1024 | 1792x1024 | 1024x1792) `--ref`/`--image`(参考图，可重复) `--out`(默认 ./uking-image-<时间>.png) `--key` `--json`

输出（`--json`，stdout）：`{"ok":true,"file":"/abs/cat.png","model":"gpt-image-2","revised_prompt":"...","elapsed":"3.1s"}`

> 模型选择：`gpt-image-2` 最稳、改图/多图融合最强、直接回图（国内最可靠）；`seedream-4-0`/`wanx2.1-t2i-turbo` 偏国产风格，可能把图放在境外 CDN，下载需要 curl。

## 视频：scripts/gen-video.mjs

```bash
# 文生视频
node scripts/gen-video.mjs --prompt "橘猫在月球表面慢跑，星空背景" --model veo-3.1-lite-generate-001 --out cat.mp4 --json

# 图生视频（首帧图）
node scripts/gen-video.mjs --prompt "让这张图里的猫动起来" --image cat.png --out cat-anim.mp4 --json
```

参数：`--prompt`(必填) `--model`(默认 veo-3.1-lite-generate-001，最省≈¥1) `--image`(首帧图，可选) `--out`(默认 ./uking-video-<时间>.mp4) `--key` `--json`

视频是异步任务，脚本自动**轮询**（每 5 秒，最多 20 分钟）+ **下载**。进度走 stderr，结果走 stdout。

输出（`--json`）：`{"ok":true,"file":"/abs/cat.mp4","model":"...","task_id":"...","elapsed":"68s"}`

视频模型：`veo-3.1-lite-generate-001`(最省≈¥1) / `veo-3.1-fast-generate-001`(更细腻≈¥2.7) / `veo-3.1-generate-001`(最高清≈¥6.7)。

## 退出码

`0` 成功 · `1` 运行/网络错误 · `2` 参数错误。配合 `--json` 解析 stdout 的 `ok`/`file`/`error`。

## 纯 curl 用法（无 Node 时手调）

端点 `https://api.u-claw.org.cn`，鉴权 `Authorization: Bearer <KEY>`（KEY 见上「API Key」）。

### 文生图
```bash
curl -sS -m 180 -X POST https://api.u-claw.org.cn/v1/images/generations \
  -H "Authorization: Bearer $XIAPAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一只橘猫宇航员","n":1,"size":"1024x1024","response_format":"b64_json"}'
# 响应 data[0].b64_json 是 base64 PNG，base64 解码即图片。
# 若该模型只回 data[0].url，再下载（注意 --ssl-no-revoke）：
curl -sS -m 60 -L --ssl-no-revoke -o out.png "<那个 url>"
```

### 图生图（multipart，⚠️ 不要传 response_format）
```bash
curl -sS -m 180 -X POST https://api.u-claw.org.cn/v1/images/edits \
  -H "Authorization: Bearer $XIAPAN_API_KEY" \
  -F model=gpt-image-2 -F "prompt=把背景换成星空" -F n=1 -F size=1024x1024 -F image=@input.png
```

### 视频（提交 → 轮询 → 下载 三步）
```bash
# 1) 提交
curl -sS -m 60 -X POST https://api.u-claw.org.cn/v1/video/generations \
  -H "Authorization: Bearer $XIAPAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-lite-generate-001","prompt":"橘猫在月球慢跑"}'
# → {"task_id":"xxxxxx"}

# 2) 轮询（每 5 秒一次，直到 data.status 含 SUCCESS；含 FAIL/ERROR/CANCEL 则失败）
curl -sS -m 30 https://api.u-claw.org.cn/v1/video/generations/xxxxxx \
  -H "Authorization: Bearer $XIAPAN_API_KEY"
# → {"code":"success","data":{"status":"IN_PROGRESS|SUCCESS","progress":"50%","result_url":"https://api.u-claw.org/..."}}

# 3) 下载（把 result_url 的 api.u-claw.org 换成 api.u-claw.org.cn 再下）
curl -sS -m 300 -L --ssl-no-revoke -H "Authorization: Bearer $XIAPAN_API_KEY" -o out.mp4 "<result_url 改成 .org.cn>"
```

## 把本技能装进各 AI 工具

把整个 `uking-aigc/` 文件夹拷进对应目录，重启该工具即可：

- **Claude Code**：`~/.claude/skills/uking-aigc/`
- **OpenClaw / ClawX**：`~/.openclaw/skills/uking-aigc/`（便携版在 exe 同级 `data/.openclaw/skills/`）
- **Hermes**：`%LOCALAPPDATA%\hermes\skills\aigc\uking-aigc\`（Hermes 需要「分类 / 技能名」两层，故多套一层 `aigc/`）
- **其它工具**：放到它的技能 / skills 目录即可，本技能是通用 SKILL.md 格式。