十万个为什么-万维易源

概述

十万个为什么科普图文生成

任务目标

• 基于用户输入的"十万个为什么"科普提问，一键生成适合 3-8 岁儿童认知的科普图文
• 具备合规校验优化、固定提示词模板拼接、高清图像生成、生成状态轮询、结果获取能力
• 触发场景：解答孩子提问、儿童科普教育、科普绘本/课件配图、小红书/朋友圈等新媒体科普内容创作

能力组成

能力流程描述

该技能以用户输入的"十万个为什么"科普提问为起点，自动完成儿童科普图文的生成与交付，整体流程分为 4 个阶段：

1. 需求输入阶段：用户提交科普提问 question（必填，如"为什么海水不能喝？"），并可选指定画幅比例 aspect_ratio（3:4 小红书/海报、16:9 视频封面、1:1 朋友圈，默认 3:4）。
2. 异步提交阶段：调用 execute_task.py 将需求异步提交至工作流（flow_id: 6a6ff06a3c51f2ec21002bf8），系统立即返回唯一 task_id，不阻塞等待。
3. 后台生成阶段：工作流依次执行三个步骤：
   • step_0 合规校验优化：对科普提问内容进行合规性校验与优化；
   • step_1 生成科普图文：将提问填入固定提示词模板「推荐最适合3-8岁儿童的{question}的科普图文，要求使用中文，文字尽量少，且精准」，连同画幅参数一起送入高清图像生成模型；
   • step_2 轮询科普图文生成状态：每隔 5 秒查询一次图像生成状态，最长等待 1200 秒，直至任务状态为 SUCCEEDED。
4. 结果获取与交付阶段：调用 query_task.py 使用 task_id 轮询查询任务结果，每轮即时反馈当前进度；任务完成后提取科普图文图片地址 image_url，并通过 HTML 页面可视化展示交付。

技能能力组成流程图

flowchart TD
    A["用户输入科普提问 question<br/>（可选画幅 aspect_ratio: 3:4/16:9/1:1）"] --> B["execute_task.py<br/>异步提交生成任务"]
    B --> C["返回唯一 task_id"]
    C --> D["step_0 合规校验优化"]
    D --> E["step_1 生成科普图文<br/>固定提示词模板 + 高清图像生成模型"]
    E --> F["step_2 轮询科普图文生成状态<br/>间隔5秒 / 超时1200秒"]
    F -- "task_status === SUCCEEDED" --> G["query_task.py<br/>轮询查询任务结果"]
    G --> H["输出 image_url<br/>（科普图文图片URL）"]
    H --> I["HTML 可视化展示"]
    F -- "超时/失败" --> J["返回失败信息（继续轮询或终止）"]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 鉴权配置：

本 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. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包
• 计费说明：预估单次调用约 0.22 元，实际计费按输出内容消耗 token 多少有所浮动

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

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

1. 可视化预览

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

1. 引导真实调用

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

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

1. 收集用户需求

梳理用户的"十万个为什么"科普提问（必填），确认画幅比例（选填：3:4 小红书/海报、16:9 视频封面、1:1 朋友圈，默认 3:4）。

1. 异步提交生成任务

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

   python scripts/execute_task.py --question "为什么海水不能喝？" --aspect-ratio "3:4"

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

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

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

1. 等待结果完成

必须轮询直到完成（图像生成含内部轮询，最长约 1200 秒）。

1. 结果解析与落地应用

提取科普图文图片地址 image_url，按画幅用途落地：3:4 用于小红书/海报、16:9 用于视频封面、1:1 用于朋友圈分享。

1. 生成html页面

生成一个简单的html页面来展示返回的科普图文图片（image_url），便于预览与交付。

使用示例

示例1：解答孩子的"为什么"

• 输入：question="为什么海水不能喝？"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度）
• 产出：一张面向3-8岁儿童、解释"海水为什么不能喝"的科普图文
• 配置要点：aspect_ratio 默认 3:4，适合作为科普海报打印或分享

示例2：小红书儿童科普内容配图

• 输入：question="为什么天上会下雨？"，aspect_ratio=3:4
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度）
• 产出：适配小红书的 3:4 竖版科普图文，画面童趣、文字精简
• 配置要点：3:4 为默认画幅，适合小红书/海报场景批量生产

示例3：科普短视频封面

• 输入：question="月亮为什么跟着我走？"，aspect_ratio=16:9
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度）
• 产出：16:9 横版科普图文，可直接用作短视频封面
• 配置要点：视频封面用 16:9，朋友圈分享用 1:1

生成效果示例

描述

任务完成后，接口返回生成的科普图文图片访问地址（image_url），指向一张适合 3-8 岁儿童认知水平的科普插画：

• 围绕提问主题自动提炼视觉核心，画面直观、童趣易懂
• 图中包含少量精准的中文说明文字（符合"文字尽量少，且精准"的固定模板要求）
• 画幅比例由 aspect_ratio 决定（3:4 / 16:9 / 1:1）
• 典型用法：将 image_url 图片下载保存，或直接嵌入公众号、小红书、绘本、课件等场景，也可通过 HTML 页面可视化预览

输出案例

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

任务完成后的接口返回数据实际形态（JSON）：

{
  "showapi_res_body": {
    "task_id": "6f3a2c8b9d1e4a5f",
    "task_status": "SUCCEEDED",
    "image_url": "https://oss.showapi.com/workflow_result/6a6ff06a3c51f2ec21002bf8/result_6f3a2c8b.png",
    "msg": "科普图文生成完成"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

• [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": {
    "task_id": "唯一任务ID",
    "task_status": "SUCCEEDED",
    "image_url": "生成的科普图文图片访问地址",
    "msg": "科普图文生成完成"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

字段说明：

• task_status：任务状态。处于生成中状态时继续轮询；SUCCEEDED 表示成功，此时 image_url 有值；FAILED 表示失败
• image_url：生成的科普图文图片访问地址（输出必填字段，格式为 URL）

注意事项

1. question 为必填项，建议使用具体的"为什么"式提问，系统面向 3-8 岁儿童认知水平进行生成。
2. 所有任务强制异步执行，不支持同步模式。
3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 提示词模板固定（要求中文、文字尽量少且精准），不支持自定义画风与文案内容。
5. 图像生成含内部轮询，最长约 1200 秒（20 分钟），请耐心轮询直至 SUCCEEDED。
6. 计费：预估单次调用约 0.22 元，实际计费按输出内容消耗 token 多少有所浮动。
7. 模拟运行说明：无 appKey 时系统自动触发模拟调用（POST https://www.showapi.com/_nuxt3/api/2405-105，body: {"flow_id":"6a6ff06a3c51f2ec21002bf8"}），一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。