curl -X POST https://render-api.chillin.online/render/v1 \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d @request.json注意: 私たちのレンダリングリクエストは非同期で処理されます。リクエストを送信すると、すぐに
render_idを含む応答が返されます。これを使用してレンダリングのステータスと結果を照会できます。
| プロパティ | タイプ | 必須 | 例 | 値の範囲 | 説明 |
|---|---|---|---|---|---|
| compositeWidth | number | true | 1920 | 720 - 3840 | 合成の幅。 |
| compositeHeight | number | true | 1080 | 720 - 3840 | 合成の高さ。 |
| fps | number | true | 30 | 15 - 60 | 合成のフレームレート。 |
| projectData | object | true | - | - | プロジェクトデータ。エディターからエクスポートできます。 |
| camera | object | false | - | - | 3Dシーンのオプションのカメラ設定。投影モードと視点を制御します。 |
注意:
compositeWidthとcompositeHeightはprojectDataで指定されたwidthとheightとは異なる場合があります。ただし、compositeWidthとcompositeHeightのアスペクト比は、projectData.widthとprojectData.heightのアスペクト比と一致している必要があります。
この設計により、元のアスペクト比を維持しながら、同じビデオプロジェクトを異なる解像度でエクスポートできます。
オプションの camera オブジェクトは、3D要素がどのように投影されるかを制御します：
mode (文字列) - 投影モード: "perspective" (デフォルト) または "orthographic"。パースペクティブは深さに基づく短縮を提供し、オルソグラフィックは平行線を保持します。view (文字列) - プリセットカメラビュー名 (例: "front", "top", "right", "isometric")。指定された場合、カメラはプリセット角度に合わせて配置されます。
cameraが提供されない場合、デフォルトのパースペクティブ前面ビューが使用されます。
{
"compositeWidth": 1920,
"compositeHeight": 1080,
"fps": 30,
"projectData": {
"type": "",
"width": 1920,
"height": 1080,
"fill": "#000000",
"view": [
{
"id": "8ecf7475-2c6c-47f9-827b-a09c7913f4c0",
"type": "Image",
"start": 0,
"duration": 5,
"trackIndex": 0,
"x": -570.0335392757963,
"y": -170.90659033307685,
"blendMode": "normal",
"anchorX": 1302,
"anchorY": 2312,
"rotation": 0,
"scaleX": 0.23356401384083045,
"scaleY": 0.23356401384083045,
"alpha": 1,
"skewX": 0,
"skewY": 0,
"keyframes": [],
"externalUrl": "https://images.pexels.com/photos/30465303/pexels-photo-30465303.jpeg",
"ext": "jpeg"
}
],
"audio": [],
"effect": [],
"transition": [],
"version": 0,
"duration": 5
}
};
{
"code": 0,
"data": {
"message": "Async render request submitted successfully",
"render_id": 105586,
"status": "processing"
},
"msg": "success"
}
{
"code": 2004,
"data": {},
"msg": "invalid project data: invalid view array: view item 0: missing required field: id"
}
非同期レンダリングAPIから返されるコードは次のとおりです：
projectData フィールドは有効なJSONオブジェクトではありません。duration フィールドは必須ですが、欠落しています。duration フィールドは存在しますが、正しい形式ではありません。リストにないエラーコードが発生した場合は、[email protected] までサポートにお問い合わせください。
非同期レンダーリクエストを送信した後、render_id を使用してレンダリングのステータスと結果を照会できます。
curl -X POST https://render-api.chillin.online/render/result \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"render_id": 100000}'| プロパティ | タイプ | 必須 | 例 | 値の範囲 | 説明 |
|---|---|---|---|---|---|
| render_id | number | true | 100000 | - | 最初のレンダーリクエストから返されたレンダーID。 |
{
"code": 0,
"data": {
"render": {
"create_at": "2025-06-27T12:37:21.684337Z",
"json_url": "https://cloud.chillin.online/project_xxx.json?verify=xxx",
"render_id": 105549,
"state": "success",
"video_url": "https://cloud.chillin.online/video_xxx.mp4?verify=xxx"
}
},
"msg": "success"
}
応答の state フィールドは次の値を持つことができます：
このエンドポイントを使用して、完了したタスクのレンダリングされたビデオファイルとプロジェクトJSONを永久に削除します。
curl -X POST https://render-api.chillin.online/render/delete-files \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"render_id": 100000}'| プロパティ | タイプ | 必須 | 例 | 値の範囲 | 説明 |
|---|---|---|---|---|---|
| render_id | number | true | 100000 | - | クリーンアップしたいレンダーID。成功状態のレンダーのみ削除できます。 |
{
"code": 0,
"data": {
"message": "Render files deleted"
},
"msg": "success"
}