← Back to Skills Marketplace
2719040953

Json To Jianying Description

by 2719040953 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
103
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install json-to-jianying-description
Description
将特定的JSON视频素材格式(包含oralBroadcastingList、materialList、bgmInfo等字段)转换为剪映API可用的自然语言视频描述。用于根据素材JSON生成视频制作指令,包括素材匹配、时间轴计算、字幕时间同步、特殊效果处理等。当用户发送包含oralBroadcastingList和...
README (SKILL.md)

JSON 转剪映视频描述

输入格式

用户会发送一个包含以下关键字段的 JSON:

{
  "oralBroadcastingList": [
    {
      "oralText": "文案内容",
      "materialDesc": "素材描述",
      "materialKey": "desc_material_xxx.jpg",
      "ttsResult": {
        "text": "实际朗读文本",
        "duration": 2.28,
        "audioOssBucket": "np-vediooss-material",
        "audioOssKey": "volc_tts_xxx.mp3",
        "captionStartEnds": [
          { "caption": "字幕1", "startSecond": 0.0, "endSecond": 1.12, "duration": 1.12 },
          { "caption": "字幕2", "startSecond": 1.12, "endSecond": 2.28, "duration": 1.16 }
        ]
      }
    }
  ],
  "materialList": [
    {
      "ossBucket": "np-vediooss-material",
      "ossKey": "desc_material_xxx.jpg",
      "url": "https://...",
      "desc": "素材描述"
    }
  ],
  "bgmInfo": {
    "ossBucket": "np-vediooss-material",
    "ossKey": "desc_material_xxx.mp3",
    "url": "https://...",
    "title": "背景音乐标题",
    "duration": 193000
  }
}

输出格式

转换为自然语言描述,格式如下:

视频总时长:X秒

0-X秒是 {materialKey} 这个素材,对应的字幕:
- 0.0-1.21 秒是 "字幕1"
- 1.21-1.91 秒是 "字幕2"
...

X-Y秒是 {materialKey} 这个素材,对应的字幕:
...

背景图:{ossKey}

特殊需求:
- 在某某时间段插入图片:{ossKey}
- 给某素材添加某某特效

转换步骤

1. 解析 oralBroadcastingList

  • 遍历 oralBroadcastingList 数组
  • 每个元素代表一个视频片段
  • 使用 ttsResult.captionStartEnds 计算该片段的起止时间

2. 计算时间轴

  • 起始时间:累加前面所有片段的 duration
  • 结束时间:起始时间 + 当前片段的 ttsResult.duration
  • 每个字幕的绝对时间 = 片段起始时间 + captionStartEnds 中的相对时间

3. 匹配素材

  • materialList 中查找 ossKeyoralBroadcastingList[].materialKey 匹配的素材
  • 使用 url 字段作为素材地址

4. 处理背景图

  • 默认使用 materialList 中的第一张图片作为背景图
  • 或使用用户指定的背景图

5. 处理 BGM

  • 提取 bgmInfo.url 作为背景音乐

6. 特殊需求识别

用户可能会指定额外需求,如:

  • 在某时间段插入额外图片
  • 给某素材添加特效(如"放映滚动")
  • 调整素材顺序

素材地址拼接

图片/视频/音频素材地址拼接:

  • 基础URL: http://np-newsmgr-uat.emapd.com/videomake/api/resource/download/bucket
  • 拼接方式: ${baseUrl}?filename=${ossKey}&bucket=${ossBucket}

示例:

  • ossKey: 深色质感背景图3.png,bucket: np-vediooss-material
  • 完整地址: http://np-newsmgr-uat.emapd.com/videomake/api/resource/download/bucket?filename=深色质感背景图3.png&bucket=np-vediooss-material

完整示例

输入 JSON(用户提供的例子)

{
  "oralBroadcastingList": [
    {
      "oralText": "宝济药业 - B有重大进展!",
      "materialKey": "desc_material_D36841A87F2909BB35DC950C500064D9.jpg",
      "ttsResult": {
        "captionStartEnds": [
          { "caption": "宝济药业 - B", "startSecond": 0.0, "endSecond": 1.12 },
          { "caption": "有重大进展", "startSecond": 1.12, "endSecond": 2.28 }
        ],
        "duration": 2.28
      }
    },
    {
      "oralText": "3月25日,宝济药业 - B公告相关进展。",
      "materialKey": "desc_material_D36841A87F2909BB35DC950C500064D9.jpg",
      "ttsResult": {
        "captionStartEnds": [
          { "caption": "3月25日", "startSecond": 0.0, "endSecond": 1.03 },
          { "caption": "宝济药业 - B", "startSecond": 1.03, "endSecond": 1.92 },
          { "caption": "公告相关进展", "startSecond": 1.92, "endSecond": 3.14 }
        ],
        "duration": 3.14
      }
    }
    // ... more items
  ],
  "materialList": [
    {
      "ossKey": "desc_material_D36841A87F2909BB35DC950C500064D9.jpg",
      "ossBucket": "np-vediooss-material",
      "url": "https://img0.baidu.com/...",
      "desc": "宝济药业大楼外观局部"
    }
  ],
  "bgmInfo": {
    "ossBucket": "np-vediooss-material",
    "ossKey": "desc_material_C6CF433C3F6ADEBA88682E05EE9D9F5F.mp3",
    "url": "https://cdnsaas.kuai.360.cn/...",
    "title": "氛围音乐 助眠"
  }
}

输出描述

视频总时长:29.39秒

0-2.28秒是 desc_material_D36841A87F2909BB35DC950C500064D9.jpg 这个素材,对应的字幕:
- 0.0-1.12 秒是 "宝济药业 - B"
- 1.12-2.28 秒是 "有重大进展"

2.28-5.42秒是 desc_material_D36841A87F2909BB35DC950C500064D9.jpg 这个素材,对应的字幕:
- 2.28-3.31 秒是 "3月25日"
- 3.31-4.20 秒是 "宝济药业 - B"
- 4.20-5.42 秒是 "公告相关进展"

... (以此类推)

背景图:desc_material_D36841A87F2909BB35DC950C500064D9.jpg

BGM:氛围音乐 助眠 (url: https://cdnsaas.kuai.360.cn/...)

注意事项

  1. 时间累加:每个片段的绝对起始时间需要累加前面所有片段的 duration
  2. 素材匹配:materialKey 可能不完整(如只有文件名),需要在 materialList 中模糊匹配
  3. OSS 地址拼接:需要将 ossKey 和 ossBucket 拼接成完整的素材地址
  4. 用户额外需求:用户可能会指定插入图片、添加特效等额外需求,需要在描述中体现

使用场景

当用户发送类似结构的 JSON 并要求:

  • "帮我生成一个视频"
  • "把这个转成视频描述"
  • "用这个素材做视频"

此时应使用此 skill 进行 JSON 解析和描述转换。

Usage Guidance
This skill is internally consistent and asks for nothing sensitive. Before using it in production: 1) review the hard-coded base URL (np-newsmgr-uat.emapd.com) — it looks like a UAT/internal endpoint; confirm you want generated descriptions to reference that domain or replace it with your production asset host; 2) be cautious if you (or an agent calling this skill) plan to fetch asset URLs returned by the skill — ensure those URLs point to resources you control and do not expose private material; 3) because this is instruction-only, the skill won't install code, but validate any downstream automation that consumes the generated descriptions (e.g., an automated fetch/upload step) so it doesn't inadvertently transmit sensitive data.
Capability Analysis
Type: OpenClaw Skill Name: json-to-jianying-description Version: 1.0.0 The skill is a data transformation utility designed to convert structured JSON video metadata into natural language descriptions for the Jianying (CapCut) API. It performs timeline calculations and string concatenation to generate resource URLs (e.g., at np-newsmgr-uat.emapd.com) based on user-provided OSS keys. No evidence of data exfiltration, malicious execution, or prompt injection was found in SKILL.md or references/json-schema.md.
Capability Assessment
Purpose & Capability
The name/description (convert oralBroadcastingList/materialList/bgmInfo JSON into Jianying/剪映-style video descriptions) matches the SKILL.md's parsing, timeline calculation, material matching and output formatting. No unrelated binaries or environment variables are requested.
Instruction Scope
The instructions are narrowly scoped to parsing the supplied JSON, computing absolute times, matching materialList entries, and producing human-readable instructions. One note: the docs include a hard-coded base URL (http://np-newsmgr-uat.emapd.com/...) used to build asset download links; the skill does not itself instruct fetching those URLs or accessing local files, but consumers should be aware the outputs reference that endpoint.
Install Mechanism
No install spec and no code files — this is instruction-only, so nothing is written to disk or installed.
Credentials
No environment variables, credentials, or config paths are required. The data used comes entirely from user-supplied JSON and the documented base URL/urls inside examples.
Persistence & Privilege
always:false and no special privileges requested. The skill does not modify system/agent settings or other skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install json-to-jianying-description
  3. After installation, invoke the skill by name or use /json-to-jianying-description
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of json-to-jianying-description. - Converts specific JSON video material formats (with oralBroadcastingList, materialList, bgmInfo) to natural language video descriptions compatible with Jianying API. - Supports time axis calculation, subtitle synchronization, material matching, special effect handling, and address construction. - Handles user requirements for video production instructions based on input JSON. - Recognizes and incorporates extra user requests such as inserting images or adding effects.
Metadata
Slug json-to-jianying-description
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Json To Jianying Description?

将特定的JSON视频素材格式(包含oralBroadcastingList、materialList、bgmInfo等字段)转换为剪映API可用的自然语言视频描述。用于根据素材JSON生成视频制作指令,包括素材匹配、时间轴计算、字幕时间同步、特殊效果处理等。当用户发送包含oralBroadcastingList和... It is an AI Agent Skill for Claude Code / OpenClaw, with 103 downloads so far.

How do I install Json To Jianying Description?

Run "/install json-to-jianying-description" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Json To Jianying Description free?

Yes, Json To Jianying Description is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Json To Jianying Description support?

Json To Jianying Description is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Json To Jianying Description?

It is built and maintained by 2719040953 (@2719040953); the current version is v1.0.0.

💬 Comments