ai-photo-pro

通过命令行或 Python 导入调用两个远端文生图 API（NVIDIA NIM 的 flux.2-klein-4b、SiliconFlow 的 Kolors 与 Qwen-Image），接收中文提示词与可选负面提示词，按默认 1024×1024 生成 PNG 并返回图片保存路径，首次使用需先配置 API Key。

lianghaoxun

热度 33.82

最近更新 2026-05-11 17:46:09

分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：图像生成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ai-photo-pro

Metadata

name: ai-photo-pro
version: 2.0.0
description: 通过 NVIDIA NIM API 或 SiliconFlow API 生成图片。支持 Kolors (快手可图)、Qwen-Image (通义千问)、flux.2-klein-4b 等模型。当用户要求"生成图片"、"画一张图"、"AI绘图"或类似表达时调用。支持中文提示词，返回图片文件路径。

AiPhotoPro - AI 图片生成工具

支持双引擎：NVIDIA NIM API（flux.2-klein-4b）和 SiliconFlow API（Kolors / Qwen-Image）。

调用方式

命令行（推荐）

# SiliconFlow - 可图 Kolors（默认）
python /home/ubuntu/.openclaw/skills/ai-photo-pro/scripts/siliconflow_main.py "<提示词>" ["<负面提示词>"]

# SiliconFlow - 通义千问 Qwen-Image（付费模型，建议按需选取）
python /home/ubuntu/.openclaw/skills/ai-photo-pro/scripts/siliconflow_main.py "<提示词>" ["<负面提示词>"] --model Qwen/Qwen-Image

# NVIDIA NIM API - flux.2-klein-4b
python /home/ubuntu/.openclaw/skills/ai-photo-pro/scripts/nvid_main.py "<提示词>"

Python 导入

import sys
sys.path.insert(0, '/home/ubuntu/.openclaw/skills/ai-photo-pro/scripts')

# SiliconFlow
from siliconflow_main import generate_png
img_list = generate_png(model="Kwai-Kolors/Kolors", base_str="<提示词>", negative_prompt="<负面提示词>")

# NVIDIA
from nvid_main import run_pngvidapi
img_path = run_pngvidapi(model="flux.2-klein-4b", base_str="<提示词>")

参数说明

SiliconFlow `generate_png()`

参数	类型	必填	说明
`model`	string	❌	模型名，默认 `Kwai-Kolors/Kolors`，可选 `Qwen/Qwen-Image`（付费模型，建议按需选取）
`base_str`	string	✅	中文提示词
`negative_prompt`	string	❌	负面提示词，可空
`batch_size`	int	❌	批量大小，默认 1
`num_inference_steps`	int	❌	推理步骤数，默认 20
`guidance_scale`	float	❌	提示词匹配度，默认 2.5

NVIDIA `run_pngvidapi()`

参数	类型	必填	说明
`model`	string	✅	固定填 `flux.2-klein-4b`
`base_str`	string	✅	中文提示词

输出

图片保存路径：/home/ubuntu/.openclaw/skills/ai-photo-pro/scripts/img_data/<model>_<timestamp>.png
函数返回值为图片路径列表

API Key 配置

首次使用需配置 API Key，运行交互式配置脚本：

python /home/ubuntu/.openclaw/skills/ai-photo-pro/scripts/config_json.py

或手动写入 config.json（位于 scripts/ 目录）：

{
  "NVID": "nvapi-你的NVID密钥",
  "SILICONFLOW": "sk-你的SiliconFlow密钥"
}

获取 Key

NVID API Key: https://nim.nvidia.com/ 注册获取
SiliconFlow API Key: https://cloud.siliconflow.cn/i/IOo0eaWy 注册获取

示例提示词

人物：

一位美丽的短发东亚女性坐在高层公寓的落地窗前,身穿紧身的白色衬衫,(光线是午后柔和的定向自然光,在人物身上形成优美的明暗轮廓),脸上带着温暖而亲密的微笑,皮肤毛孔清晰,虹膜清晰锐利

物体/场景：

一个小苹果，红彤彤的，挂在绿叶树枝上，阳光照射，背景是模糊的果园，摄影风格，高清细节

风格化：

赛博朋克城市夜景，霓虹灯光，雨后街道，反射，高对比度，电影感

注意事项

SiliconFlow 默认尺寸 1024×1024，steps=20
NVIDIA 默认尺寸 1024×1024，steps=4（更快）
生成失败 SiliconFlow 会抛出异常；NVIDIA 会自动重试最多 5 次
图片路径通过函数返回值传递，方便 agent 捕获并发送