Prise en main

L'API Chillin Render vous permet de spécifier le contenu vidéo et les paramètres à rendre en définissant une structure JSON comme celle ci-dessous.

  • Allez sur API Console pour obtenir des crédits Render API et générer votre clé API Render

  • Envoyez une requête POST à l'endpoint de l'API Render avec votre clé API :

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

L'API fonctionne en mode asynchrone et renvoie une réponse comme celle-ci :

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

Concepts de base

Tous les objets JSON incluent un objet de projet vidéo, spécifiant la largeur composite, la hauteur composite et la résolution de la vidéo.

L'objet projet contient les paramètres de base pour le rendu de la vidéo, tels que la largeur, la hauteur, la durée, la couleur de fond, et plus encore.

Le projet comprend également un ou plusieurs éléments, où chaque élément représente un composant vidéo, tel qu'une vidéo, une image, un texte, une forme, un audio ou un effet.

Chaque élément contient des paramètres spécifiques pour le composant, tels que la position, la taille, la couleur, le contenu, et ainsi de suite.

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

Schéma JSON

Votre JSON de requête doit strictement respecter le schéma JSON défini dans ce document. Vous pouvez tester et générer le JSON de requête correspondant dans l'éditeur vidéo Chillin.