はじめに

Chillin Render APIを使用すると、以下のようなJSON構造を定義することで、レンダリングされるビデオコンテンツとパラメータを指定できます。

  • Render Consoleにアクセスして、Render APIクレジットを取得し、Render APIキーを生成します。

  • APIキーを使用して、Render APIエンドポイントにPOSTリクエストを送信します:

curl-example.sh
1curl -X POST https://render-api.chillin.online/render/v1 \ 2-H "Accept: application/json" \ 3-H "Content-Type: application/json" \ 4-H "Authorization: Bearer YOUR_API_KEY" \ 5-d @request.json
request.json
1{ 2 "compositeWidth": 1920, 3 "compositeHeight": 1080, 4 "fps": 30, 5 "projectData": { 6 "type": "", 7 "width": 1920, 8 "height": 1080, 9 "fill": "#000000", 10 "view": [ 11 { 12 "id": "bba95c7f-652b-4380-b166-6bece989f527", 13 "type": "Image", 14 "start": 0, 15 "duration": 5, 16 "trackIndex": 0, 17 "x": 0, 18 "y": 0, 19 "width": 3629, 20 "height": 5444, 21 "blendMode": "normal", 22 "anchorX": 1814.5, 23 "anchorY": 2722, 24 "rotation": 0, 25 "scaleX": 0.19838354151359294, 26 "scaleY": 0.19838354151359294, 27 "alpha": 1, 28 "skewX": 0, 29 "skewY": 0, 30 "hidden": false, 31 "locked": false, 32 "keyframes": [], 33 "externalUrl": "https://images.pexels.com/photos/33189512/pexels-photo-33189512.jpeg", 34 "ext": "jpeg" 35 } 36 ], 37 "audio": [], 38 "effect": [], 39 "transition": [], 40 "version": 0, 41 "duration": 5 42 } 43}; 44

APIは非同期モードで動作し、このようなレスポンスを返します:

async_response.json
1{ 2 "code": 0, 3 "data": { 4 "message": "Async render request submitted successfully", 5 "render_id": 100000, 6 "status": "processing" 7 }, 8 "msg": "success" 9} 10

コア概念

すべてのJSONオブジェクトには、ビデオの合成幅、合成高さ、および解像度を指定するビデオプロジェクトオブジェクトが含まれています。

プロジェクトオブジェクトには、ビデオをレンダリングするための基本的なパラメータ(幅、高さ、 duración、背景色など)が含まれています。

プロジェクトには、ビデオ、画像、テキスト、形状、音声、またはエフェクトなどのビデオコンポーネントを表す1つ以上の要素も含まれています。

各要素には、位置、サイズ、色、コンテンツなどのコンポーネントに特有のパラメータが含まれています。

project.json
1{ 2 "compositeWidth": 1920, 3 "compositeHeight": 1080, 4 "fps": 30, 5 "projectData": { 6 "type": "", 7 "width": 1920, 8 "height": 1080, 9 "fill": "#000000", 10 "view": [ 11 { 12 "id": "8ecf7475-2c6c-47f9-827b-a09c7913f4c0", 13 "type": "Image", 14 "start": 0, 15 "duration": 5, 16 "trackIndex": 0, 17 "x": -570.0335392757963, 18 "y": -170.90659033307685, 19 "blendMode": "normal", 20 "anchorX": 1302, 21 "anchorY": 2312, 22 "rotation": 0, 23 "scaleX": 0.23356401384083045, 24 "scaleY": 0.23356401384083045, 25 "alpha": 1, 26 "skewX": 0, 27 "skewY": 0, 28 "keyframes": [], 29 "externalUrl": "https://images.pexels.com/photos/30465303/pexels-photo-30465303.jpeg", 30 "ext": "jpeg" 31 } 32 ], 33 "audio": [], 34 "effect": [], 35 "transition": [], 36 "version": 0, 37 "duration": 5 38 } 39}; 40

JSONスキーマ

リクエストJSONは、このドキュメントで定義されたJSONスキーマに厳密に従う必要があります。Chillin Video Editorで対応するリクエストJSONをテストおよび生成できます。