---
title: "Upload a scene"
method: POST
path: "/v1/files"
---

# Upload a scene

`POST /v1/files`

## Request

- Base URL: `https://render.janction.jp`
- URL: `https://render.janction.jp/v1/files`
- Auth: API key in header `X-API-Key`

multipart/form-data with one `file`: a .blend, a bpy Python script (.py), or a 3D file (glTF/GLB, FBX, USD/USDC/USDZ, OBJ, STL, PLY, Alembic). Returns scene_id. Scripts are checked statically; network, subprocess and similar modules are rejected (400 script_blocked). One request carries up to 100 MB; larger files go in resumable parts (POST /v1/uploads), through the https://render.janction.jp/upload page, or as an https link (POST /v1/files/url, up to 512 MB).

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/janction/apis/janction-render-api.md) · [All operations](https://skmtc.dev/janction/apis/janction-render-api/llms.txt) · [OpenAPI document](https://skmtc.dev/janction/apis/janction-render-api/revisions/a633fd52ea1f?raw)