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"
}