Agent Skill

十万个为什么-万维易源

基于"十万个为什么"科普提问一键生成适合3-8岁儿童的科普图文图片,支持小红书/海报(3:4)、视频封面(16:9)、朋友圈(1:1)多种画幅;适用于儿童科普教育、亲子问答配图、科普绘本制作、新媒体科普内容创作场景

内容创作·万维易源·来自 skill_hub·skillhub.cn ↗
skillhub install @showapi/generate-science-illustration-for-kids-showapi
3 Stars·6.6万 综合热度·5,247 字文档·源站更新 2026-11-22

README 文档

5,247 字

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

任务目标

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

能力组成

能力流程描述

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

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

注意事项

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

操作步骤

模拟体验流程(无 appKey)

  1. 自动触发模拟调用

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

生成效果示例1 生成效果示例2 生成效果示例3 生成效果示例4 生成效果示例5

任务完成后的接口返回数据实际形态(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/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
}

字段说明:

  • taskstatus:任务状态。处于生成中状态时继续轮询;SUCCEEDED 表示成功,此时 imageurl 有值;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: {"flowid":"6a6ff06a3c51f2ec21002bf8"}),一次性返回完整 JSON 结果,不经过 executetask.py 和 querytask.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。

同分类其他技能

查看全部 ›