专业 Logo 设计生成

技能文档

---
name: professional-logo-generation-showapi
title: 专业 Logo 设计生成
category: 内容创作
description: 根据主题、色彩与尺寸要求自动生成高清专业 Logo 图片，具备尺寸智能计算、专业提示词构建、高清大图生成、异步任务轮询与精准缩放裁剪能力。当用户需要设计品牌 Logo、制作企业标志、生成应用图标或个人头像等场景时触发。
---

# Logo设计

## 任务目标
- 根据输入的主题、颜色、尺寸要求，快速生成专业高清Logo图片
- 具备尺寸智能计算、专业提示词构建、高清大图生成、精准缩放裁剪能力
- 触发场景：设计品牌Logo、制作企业标志、生成应用图标、设计个人头像

## 能力组成

### 能力流程描述
该技能通过5个核心步骤完成专业Logo的生成：
1. **尺寸计算**：根据用户输入的目标尺寸（如256x512），计算等比例放大所需的高清大图尺寸与目标宽高。
2. **提示词构建**：将用户的主题（如"科技感星球"）和颜色（如"蓝色与银色"）转化为专业的Logo生图提示词。
3. **高清大图生成**：基于上一步的提示词和计算出的高清尺寸，调用图像生成大模型生成高清大图。
4. **状态轮询**：由于图像生成耗时较长，系统将自动每隔6秒轮询一次大图生成状态，直至任务成功（最长等待15分钟）。
5. **精准缩放**：将生成成功的高清大图精准缩放至用户期望的最终尺寸，输出最终的Logo图片URL。

## 前置准备
- 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
  - **获取方式**：访问 [https://www.showapi.com](https://www.showapi.com) 注册账号，登录后进入 [https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp) 获取 appKey
- 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
- 依赖：仅使用 Python 标准库，无需安装第三方包

## 技能工作流

### 模拟体验流程（无 appKey）
#### 步骤1：自动触发模拟调用
   系统检测到未配置 appKey 时，自动向 `https://www.showapi.com/_nuxt3/api/2405-105` 发送 POST 请求（body: `{"flow_id":"6a38f3773c51f2dc1a031877"}`），直接获取完整模拟生成结果。**此过程为一次性返回，不执行 execute_task.py 和 query_task.py。**

#### 步骤2：可视化预览
   将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现图片内容。

#### 步骤3：引导真实调用
   提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请前往 [ShowAPI](https://www.showapi.com) 注册账号，并在 [https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp) 获取 appKey。

### 标准流程（有 appKey，强制异步执行）
#### 步骤1：收集用户需求
   梳理用户的设计需求，明确Logo的核心元素/主题（如"科技感星球"）、主色调（如"蓝色与银色"）及目标尺寸（如256x256，选填，默认256x256）。

#### 步骤2：异步提交生成任务
   调用脚本异步执行Logo生成任务，**仅返回唯一 task_id**，不阻塞等待。
   调用示例：
   ```bash
   python scripts/execute_task.py --theme "科技感星球" --color "蓝色与银色" --size "256x256" --async
   ```

#### 步骤3：轮询查询任务结果（必选）
   使用 task_id 循环查询任务状态，**每一轮轮询后，即时将当前返回的核心资料同步反馈给用户**，直至获取完整结果。
   调用示例：
   ```bash
   python scripts/query_task.py --task-id "返回的task_id值"
   ```
4.等待结果完成
  必须轮询直到完成。

#### 步骤5：结果解析与落地应用
   提取最终Logo图片链接（final_logo_url）及高清大图链接（large_image_url），下载或直接应用于业务场景。

6. 生成html页面
   生成一个简单的html页面来融合返回的主要信息，特别是图片。

## 使用示例
### 示例1：企业科技Logo生成
- 输入：生成一个科技公司的Logo，主题是"云端数据"，颜色是"深蓝与亮白"
- 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
- 产出：一张高清科技感云端数据Logo图片链接
- 配置要点：size可使用默认256x256

### 示例2：长图尺寸Logo设计
- 输入：设计一个导航栏用的Logo，主题"极简山峰"，颜色"黑金"，尺寸要求宽度小高度大，如 256x512
- 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
- 产出：一张尺寸为256x512的极简山峰Logo
- 配置要点：size参数指定为256x512

### 示例3：App图标设计
- 输入：制作一个App图标，主题"可爱猫咪"，颜色"粉色与白色"
- 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
- 产出：符合App图标比例的猫咪Logo
- 配置要点：size参数指定为512x512

## 生成效果示例
### 描述
技能运行完成后，将返回包含最终Logo图片URL、高清原图URL及实际尺寸信息的JSON数据。图片可直接在浏览器中打开查看或下载使用。

### 输出案例
> 说明：若输出结果包含图片，**优先插入对应图片资源**，之后再输出 JSON 格式的文本内容。

![生成效果示例1](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a38f3773c51f2dc1a031877/snapshot/caseImgs/ce23147747.jpg?t=1782118926)
![生成效果示例2](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a38f3773c51f2dc1a031877/snapshot/caseImgs/bcf5aeb30b.jpg?t=1782118926)
![生成效果示例3](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a38f3773c51f2dc1a031877/snapshot/caseImgs/8e3e7e4c6b.jpg?t=1782118927)

```json
{
  "showapi_res_body": {
    "actual_size": "256x256",
    "large_image_url": "https://oss.showapi.com/temp/large_abc123.jpg",
    "final_logo_url": "https://oss.showapi.com/temp/final_def456.jpg"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 资源索引
- [scripts/execute_task.py](scripts/execute_task.py)：异步提交Logo生成任务（真实调用时使用）
- [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

## 响应数据结构
### 1. 异步任务提交响应
```json
{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

### 2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）
```json
{
  "showapi_res_body": {
    "actual_size": "256x256",
    "large_image_url": "高清大图URL（备用）",
    "final_logo_url": "最终符合用户尺寸要求的Logo图片URL"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 注意事项
1. theme(主题) 和 color(颜色) 为必填项，需清晰描述Logo的核心元素与主色调。
2. size(尺寸) 为选填项，格式需为 "宽x高"，如 "256x256"，默认值为 "256x256"。
3. 所有任务**强制异步执行**，不支持同步模式。
4. 轮询查询过程中，**每次获取接口返回数据后，立即将主要内容反馈给用户**。
#### 步骤5：模拟运行说明**：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请注册 ShowAPI 账号并配置 appKey。

使用说明

# 专业 Logo 设计生成

一句话：根据主题、色彩与尺寸要求生成高清专业 Logo，自动完成放大、生图、轮询与精准缩放。

## 使用

```bash
export showapi_appkey="your_key_here"   # 可选，未配置时走模拟体验
python scripts/execute_task.py --theme "科技感星球" --color "蓝色与银色" --size "256x256" --async
python scripts/query_task.py --task-id "<task_id>"
```

也可以直接对话：「帮我设计一个蓝色调的科技公司 Logo，256x256」。

## 工作原理

技能调用图像生成大模型：先按目标尺寸计算等比高清尺寸并构建专业生图提示词，异步提交生成任务后轮询至完成，最终将高清大图缩放裁剪为期望尺寸并输出图片链接。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。