uking-aigc

name	uking-aigc
description	虾盘云 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）。

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

# 文生图
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

# 文生视频
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」）。

文生图

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）

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

视频（提交 → 轮询 → 下载 三步）

# 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 格式。