{
  "workflow_id": "morning_sign_video_generation",
  "input": {
    "mood": {
      "field_name": "mood",
      "default": "美好",
      "description": "心情关键词，如希望、宁静、顺遂",
      "example": "顺遂",
      "required": false,
      "type": "string"
    },
    "date": {
      "field_name": "date",
      "default": "",
      "description": "今天的日期，如7月27日",
      "example": "7月27日",
      "required": true,
      "type": "string"
    },
    "city": {
      "field_name": "city",
      "default": "",
      "description": "地点，城市名（如上海、西安，系统将自动验证归属地）",
      "example": "上海",
      "required": true,
      "type": "string"
    }
  },
  "steps": [
    {
      "point_code": "1",
      "id": "step_0_prompt_guardian",
      "backend_type": "sys_api",
      "api_code": "prompt_guardian",
      "status": "PENDING",
      "name": "合规校验优化",
      "action": "run",
      "params": []
    },
    {
      "point_code": "2",
      "id": "step_1_query_weather",
      "result": [],
      "backend_type": "sys_api",
      "api_code": "9",
      "status": "PENDING",
      "name": "查询城市天气",
      "action": "run",
      "params": {
        "needAlarm": "0",
        "needHourData": "0",
        "area": "{{@input.city}}",
        "needIndex": "0",
        "need3HourForcast": "0",
        "needMoreDay": "0"
      }
    },
    {
      "point_code": "",
      "id": "step_2_query_landmarks",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "landmark_query",
      "status": "PENDING",
      "name": "查询城市地标",
      "action": "run",
      "params": {
        "city": "{{@input.city}}"
      }
    },
    {
      "point_code": "",
      "id": "step_3_generate_poster_prompt",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "poster_prompt_generate",
      "status": "PENDING",
      "name": "生成画报提示词",
      "action": "run",
      "params": {
        "landmarks": "{{@step_2_query_landmarks.result.data.landmarks}}",
        "weather_desc": "{{@step_1_query_weather.result.data.now.temperature}}°C {{@step_1_query_weather.result.data.now.weather}}",
        "date": "{{@input.date}}",
        "city": "{{@input.city}}"
      },
      "depends_on": [
        "step_1_query_weather",
        "step_2_query_landmarks"
      ]
    },
    {
      "point_code": "1",
      "id": "step_4_generate_poster_image",
      "result": [],
      "backend_type": "sys_api",
      "api_code": "3373",
      "status": "PENDING",
      "name": "生成日签画报图片",
      "action": "run",
      "params": {
        "prompt": "{{@step_3_generate_poster_prompt.result.data.result}}",
        "aspect_ratio": "9:16"
      },
      "depends_on": [
        "step_3_generate_poster_prompt"
      ]
    },
    {
      "point_code": "",
      "id": "step_5_poll_poster_status",
      "result": [],
      "backend_type": "sys_api",
      "api_code": "polling",
      "status": "PENDING",
      "name": "轮询画报生成状态",
      "action": "run",
      "params": {
        "result_url": "{{@step_4_generate_poster_image.result.data.result_url}}"
      },
      "depends_on": [
        "step_4_generate_poster_image"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1200,
        "success_condition": "{{@step_5_poll_poster_status.result.data.task_status}} === 'SUCCEEDED'"
      }
    },
    {
      "point_code": "",
      "id": "step_6_generate_narration",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "video_narration_generate",
      "status": "PENDING",
      "name": "生成视频旁白文案",
      "action": "run",
      "params": {
        "mood": "{{@input.mood}}",
        "weather_desc": "{{@step_1_query_weather.result.data.now.temperature}}°C {{@step_1_query_weather.result.data.now.weather}}",
        "date": "{{@input.date}}",
        "city": "{{@input.city}}"
      },
      "depends_on": [
        "step_1_query_weather"
      ]
    },
    {
      "point_code": "1",
      "id": "step_7_start_video_task",
      "result": [],
      "backend_type": "sys_api",
      "api_code": "3464",
      "status": "PENDING",
      "name": "启动日签视频生成任务",
      "action": "run",
      "params": {
        "content": [
          {
            "text": "视频中朗读文本：'{{@step_6_generate_narration.result.data.result}}'。画面由静态日签画报缓缓推近，云朵轻移，光影流动。",
            "type": "text"
          },
          {
            "image_url": {
              "url": "{{@step_5_poll_poster_status.result.data.result_url}}"
            },
            "role": "reference_image",
            "type": "image_url"
          }
        ],
        "watermark": false,
        "duration": 10,
        "model": "doubao-seedance-2-0-260128",
        "ratio": "9:16",
        "generate_audio": true
      },
      "depends_on": [
        "step_5_poll_poster_status",
        "step_6_generate_narration"
      ]
    },
    {
      "point_code": "",
      "id": "step_8_poll_video_status",
      "result": [],
      "backend_type": "sys_api",
      "api_code": "polling",
      "status": "PENDING",
      "name": "轮询视频生成状态",
      "action": "run",
      "params": {
        "result_url": "{{@step_7_start_video_task.result.data.result_url}}"
      },
      "depends_on": [
        "step_7_start_video_task"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1800,
        "success_condition": "{{@step_8_poll_video_status.result.data.task_status}} === 'SUCCEEDED'"
      }
    }
  ],
  "output": {
    "video_thumbnail_url": {
      "field_name": "video_thumbnail_url",
      "description": "视频尾帧缩略图URL",
      "value": "{{@step_8_poll_video_status.result.data.thumbnail_url}}",
      "type": "string"
    },
    "video_url": {
      "field_name": "video_url",
      "description": "生成的早安日签视频URL",
      "value": "{{@step_8_poll_video_status.result.data.result_url}}",
      "type": "string"
    },
    "narration_text": {
      "field_name": "narration_text",
      "description": "视频旁白文案",
      "value": "{{@step_6_generate_narration.result.data.result}}",
      "type": "string"
    },
    "poster_image_url": {
      "field_name": "poster_image_url",
      "description": "生成的日签画报图片URL",
      "value": "{{@step_5_poll_poster_status.result.data.result_url}}",
      "type": "string"
    }
  }
}

调用方式异步 https://route.showapi.com/flow/execute/6a68185e3c51f2e6590291b7

提交后立即返回 task_id，系统每 2 秒自动轮询一次运行状态并可视化执行步骤，适合耗时较长的 Skill。

输入参数共 3 个参数（其中 2 个必填）

moodstring

心情关键词，如希望、宁静、顺遂

date必填string

今天的日期，如7月27日

city必填string

地点，城市名（如上海、西安，系统将自动验证归属地）

把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Skill 技能包。

Skill 为异步调用过程：先提交执行拿到 task_id，再轮询查询任务状态与结果。下方按调用顺序列出两个端点。

1POST

提交执行

https://route.showapi.com/flow/execute/{flow_id}?appKey={AppKey}

鉴权：URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey

请求体参数 (Request Body)

moodstring

心情关键词，如希望、宁静、顺遂

datestring必填

今天的日期，如7月27日

citystring必填

地点，城市名（如上海、西安，系统将自动验证归属地）

响应：提交成功返回 task_id

2GET

查询任务状态

https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}

鉴权：URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey

用第 ① 步返回的 task_id 替换 URL 中的 {task_id} 轮询，建议 1-2 秒一次，直到 status 为 SUCCESS 或 FAILED；step_status_list 可用于可视化执行进度。

响应：任务状态与结果

执行中途出错时

status 返回 FAILED， remark 给出错误信息； step_status_list 仅包含已执行到的部分阶段， output 为已产出的部分结果（可能为空或不完整）。

通用响应说明

系统级返回

所有 API 响应均使用平台统一封装，业务数据嵌套在 showapi_res_body 中

错误码 (showapi_res_code)

调用代码

代码示例根据当前 输入参数实时生成。异步调用一并提供"执行"与"查询任务"两个步骤的完整代码，可按序集成。

调用代码

POSThttps://route.showapi.com/flow/execute/6a68185e3c51f2e6590291b7?appKey={AppKey}

提交任务后立即返回 task_id，需配合步骤 ② 轮询执行状态与结果

curl \
  -g 'https://route.showapi.com/flow/execute/6a68185e3c51f2e6590291b7?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "mood": "顺遂",
  "date": "7月27日",
  "city": "上海"
}'

响应示例：{ "code": 0, "data": { "task_id": "69ddd187e13823d1d500015b" } }

请在 URL 查询参数 appKey 中携带你的 AppKey（如 ?appKey=你的AppKey），不要在前端代码中硬编码生产凭证，建议通过环境变量或后端代理注入。前往控制台获取 AppKey

OpenAPI 规范

标准 OpenAPI 3.0 规范文档，可导入 Apifox / Postman / Swagger Editor / Dify，或直接交给 AI Agent 读取以自动接入本 Skill。提供 YAML 与 JSON 两种格式，支持浏览器在线查看与直接下载。
当前为已发布正式版（/flow/*，对外可调用）。

YAMLhttp://node_site_upstream/openapi/workflow/6a68185e3c51f2e6590291b7.yaml

JSONhttp://node_site_upstream/openapi/workflow/6a68185e3c51f2e6590291b7.json