pip install shotstack_sdk
您可能需要使用具体取决于环境的配置方式。pip3
然后,将您的 API 密钥设置为环境变量 (Linux/Mac):
export SHOTSTACK_KEY=your_key_here
或者,如果使用 Windows(确保将路径添加到路径):SHOTSTACK_KEY
set SHOTSTACK_KEY=your_key_here
替换为您提供的沙盒 API 密钥,该密钥可免费用于测试和开发。your_key_here
在您喜欢的 IDE 或文本编辑器中为脚本创建一个文件。你可以随心所欲地称呼它,但在本教程中,我们创建了一个名为watermark-video.py 的文件。打开文件并开始编辑。
让我们导入项目所需的模块。我们需要从 Shotstack SDK 导入模块来编辑和渲染
我们的视频以及几个内置模块:
import shotstack_sdk as shotstack import os import sys from shotstack_sdk.model.clip import Clip from shotstack_sdk.api import edit_api from shotstack_sdk.model.track import Track from shotstack_sdk.model.timeline import Timeline from shotstack_sdk.model.output import Output from shotstack_sdk.model.edit import Edit from shotstack_sdk.model.video_asset import VideoAsset
接下来,添加以下内容,该代码使用 API URL 和密钥设置 API 客户端,这应使用添加到环境变量的
API 密钥。如果需要,可以在此处对 API 密钥进行硬编码,但我们建议使用环境
变量。
host = "https://api.shotstack.io/stage" configuration = shotstack.Configuration(host = host) configuration.api_key['DeveloperKey'] = os.getenv('SHOTSTACK_KEY') with shotstack.ApiClient(configuration) as api_client: api_instance = edit_api.EditApi(api_client)
Shotstack API 遵循桌面编辑软件的许多原则,例如使用时间轴、轨道和
剪辑。时间轴就像一个包含多个剪辑的容器,其中包含
随时间播放的不同资产。
时间轴上的轨道允许我们将剪辑层叠在一起。
视频需要在线托管,并通过公共或签名 URL 访问。我们将使用以下 10 秒的无人机素材作为我们的视频资产。您可以将其替换为来自任何在线来源的您自己的视频 URL。