城市天气画报生成

概述

城市天气宣传画报生成

任务目标

• 快速生成融合城市地标、实时天气与艺术风格的精美画报
• 具备城市消歧、天气查询、地标提炼、构图设计、提示词生成及图像生成能力
• 触发场景：旅游打卡海报制作、城市文化宣传、每日天气海报设计

能力组成

本技能由城市消歧、实时天气查询、城市地标提炼、艺术构图设计、专业提示词生成、画报图像生成六大能力串联而成，整体工作流如下：

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• AppKey 获取方式：
  1. 注册账号：访问 https://www.showapi.com 完成注册并登录。
  2. 进入控制台：登录后打开 https://www.showapi.com/console#/myApp 。
  3. 获取 AppKey：在「我的应用」页面中查看并复制 AppKey。
  4. 配置凭证：将复制的 AppKey 配置为凭证 showapi_appkey（未配置时技能会提示先获取并填入）。

操作步骤

标准流程（强制异步执行）

1. 收集用户需求

收集用户输入的城市名或景点名（必填）、绘画风格（选填，默认水墨画）、画面宽高比（选填，默认9:16）。

1. 异步提交生成任务

调用脚本异步执行画报生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --city "西安" --style "水墨画" --ratio "9:16"

1. 轮询查询任务结果（必选）

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

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成。

1. 结果解析与落地应用

提取画报图片URL、标准城市名、天气状况、温度范围等基础信息，将画报展示给用户。

1. 生成html页面

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

使用示例

示例1：生成指定城市天气画报

• 输入：生成西安的水墨画风格天气海报
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：西安城市地标融合天气的水墨画风格海报

示例2：旅游景点宣传海报

• 输入：为海南三亚生成吉卜力漫画风格的海报
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：融合三亚天气与地标的动漫风海报
• 配置要点：style设为"吉卜力漫画"

生成效果示例

以下为实际调用本技能生成的城市天气画报示例，展示了融合城市地标、实时天气与不同艺术风格的产出效果。

输出案例 1

输出案例 2

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交画报生成任务
• [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": {
    "poster_image_url": "画报图片URL",
    "city_name": "陕西省西安",
    "weather_condition": "晴",
    "temperature_range": "15℃~28℃",
    "poster_prompt": "生成画报所用的专业提示词"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. city 为必填项，建议输入"省份+城市"格式以避免歧义，若仅输入城市名系统将自动消歧。
2. 所有任务强制异步执行，不支持同步模式。
3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 画报图像生成耗时较长，请耐心轮询直到任务完成。