名字转艺术字 Skill
功能概述
使用百度星河社区 ERNIE-Image(文心图像大模型)API,将用户提供的姓名或文字生成为高质量的艺术字图片。支持中国风书法、烫金、霓虹、卡通、火焰、冰晶等多种风格。
前置条件
需要百度星河社区 Access Token:前往 https://aistudio.baidu.com/account/accessToken 获取。
执行流程
Step 1:确认 Access Token
优先检查是否已配置,按以下顺序:
- 用户本次提供的 Token(命令行
--token)
- 环境变量
AISTUDIO_ACCESS_TOKEN
- 配置文件
config.json(位于 skill 安装目录下)
若 Token 未配置,引导用户通过以下命令保存(只需一次):
python3 scripts/generate_art_name.py --set-token YOUR_TOKEN
Token 获取地址:https://aistudio.baidu.com/account/accessToken
Step 2:确认输入参数
向用户确认:
- 名字/文字:要生成的内容(必填)
- 风格:从预设风格中选择(默认中国风)
- 中国风、烫金、霓虹、卡通、石刻、玫瑰、极简、火焰、冰晶、自定义
- 输出目录(可选,默认
./art_names)
若用户描述不够具体,主动询问风格偏好。
Step 3:执行生成
调用核心脚本(路径相对于 skill 安装目录):
python3 scripts/generate_art_name.py \
--name "用户名字" \
--style 风格名称 \
--output 输出目录
常用参数:
| 参数 | 说明 |
|---|
--name / -n | 要生成的名字或文字(必填) |
--style / -s | 风格:中国风/烫金/霓虹/卡通/石刻/玫瑰/极简/火焰/冰晶/自定义 |
--prompt / -p | 自定义描述,配合 --style 自定义 使用 |
--output / -o | 图片保存目录 |
--token / -t | 临时指定 Access Token |
--model / -m | 模型选择(默认 ERNIE-Image-Turbo) |
--set-token | 将 Token 保存到配置文件(只需一次) |
--list-styles | 查看所有可用风格 |
--show-config | 查看当前配置 |
Step 4:展示结果
脚本成功执行后,生成的图片会保存到本地。使用 open_result_view 展示图片,并询问是否需要调整风格重新生成。
错误处理
| 错误 | 解决方案 |
|---|
| Token 无效 / 401 | 引导用户重新获取 Token 并用 --set-token 保存 |
| 网络超时 | 重试,或将 timeout 延长至 180 秒 |
| 内容审核拦截 | 调整 Prompt 表达方式,避免敏感词 |
| 模型不可用 | 切换为 ERNIE-Image 或 Stable-Diffusion-XL |
参考文档
详见 references/api_docs.md:包含完整 API 参数说明、Prompt 写作技巧和代码示例。
配置管理
配置文件 config.json 位于 skill 安装目录下,格式如下:
{
"access_token": "在这里填写你的 Access Token",
"model": "ERNIE-Image-Turbo",
"output_dir": "./art_names"
}
可直接编辑此文件,或用 --set-token 命令更新 Token。