U-King AIGC(AI 作图 + AI 视频)
虾盘云作图与视频的本地工具。两种用法:① 有 Node 直接跑脚本(推荐,已封装好异步轮询、下载、国内域名改写等坑);② 没 Node 照「纯 curl 用法」手调。
何时用本技能
画图 / 作图 / 文生图 / 图生图 / 改图 / 生成图片 / 给文章配图 / 生成视频 / 文生视频 / 图生视频 / 做个短视频。
API Key(通常无需手动给)
脚本按以下优先级取 Key:
- 命令行
--key sk-... - 环境变量
XIAPAN_API_KEY ~/.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 格式。