# JANCTION Render（中文）

> 面向 AI 智能体的 Blender 云端 GPU 渲染服务。输入 .blend、bpy 脚本或 3D 文件（glTF/GLB、FBX、USD、OBJ、STL），几秒内得到带点评的预览，用户确认后渲染最终帧或 MP4。无需本地 GPU 或 Blender，无需注册。最完整的说明是英文版：https://render.janction.jp/llms.txt

## 何时使用
- 用户想渲染、预览、做动画或 360 度转台展示一个 Blender 场景或 3D 模型，而本机没有 NVIDIA GPU 或本地渲染太慢。
- 不适用：编辑用户本机打开的 Blender（用本地 Blender MCP）；非 Blender 的视频或其他 GPU 任务。

## 连接
- 远程 MCP（Streamable HTTP）：https://render.janction.jp/mcp?src=zh，请求头 `Authorization: Bearer jr_…`。支持 OAuth 的客户端可不带请求头，首次调用会打开授权页面并自动生成免费密钥。适用于支持远程 MCP 的客户端，例如 Trae、通义灵码、腾讯云 CodeBuddy、文心快码 Comate、Cherry Studio、Kimi Code、Qwen Code。
- 只支持 stdio：`npx -y janction-render`，环境变量 `JANCTION_RENDER_API_KEY=jr_…`。
- 命令行：`pip install janction-render` → `janction-render try`、`janction-render preview <文件或URL>`、`janction-render final <文件或URL>`。
- 没有 MCP 的平台（扣子（Coze）、Dify、GPTs 等）：导入 OpenAPI https://render.janction.jp/openapi-actions.json，API Key 放在请求头 `X-API-Key`。

## 密钥
- `curl -X POST https://render.janction.jp/v1/keys` 返回 `api_key`（jr_ 开头），无需注册。也可在 https://render.janction.jp/start 生成。
- 不要把密钥写进公开的文件或聊天记录。

## 流程（MCP 工具）
1. 第一次调用：render_preview(scene_url='https://render.janction.jp/samples/cube_scene.py', environment='compare') 检查连接。
2. render_preview：几秒出图并附点评与修复代码；修改后再次预览。
3. 询问用户；时间长或额度不确定时先 render_estimate，并把预计时间和费用告诉用户。
4. render_final → render_download(job_id, wait_seconds=45)，直到拿到链接。
- 预设：preset='product'（4 张棚拍）| 'turntable'（360 度 MP4）| 'animation'（场景自身的帧范围）。没有模型时用 asset_search。
- 脚本：Blender 5.0 的 bpy；只构建场景、相机和帧范围（分辨率和采样由服务设置）。`import jr_assets; jr_assets.frame_camera()` 可让相机框住所有物体。

## HTTP API（不用 MCP 时）
- POST /v1/try：没有密钥也能渲染第一张预览，并返回密钥。
- POST /v1/jobs {scene_url 或 scene_script, kind: preview|final, …} → job_id；GET /v1/jobs/{job_id} → 状态和结果链接（view_url 无需密钥即可打开）。
- POST /v1/estimate：渲染前估算 GPU 秒和费用。
- 完整 API：https://render.janction.jp/openapi.json

## 价格
- 每个新密钥赠送 100 日元的 GPU 时间（无需绑卡，14 天内有效）。
- 在不扣款的页面保存银行卡后，再赠送 400 日元（每张卡一次）。
- 之后按每 GPU 秒 0.1 日元从预付余额扣除；预览每天 2 分钟 GPU 时间以内免费。
- 只有在用户同意后才开始收费的渲染；预估费用可先用 render_estimate（或 POST /v1/estimate）查看。

## 限制
- 最终渲染：每次指令最多 3,000 帧（自动内部分段，同一个 job id）；免费额度最高 1080p (1920x1080)，预付余额最高 4K (3840x2160)。
- 文件大小：分段上传的 .blend 免费密钥最多 1,024 MB，累计实际付款 500 日元以上的密钥最多 5,120 MB；其他 3D 文件和脚本最多 512 MB。
- 结果文件在最后一次使用后保留 24 小时（累计付款 500 日元以上的密钥通常 7 天）。

## 国内安装
- pip：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple janction-render`
- npm：`npx --registry=https://registry.npmmirror.com -y janction-render`

运营：JasmyLab Inc.（日本）。支付使用信用卡（Stripe），以日元结算。