JyDraft

✨ 功能特性

📦 使用说明

一、生成剪映草稿

1️⃣ 创建草稿文件

var script = new ScriptFile(1920, 1080);
script.Content["id"] = draftId;
// 添加轨道
script
 .AddTrack(TrackTypeName.audio)
 .AddTrack(TrackTypeName.video)
 .AddTrack(TrackTypeName.text);

2️⃣ 准备素材

var assetDir = @"D:\pyJianYingDraft\readme_assets\tutorial";
var audioPath = Path.Combine(assetDir, "audio.mp3");
var audioMaterial = new AudioMaterial(audioPath);
var videoPath = Path.Combine(assetDir, "video.mp4");
var videoMaterial = new VideoMaterial(videoPath);
var gifPath = Path.Combine(assetDir, "sticker.gif");
var gifMaterial = new VideoMaterial(gifPath);

3️⃣ 创建片段并添加效果

var audioSegment = new AudioSegment(
 audioMaterial,
 TimeUtil.Trange(0, "5s"),
 volume: 0.6f
);
audioSegment.AddFade("1s", 0);
var videoSegment = new VideoSegment(
 videoMaterial,
 TimeUtil.Trange(0, "4.2s")
);
videoSegment.AddAnimation(IntroType.斜切);
videoSegment.AddTransition(TransitionType.信号故障);
var gifSegment = new VideoSegment(
 gifMaterial,
 TimeUtil.Trange(videoSegment.End, gifMaterial.Duration)
);
gifSegment.AddBackgroundFilling("blur", 0.0625);

4️⃣ 添加文本字幕

var textSegment = new TextSegment(
 "据说 JyDraft 效果还不错?",
 videoSegment.TargetTimerange,
 font: FontType.文轩体,
 style: new TextStyle(color: new[] { 1.0f, 1.0f, 0.0f }),
 clipSettings: new ClipSettings(transformY: -0.8f)
);
textSegment.AddAnimation(
 Text_outro.故障闪动,
 "out",
 duration: TimeUtil.Tim("1s")
);
textSegment.AddBubble("361595", "6742029398926430728");

5️⃣ 组装并导出草稿

script
 .AddSegment(audioSegment)
 .AddSegment(videoSegment)
 .AddSegment(gifSegment)
 .AddSegment(textSegment);
var json = script.Dumps();

二、草稿渲染与视频导出(HDraft API)

🚀 Draft-to-Video 自动渲染 API 服务

📌 简介

🔑 身份验证(API Key)

1️⃣ 申请 API Key

X-App-Source: HDraft

2️⃣ API Key 使用方式

X-API-KEY: <你的 API Key>

🔐 三、加密草稿解密接口

接口地址

POST https://htwmedia.dpdns.org/home/DecryptDraft

请求方式

请求参数

返回示例

{
 "success": true,
 "msg": "decrypt success",
 "draft_content": "{...}"
}

Python 示例(解密草稿)

import requests
BASE_URL = "https://htwmedia.dpdns.org"
API_KEY = "your_api_key"
headers = {"X-API-KEY": API_KEY}
files = {"jsonFile": open("encrypted_draft.json", "rb")}
res = requests.post(
 f"{BASE_URL}/home/DecryptDraft",
 headers=headers,
 files=files
)
data = res.json()
if data["success"]:
 with open("draft_content.json", "w", encoding="utf-8") as f:
 f.write(data["draft_content"])

四、完整渲染流程示例(Python)

import requests, time
BASE_URL = "https://htwmedia.dpdns.org"
API_KEY = "your_api_key"
headers = {"X-API-KEY": API_KEY}
files = [
 ('jsonFile', open('draft.json','rb')),
 ('assets', open('video.mp4','rb'))
]
res = requests.post(
 f"{BASE_URL}/home/UploadDraftPackage",
 headers=headers,
 data={'title':'示例'},
 files=files
)
draft_id = res.json()['draftId']
task_id = requests.post(
 f"{BASE_URL}/home/startrender",
 params={'draftId': draft_id},
 headers=headers
).json()['taskId']
while True:
 status = requests.get(
 f"{BASE_URL}/home/getstatus",
 params={'taskId': task_id},
 headers=headers
 ).json()
 if status['status'] == 'completed':
 print("下载地址:", status['downloadUrl'])
 break
 time.sleep(5)

📡 接口总览

💬 讨论群 / 技术交流

❗ 常见错误码

📄 License