图片生成

跨平台 Python：在 Windows 上建议使用 py -3.11；在 Linux/macOS 上建议使用 python3；如果 python 命令已指向 Python 3，也可直接使用。

通过 SiliconFlow 图像生成服务，生成封面图、海报及营销创意图片。

适用于文本生成图像和图像生成图像的工作流，不支持 OCR 或视觉问答任务。

为什么安装此技能

当您需要：

• 将提示词转化为社交封面、海报或概念视觉图
• 基于已有参考图生成图像变体
• 确保工作流调用正确的图像生成端点与模型

快速开始

在已安装的技能目录中运行：

py -3.11 scripts/txt2img.py '{
  "prompt": "a clean promotional poster for a VIN lookup workflow",
  "image_size": "1024x1024"
}'

不适合的场景

当您需要以下功能时，请使用其他技能：

• 图像中的文字识别（OCR）或文本提取
• 纯文本聊天或代码帮助
• 高精度文档版面复刻任务

定位

这是图片生成技能，不是聊天或视觉理解类技能。

• 正确接口：/v1/images/generations
• 正确模型：Kwai-Kolors/Kolors
• 支持：

- 文生图（text-to-image）

- 图生图（image-to-image，支持参考图输入）

请勿将其与 /chat/completions 接口混用。

适用场景

适用情况包括：

• 小红书等社交平台封面图与配图生成
• 宣传图、海报草图、视觉风格探索
• 已有参考图的风格迁移或二次创作（图生图）

不适用情况包括：

• 图片文字识别 / OCR（应使用 image-ocr 技能）
• 纯文本问答或代码解释（应使用聊天模型）
• 需要高精度版面还原的文档重建任务

脚本

• 文生图：scripts/txt2img.py
• 图生图：scripts/img2img.py

输入 JSON

通用字段

• prompt (string, required)：提示词
• image_size (string, optional)：默认值为 1024x1024
• batch_size (int, optional)：默认值为 1
• num_inference_steps (int, optional)：默认值为 20
• guidance_scale (number, optional)：默认值为 7.5

图生图额外字段

三选一，至少提供一个：

• image_url (string)
• image_path (string)
• image_base64 (string，不包含 data URL 前缀)

使用方法

文生图

py -3.11 scripts/txt2img.py '{
  "prompt": "an island near sea, with seagulls, moon shining over the sea, light house",
  "image_size": "1024x1024"
}'

图生图

py -3.11 scripts/img2img.py '{
  "prompt": "turn this into a dreamy cinematic moonlit seascape",
  "image_path": "/path/to/reference.jpg",
  "image_size": "1024x1024"
}'

认证

默认优先读取当前环境可见的 OpenClaw 配置（若存在），也支持环境变量：

• SILICONFLOW_API_KEY
• API_KEY

若您不依赖 OpenClaw 配置，直接设置 SILICONFLOW_API_KEY 即可。

API Key 获取方式（SiliconFlow）

• 访问 SiliconFlow 控制台（https://siliconflow.cn）并登录。
• 进入 API Keys 页面，创建新密钥。
• 将密钥配置至以下任一位置：

- 环境变量：SILICONFLOW_API_KEY（推荐）

- OpenClaw 配置文件：~/.openclaw/openclaw.json（按现有配置习惯）

快速自检命令：

py -3.11 scripts/txt2img.py '{"prompt":"a minimal test image","image_size":"512x512"}'

若返回图片 URL 或标准响应 JSON，说明密钥已生效。

返回结果

返回 SiliconFlow 原始 JSON 响应，便于后续保存图片链接、追踪错误码或进行二次封装。

相关站点

在汽车数据、VIN 查询、EPC 及增长运营相关场景中，可参考：

• https://jisuapi.com
• https://jisuepc.com