開始使用

Chillin Render API 允許您通過定義如下的 JSON 結構來指定要渲染的視頻內容和參數。

• 前往 Render Console 獲取 Render API 積分並生成您的 Render API 密鑰

• 向 Render API 端點發送帶有您的 API 密鑰的 POST 請求：

該 API 在異步模式下運行，並返回如下響應：

核心概念

所有 JSON 對象都包括一個視頻項目對象，指定視頻的合成寬度、合成高度和解析度。

項目對象包含渲染視頻的基本參數，例如寬度、高度、持續時間、背景顏色等。

該項目還包括一個或多個元素，每個元素表示一個視頻組件，例如視頻、圖像、文本、形狀、音頻或效果。

每個元素都包含該組件的特定參數，例如位置、大小、顏色、內容等。

3D 空間與相機

渲染引擎支持 2D 和 3D 元素。雖然畫布的寬度和高度以像素為單位定義，但引擎使用透視相機進行 3D 渲染：

• 坐標系統：x 和 y 坐標表示 2D 畫布平面上的位置。z 坐標控制 3D 空間中的深度。
• 像素完美投影：在 z=0 時，一個世界單位等於一個像素，保持與 2D 工作流程的兼容性。
• 3D 旋轉：元素可以使用 rotationX、rotationY 和 rotation（Z 軸）屬性繞 X、Y 和 Z 軸旋轉。

此設計允許在同一項目中無縫混合 2D 和 3D 元素。傳統的 2D 元素（z=0）與之前一樣渲染，而 3D 元素可以在三維空間中進行定位和旋轉。

3D 元素示例

這是一個簡單的 3D 立方體元素示例：

與 2D 元素的主要區別：

• type: "3D" 將其標識為 3D 元素
• z、rotationX、rotationY 和 scaleZ 使 3D 變換成為可能
• geometryType 指定 3D 形狀（立方體、球體、圓柱體等）
• geometryColor 設置 3D 幾何圖形的基本顏色

有關 3D 元素的更多詳細信息，請參見 3D Element 文檔。

JSON 架構

您的請求 JSON 必須嚴格遵循本文件中定義的 JSON 架構。您可以在 Chillin Video Editor 中測試並生成相應的請求 JSON。