render_preview

Previous value: -"Blender version: '' (default: a .blend opens with the version it was saved in, other scenes with 5.0) or '5.0' / '5.2' to choose."New value: +"Blender version: '' (default: a .blend opens with the version it was saved in, other scenes with 5.0) or '5.0' / '5.2' (also '4.5', '4.2', '3.6'; a script that stops on Blender 5 because of an older API is rendered again on those automatically) to choose."

Added value: +"Extra files sent with the scene: local paths (textures, glTF .bin), https links, or 'polyhaven:<id>' CC0 assets from asset_search. A .blend finds them through relative paths (same folder); a script through os.environ['JR_ASSETS_DIR'] or the jr_assets helpers."

Added value: +"Blender version: '' (default: a .blend opens with the version it was saved in, other scenes with 5.0) or '5.0' / '5.2' to choose."

Added value: +"Name of the camera object to render from (default: the scene's active camera, or an automatic camera if there is none). Ignored with orbit=True; not combinable with cameras."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Several camera object names (up to 8) rendered from the same frame in one job: the preview tiles them in one labeled sheet, the final returns one PNG/EXR per camera (camera_files maps names to files). For product shots from fixed angles. Not combinable with orbit, environment='compare' or camera.",
+  "title": "Cameras"
+}

Added value: +"'' or 'cycles' (path tracing, default) | 'eevee' (real-time rasterizer: about half the per-frame cost on animations of a few dozen frames or more; each job pays about 7 s of shader compilation, so previews stay on Cycles)."

Added value: +"Lighting preset: '' (the scene's own world), 'studio', 'sunset', 'overcast' or 'night' (bundled HDRIs; a good first render for scenes without lighting work), or 'compare' (preview only: all four in one labeled 2x2 image, to pick one)."

Added value: +"Multiplier for the HDRI preset's brightness (default 1.0)."

Added value: +"False hides the HDRI from the camera (flat grey backdrop, HDRI lighting only)."

Added value: +"Preview frames: '' = frame 1; '12' = one frame; '1,8,16,24' or '1-24' = up to 4 frames tiled in one labeled image (to judge camera motion and animation; same GPU time as one 720p frame)."

Added value: +"Output height in pixels (previews are capped at 1280x720 keeping the aspect ratio; a final frame can have at most 1920x1080 pixels on free time, 3840x2160 on prepaid credit)."

Added value: +"True: turntable; an orbit camera circles the scene once (the scene's own camera is not used). Flat floors and walls are ignored when framing. A preview without frames shows 0/90/180/270 degrees; a final without frame_end renders the whole turn as an MP4. Best for imported models and product videos."

Added value: +"Multiplier for the orbit camera distance (default 1.0)."

Added value: +"Orbit camera elevation in degrees (default 18)."

Added value: +"Number of frames for one full turn (default 24)."

Added value: +"Object name or 'x,y,z' to centre the orbit on (default: the scene's main objects)."

Added value: +"Local folder to save the files in (default ~/janction-render/<job_id>)."

Added value: +{
+  "default": "",
+  "description": "Purpose preset: 'product' (4 studio shots at 0/90/180/270 deg on a plain backdrop; the final gives 4 PNGs at 1440x1440), 'turntable' (one full turn as an MP4, studio light, plain backdrop), 'animation' (the scene's own camera, lights and frame range; the scene is read first when the range is unknown), or '' (none). It fills what you do not pass; environment, orbit_frames, width/height and the frames still win when given.",
+  "title": "Preset",
+  "type": "string"
+}

Added value: +"Cycles samples per pixel (preview: up to 32, default 16; final: default 128)."

Added value: +"scene_id returned by an earlier call (reuses the uploaded scene without sending it again)."

Added value: +"Local path to the scene: a .blend file, a bpy .py script, or a 3D file (.glb/.gltf/.fbx/.usd/.obj/.stl/.ply/.abc, imported into an empty scene). Uploaded once; reuse the returned scene_id afterwards."

Added value: +"The scene as bpy Python code (text). No file and no local Blender needed; the service runs it in Blender 5.0 (5.2 with blender='5.2'). Blender 5.0 API notes: materials are node-based, so set a colour on the Principled BSDF (mat.node_tree.nodes['Principled BSDF'].inputs['Base Color'].default_value = (r, g, b, 1)); mat.diffuse_color only affects the viewport; do not set Material.use_nodes. Animate with obj.keyframe_insert() (action.fcurves no longer exists; set bpy.context.preferences.edit.keyframe_new_interpolation_type = 'LINEAR' first for constant speed). Build the scene, camera and frame range only; leave resolution, samples and denoising to the service. Helpers: `import jr_assets`, then jr_assets.frame_camera(margin=1.1) points the camera at every object and fits them in the frame; jr_assets.import_model('<id>'), jr_assets.material('<id>') and jr_assets.world_hdri('<id>') use Poly Haven assets passed in assets."

Added value: +{
+  "default": "",
+  "description": "https link to a .blend, a .py script or a 3D file (.glb/.gltf/.fbx/.usd/.obj/.stl/.ply/.abc); the service fetches it (e.g. the sample https://render.janction.jp/samples/cube_scene.py, or a 12-hour /upload link). A .gltf or .obj also brings its .bin / .mtl / textures from the same folder.",
+  "title": "Scene Url",
+  "type": "string"
+}

Added value: +"True renders on a transparent background (alpha) for product shots and overlays; png / exr / webm / gif / webp keep it, mp4 and prores cannot. The preview sheet shows it over dark grey."

Added value: +"Output width in pixels (previews are capped at 1280x720 keeping the aspect ratio; a final frame can have at most 1920x1080 pixels on free time, 3840x2160 on prepaid credit)."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Assets"
+}

Added value: +{
+  "default": "",
+  "title": "Blender",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "title": "Engine",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "title": "Environment",
+  "type": "string"
+}

Added value: +{
+  "default": 1,
+  "title": "Environment Strength",
+  "type": "number"
+}

Added value: +{
+  "default": true,
+  "title": "Environment Visible",
+  "type": "boolean"
+}

Added value: +{
+  "default": false,
+  "title": "Orbit",
+  "type": "boolean"
+}

Added value: +{
+  "default": 1,
+  "title": "Orbit Distance",
+  "type": "number"
+}

Added value: +{
+  "default": 18,
+  "title": "Orbit Elevation",
+  "type": "number"
+}

Added value: +{
+  "default": 24,
+  "title": "Orbit Frames",
+  "type": "integer"
+}

Added value: +{
+  "default": "",
+  "title": "Orbit Target",
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "title": "Transparent",
+  "type": "boolean"
+}