Agent Skill

Logo设计-万维易源

根据主题、色彩与目标尺寸要求生成专业Logo:自动构建生图提示词、等比例放大生成高清大图并精准缩放至目标尺寸,确保Logo质量与尺寸双达标;适用于品牌Logo设计、图标创作、多尺寸素材产出、高质量图片生成场景

设计多媒体·万维易源·来自 skill_hub·skillhub.cn ↗
skillhub install @showapi/professional-logo-generation-showapi
2 Stars·2.9万 综合热度·6,271 字文档·源站更新 2026-10-30

README 文档

6,271 字

Logo设计

任务目标

  • 快速生成符合主题、色彩与目标尺寸要求的高质量 Logo 图片,实现质量与尺寸双达标
  • 具备专业提示词构建、等比例放大尺寸计算、高清大图生成、生成状态轮询、精准缩放能力
  • 触发场景:品牌Logo设计、图标创作、多尺寸素材产出、高清图片生成

能力组成

能力流程描述

本技能以「主题+ 颜色+ 目标尺寸(size,选填,默认 256x256,格式:宽x高)」为输入,按依赖顺序执行 5 个串联步骤,完成从提示词构建到成品交付的全链路:

  1. 计算等比例放大尺寸与目标宽高(step1size_calculator):解析用户期望的最终像素尺寸,在保持宽高比例的前提下,计算用于高清生成的大图尺寸与最终精准缩放所需的目标宽高,为后续步骤提供统一尺寸基准。
  2. 构建专业Logo生图提示词(step2prompt_builder):基于 Logo 的核心元素、风格、意象描述与主色调颜色指令,构建专业级 Logo 生图提示词,产出优化后的提示词。
  3. 生成高清大图(step3generatelargeimage):携带上一步的优化提示词与 step1 计算出的等比例放大尺寸,调用图像生成能力产出高清大图。本步骤依赖 step1 与 step_2 的结果。
  4. 轮询大图生成状态(step4pollimagestatus):以 6 秒为间隔轮询大图生成状态,最长等待 900 秒,当任务状态为 SUCCEEDED 时取出高清大图地址。
  5. 精准缩放至目标尺寸(step5resizetotarget):将高清大图按 step_1 计算的目标宽高进行精准缩放,输出符合用户尺寸要求的最终 Logo 图片地址。

各步骤数据通过结果上下文自动流转(step3 依赖 step1/step2;step4 依赖 step3;step5 依赖 step4/step1),无需人工干预;最终聚合输出 finallogourl(最终Logo图片URL)、actualsize(实际目标尺寸)、largeimageurl(高清大图URL,可作为高质量素材备用)。技能整体采用异步执行模式:提交任务后立即返回唯一 taskid,随后通过查询接口轮询进度直至完成,人机协作节点为「用户确认需求」与「AI 每轮轮询后即时反馈结果」。

技能能力组成流程图

官方流程图快照:

Logo设计技能流程图

文本版流程图(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 元/次(含模型推理价格)

入参说明

参数名类型必填默认值说明示例
themestring是-Logo的核心元素、风格、意象描述科技感星球
colorstring是-Logo的主色调或颜色指令蓝色与银色
sizestring否256x256用户期望的最终Logo像素尺寸,格式为宽x高256x512

出参说明

字段名类型必返回说明
finallogourlstring是经过缩放处理后,符合用户尺寸要求的Logo图片访问地址
actual_sizestring是用户输入的最终Logo像素尺寸(格式:宽x高)
largeimageurlstring否等比例放大生成的高清大图访问地址,可作为高质量素材备用

前置准备

  • 凭证:配置 ShowAPI AppKey,凭证名称:showapiappkey;代码优先通过环境变量 SHOWAPIAPP_KEY 读取,未设置时运行脚本会交互式提示输入
  • 鉴权配置:

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey,请按以下步骤通过手机验证获取:

  1. 请用户提供手机号(中国大陆手机号)
  2. 调用发送验证码接口:
     POST https://www.showapi.com/auth/agent_sendCode
     Content-Type: application/x-www-form-urlencoded

     phone={手机号}

成功响应:{"flag":true,"remark":"发送成功"}

  1. 请用户查看手机收到的6位验证码并告诉你
  2. 调用验证接口获取 AppKey:
     POST https://www.showapi.com/auth/agent_verify
     Content-Type: application/x-www-form-urlencoded

     phone={手机号}&code={验证码}

成功响应:{"flag":true,"app_key":"你的AppKey"}

  1. 将获取到的 appkey 保存,后续所有 API 调用 URL 中携带 appKey={appkey} 参数

注意事项

  • 验证码5分钟有效,每分钟只能发送1次
  • 如果手机号已注册过易源数据平台账户,会直接返回该账户的 AppKey,不会重复注册
  • AppKey 获取后请妥善保存,避免重复验证
  • 模拟体验:无 appKey 时,系统自动触发模拟调用,直接返回完整结果,快速预览生成效果
  • 依赖:仅使用 Python 标准库,无需安装第三方包

操作步骤

模拟体验流程(无 appKey)

  1. 自动触发模拟调用

系统检测到未配置 appKey 时,自动向 https://www.showapi.com/nuxt3/api/2405-105 发送 POST 请求(body: {"flowid":"6a38f3773c51f2dc1a031877"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 executetask.py 和 querytask.py。

  1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示,重点呈现图片内容。

  1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用,请通过手机验证获取 AppKey(步骤见「前置准备-鉴权配置」),并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程(有 appKey,强制异步执行)

  1. 收集用户需求

梳理用户需求,确认 Logo 的核心元素、风格、意象描述,主色调或颜色指令,以及期望的最终像素尺寸(格式:宽x高,默认 256x256)。

  1. 异步提交生成任务

调用脚本异步执行 Logo 生成任务,仅返回唯一 task_id,不阻塞等待。 调用示例:

   python scripts/execute_task.py --theme "科技感星球" --color "蓝色与银色" --size "256x512" --async
  1. 轮询查询任务结果(必选)

使用 task_id 循环查询任务状态,每一轮轮询后,即时将当前返回的核心资料同步反馈给用户,直至获取完整结果。 调用示例:

   python scripts/query_task.py --task-id "返回的task_id值"
  1. 等待结果完成

必须轮询直到完成。

  1. 结果解析与落地应用

提取 finallogourl(最终Logo图片地址)、actualsize(实际目标尺寸)、largeimage_url(高清大图备用素材),确认尺寸与视觉效果是否符合预期。

  1. 生成html页面

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

使用示例

示例1:科技感品牌Logo生成

  • 输入:主题「科技感星球」,颜色「蓝色与银色」,目标尺寸 256x512
  • 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
  • 产出:256x512 的最终Logo图片 + 高清大图备用素材
  • 配置要点:theme、color 必填;size 按「宽x高」格式指定

示例2:极简风图标快速产出

  • 输入:主题「极简风格的山峰轮廓」,颜色「黑白渐变」
  • 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
  • 产出:默认 256x256 尺寸的Logo图片及高清大图
  • 配置要点:size 可省略,默认 256x256

示例3:同一Logo多尺寸批量产出

  • 输入:主题与颜色一致,尺寸分别指定 512x512、1024x1024
  • 流程:分别异步提交任务 → 分别获取task_id → 逐一轮询查询(每轮反馈进度/数据)
  • 产出:视觉一致的多尺寸Logo组合
  • 配置要点:保持 theme/color 一致,仅调整 size 以保证视觉统一

生成效果示例

描述

技能运行完成后,输出以图片链接为主的结构化结果:finallogourl 为符合用户目标尺寸的最终成品图,actualsize 标注实际交付尺寸,largeimage_url 为等比例放大生成的高清大图(可作为高质量素材备用)。典型呈现方式为在页面中并列展示最终 Logo 与高清大图,并标注尺寸信息,便于直接预览、嵌入网页或下载使用。

输出案例

说明:若输出结果包含图片,优先插入对应图片资源,之后再输出 JSON / Markdown 格式的文本内容。

以下为该技能的历史生成效果案例图(实际调用时,图片地址以接口返回的 finallogourl / largeimageurl 为准):

生成效果案例1

生成效果案例2

生成效果案例3

接口返回的 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
}
  • finallogourl:经过缩放处理后,符合用户尺寸要求的 Logo 图片访问地址
  • actual_size:用户输入的最终 Logo 像素尺寸(格式:宽x高)
  • largeimageurl:等比例放大生成的高清大图访问地址,可作为高质量素材备用

资源索引

  • scripts/execute_task.py:异步提交 Logo 生成任务(真实调用时使用)
  • 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
}

说明:轮询期间 taskstatus 可能为 PENDING/RUNNING 等中间状态;当 taskstatus 为 SUCCEEDED 时,finallogourl、actualsize、largeimage_url 字段可用。

异常说明

异常场景表现处理方式
AppKey 缺失或无效脚本提示「AppKey 不能为空」或接口返回鉴权错误按手机验证流程获取 AppKey,配置环境变量 SHOWAPIAPPKEY 后重试
theme/color 为空脚本抛出 ValueError,提示必填补充 Logo 主题与颜色描述后重新提交
size 格式不合法脚本抛出 ValueError,提示「宽x高」格式按「宽x高」格式填写,如 256x512
task_id 为空或格式非法查询脚本抛出 ValueError使用 executetask.py 返回的原始 taskid 查询
大图生成超时(>900秒)轮询长期未返回 SUCCEEDED稍后重新提交任务,或简化主题描述降低生成复杂度
网络异常 / HTTP错误抛出「HTTP请求失败」「请求失败」等异常检查网络连通性后重试
接口业务错误(showapirescode != 0)抛出「API错误: 具体信息」根据 showapireserror 提示修正入参或凭证后重试

注意事项

  1. theme(Logo核心元素、风格、意象描述)与 color(主色调或颜色指令)为必填项,需清晰描述;size 选填,默认 256x256,格式为「宽x高」。
  2. 所有任务强制异步执行,不支持同步模式。
  3. 轮询查询过程中,每次获取接口返回数据后,立即将主要内容反馈给用户。
  4. 大图生成环节内置轮询(间隔6秒、最长900秒),整体生成耗时可能较长,请务必轮询直至任务完成。
  5. 模拟运行说明:无 appKey 时系统自动触发模拟调用,一次性返回完整 JSON 结果,不经过 executetask.py 和 querytask.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。

同分类其他技能

查看全部 ›