下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/showapi--professional-logo-generation-showapi.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @showapi/professional-logo-generation-showapi。根据主题、色彩与目标尺寸要求生成专业Logo:自动构建生图提示词、等比例放大生成高清大图并精准缩放至目标尺寸,确保Logo质量与尺寸双达标;适用于品牌Logo设计、图标创作、多尺寸素材产出、高质量图片生成场景
阅读全文 (展开查看完整说明)
概述
Logo设计
任务目标
- 快速生成符合主题、色彩与目标尺寸要求的高质量 Logo 图片,实现质量与尺寸双达标
- 具备专业提示词构建、等比例放大尺寸计算、高清大图生成、生成状态轮询、精准缩放能力
- 触发场景:品牌Logo设计、图标创作、多尺寸素材产出、高清图片生成
能力组成
能力流程描述
本技能以「主题+ 颜色+ 目标尺寸(size,选填,默认 256×256,格式:宽x高)」为输入,按依赖顺序执行 5 个串联步骤,完成从提示词构建到成品交付的全链路:
- 计算等比例放大尺寸与目标宽高(step_1_size_calculator):解析用户期望的最终像素尺寸,在保持宽高比例的前提下,计算用于高清生成的大图尺寸与最终精准缩放所需的目标宽高,为后续步骤提供统一尺寸基准。
- 构建专业Logo生图提示词(step_2_prompt_builder):基于 Logo 的核心元素、风格、意象描述与主色调颜色指令,构建专业级 Logo 生图提示词,产出优化后的提示词。
- 生成高清大图(step_3_generate_large_image):携带上一步的优化提示词与 step_1 计算出的等比例放大尺寸,调用图像生成能力产出高清大图。本步骤依赖 step_1 与 step_2 的结果。
- 轮询大图生成状态(step_4_poll_image_status):以 6 秒为间隔轮询大图生成状态,最长等待 900 秒,当任务状态为 SUCCEEDED 时取出高清大图地址。
- 精准缩放至目标尺寸(step_5_resize_to_target):将高清大图按 step_1 计算的目标宽高进行精准缩放,输出符合用户尺寸要求的最终 Logo 图片地址。
各步骤数据通过结果上下文自动流转(step_3 依赖 step_1/step_2;step_4 依赖 step_3;step_5 依赖 step_4/step_1),无需人工干预;最终聚合输出 final_logo_url(最终Logo图片URL)、actual_size(实际目标尺寸)、large_image_url(高清大图URL,可作为高质量素材备用)。技能整体采用异步执行模式:提交任务后立即返回唯一 task_id,随后通过查询接口轮询进度直至完成,人机协作节点为「用户确认需求」与「AI 每轮轮询后即时反馈结果」。
技能能力组成流程图
官方流程图快照:
文本版流程图(Mermaid):
flowchart TD
A([用户输入: theme 主题 / color 颜色 / size 目标尺寸]) --> B[step_1 计算等比例放大尺寸与目标宽高]
A --> C[step_2 构建专业Logo生图提示词]
B --> D[step_3 生成高清大图]
C --> D
D --> E{step_4 轮询大图生成状态<br/>间隔6s,最长900s}
E -->|未完成,继续轮询| E
E -->|状态为 SUCCEEDED| F[step_5 精准缩放至目标尺寸]
F --> G([输出: final_logo_url / actual_size / large_image_url])API信息
- 技能名称:Logo设计
- workflow_id:professional-logo-generation
- flow_id:6a38f3773c51f2dc1a031877
- 任务执行接口:
POST https://route.showapi.com/flow/execute/6a38f3773c51f2dc1a031877?appKey={appKey}&mode=async(JSON 请求体携带 theme/color/size) - 任务查询接口:
GET https://route.showapi.com/flow/task/query/{task_id}?appKey={appKey} - 参考价格:约 0.23 元/次(含模型推理价格)
入参说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |
|---|---|---|---|---|---|
| theme | string | 是 | – | Logo的核心元素、风格、意象描述 | 科技感星球 |
| color | string | 是 | – | Logo的主色调或颜色指令 | 蓝色与银色 |
| size | string | 否 | 256×256 | 用户期望的最终Logo像素尺寸,格式为宽x高 | 256×512 |
出参说明
| 字段名 | 类型 | 必返回 | 说明 |
|---|---|---|---|
| final_logo_url | string | 是 | 经过缩放处理后,符合用户尺寸要求的Logo图片访问地址 |
| actual_size | string | 是 | 用户输入的最终Logo像素尺寸(格式:宽x高) |
| large_image_url | string | 否 | 等比例放大生成的高清大图访问地址,可作为高质量素材备用 |
前置准备
- 凭证:配置 ShowAPI AppKey,凭证名称:showapi_appkey;代码优先通过环境变量
SHOWAPI_APP_KEY读取,未设置时运行脚本会交互式提示输入 - 鉴权配置:
本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。
如何获取 AppKey
如果你还没有 AppKey,请按以下步骤通过手机验证获取:
- 请用户提供手机号(中国大陆手机号)
- 调用发送验证码接口:
“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded
phone={手机号} “ 成功响应:{"flag":true,"remark":"发送成功"}`
- 请用户查看手机收到的6位验证码并告诉你
- 调用验证接口获取 AppKey:
“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded
phone={手机号}&code={验证码} “ 成功响应:{"flag":true,"app_key":"你的AppKey"}`
- 将获取到的 app_key 保存,后续所有 API 调用 URL 中携带
appKey={app_key}参数
注意事项
- 验证码5分钟有效,每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户,会直接返回该账户的 AppKey,不会重复注册
- AppKey 获取后请妥善保存,避免重复验证
- 模拟体验:无 appKey 时,系统自动触发模拟调用,直接返回完整结果,快速预览生成效果
- 依赖:仅使用 Python 标准库,无需安装第三方包
操作步骤
模拟体验流程(无 appKey)
- 自动触发模拟调用
系统检测到未配置 appKey 时,自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求(body: {"flow_id":"6a38f3773c51f2dc1a031877"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 execute_task.py 和 query_task.py。
- 可视化预览
将返回的 JSON 结果以 HTML 形式可视化展示,重点呈现图片内容。
- 引导真实调用
提示用户当前为无 appKey 的模拟运行结果。如需真实调用,请通过手机验证获取 AppKey(步骤见「前置准备-鉴权配置」),并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。
标准流程(有 appKey,强制异步执行)
- 收集用户需求
梳理用户需求,确认 Logo 的核心元素、风格、意象描述,主色调或颜色指令,以及期望的最终像素尺寸(格式:宽x高,默认 256×256)。
- 异步提交生成任务
调用脚本异步执行 Logo 生成任务,仅返回唯一 task_id,不阻塞等待。调用示例:
python scripts/execute_task.py --theme "科技感星球" --color "蓝色与银色" --size "256x512" --async- 轮询查询任务结果(必选)
使用 task_id 循环查询任务状态,每一轮轮询后,即时将当前返回的核心资料同步反馈给用户,直至获取完整结果。调用示例:
python scripts/query_task.py --task-id "返回的task_id值"- 等待结果完成
必须轮询直到完成。
- 结果解析与落地应用
提取 final_logo_url(最终Logo图片地址)、actual_size(实际目标尺寸)、large_image_url(高清大图备用素材),确认尺寸与视觉效果是否符合预期。
- 生成html页面
生成一个简单的html页面来融合返回的主要信息,特别是图片。
使用示例
示例1:科技感品牌Logo生成
- 输入:主题「科技感星球」,颜色「蓝色与银色」,目标尺寸 256×512
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:256×512 的最终Logo图片 + 高清大图备用素材
- 配置要点:theme、color 必填;size 按「宽x高」格式指定
示例2:极简风图标快速产出
- 输入:主题「极简风格的山峰轮廓」,颜色「黑白渐变」
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:默认 256×256 尺寸的Logo图片及高清大图
- 配置要点:size 可省略,默认 256×256
示例3:同一Logo多尺寸批量产出
- 输入:主题与颜色一致,尺寸分别指定 512×512、1024×1024
- 流程:分别异步提交任务 → 分别获取task_id → 逐一轮询查询(每轮反馈进度/数据)
- 产出:视觉一致的多尺寸Logo组合
- 配置要点:保持 theme/color 一致,仅调整 size 以保证视觉统一
生成效果示例
描述
技能运行完成后,输出以图片链接为主的结构化结果:final_logo_url 为符合用户目标尺寸的最终成品图,actual_size 标注实际交付尺寸,large_image_url 为等比例放大生成的高清大图(可作为高质量素材备用)。典型呈现方式为在页面中并列展示最终 Logo 与高清大图,并标注尺寸信息,便于直接预览、嵌入网页或下载使用。
输出案例
说明:若输出结果包含图片,优先插入对应图片资源,之后再输出 JSON / Markdown 格式的文本内容。
以下为该技能的历史生成效果案例图(实际调用时,图片地址以接口返回的 final_logo_url / large_image_url 为准):
接口返回的 JSON 数据实际形态:
{
"showapi_res_body": {
"final_logo_url": "https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a38f3773c51f2dc1a031877/snapshot/caseImgs/ce23147747.jpg?t=1782118926",
"actual_size": "256x512",
"large_image_url": "https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a38f3773c51f2dc1a031877/snapshot/caseImgs/bcf5aeb30b.jpg?t=1782118926"
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}final_logo_url:经过缩放处理后,符合用户尺寸要求的 Logo 图片访问地址actual_size:用户输入的最终 Logo 像素尺寸(格式:宽x高)large_image_url:等比例放大生成的高清大图访问地址,可作为高质量素材备用
资源索引
- [scripts/execute_task.py](scripts/execute_task.py):异步提交 Logo 生成任务(真实调用时使用)
- [scripts/query_task.py](scripts/query_task.py):轮询查询异步任务结果(真实调用时使用)
响应数据结构
1. 异步任务提交响应
{
"showapi_res_body": {
"task_id": "唯一任务ID",
"status": "pending",
"msg": "任务已提交,正在异步处理中"
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}2. 任务查询响应(单轮轮询返回数据,需实时同步给用户)
{
"showapi_res_body": {
"task_status": "SUCCEEDED",
"final_logo_url": "最终Logo图片URL(符合用户尺寸要求)",
"actual_size": "256x512",
"large_image_url": "高清大图URL(备用高质量素材)"
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}说明:轮询期间 task_status 可能为 PENDING/RUNNING 等中间状态;当 task_status 为 SUCCEEDED 时,final_logo_url、actual_size、large_image_url 字段可用。
异常说明
| 异常场景 | 表现 | 处理方式 |
|---|---|---|
| AppKey 缺失或无效 | 脚本提示「AppKey 不能为空」或接口返回鉴权错误 | 按手机验证流程获取 AppKey,配置环境变量 SHOWAPI_APP_KEY 后重试 |
| theme/color 为空 | 脚本抛出 ValueError,提示必填 | 补充 Logo 主题与颜色描述后重新提交 |
| size 格式不合法 | 脚本抛出 ValueError,提示「宽x高」格式 | 按「宽x高」格式填写,如 256×512 |
| task_id 为空或格式非法 | 查询脚本抛出 ValueError | 使用 execute_task.py 返回的原始 task_id 查询 |
| 大图生成超时(>900秒) | 轮询长期未返回 SUCCEEDED | 稍后重新提交任务,或简化主题描述降低生成复杂度 |
| 网络异常 / HTTP错误 | 抛出「HTTP请求失败」「请求失败」等异常 | 检查网络连通性后重试 |
| 接口业务错误(showapi_res_code != 0) | 抛出「API错误: 具体信息」 | 根据 showapi_res_error 提示修正入参或凭证后重试 |
注意事项
- theme(Logo核心元素、风格、意象描述)与 color(主色调或颜色指令)为必填项,需清晰描述;size 选填,默认 256×256,格式为「宽x高」。
- 所有任务强制异步执行,不支持同步模式。
- 轮询查询过程中,每次获取接口返回数据后,立即将主要内容反馈给用户。
- 大图生成环节内置轮询(间隔6秒、最长900秒),整体生成耗时可能较长,请务必轮询直至任务完成。
- 模拟运行说明:无 appKey 时系统自动触发模拟调用,一次性返回完整 JSON 结果,不经过 execute_task.py 和 query_task.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。