janction-jp Try API

openapi: 3.2.0
info:
  title: JANCTION Render Try API
  description: 'JANCTION Render is a cloud GPU render farm for Blender that AI agents call as an MCP server or HTTP API: .blend, bpy scripts and 3D files (glTF/FBX/USD/OBJ) in, frames or an MP4 out, on JANCTION NVIDIA GPUs. No key yet? POST /v1/try renders a first preview and returns a key. Flow: POST /v1/keys -> POST /v1/files -> POST /v1/estimate -> POST /v1/jobs -> GET /v1/jobs/{id} -> GET /v1/jobs/{id}/artifacts/{name}. The same service is an MCP server at /mcp. Human guide: /blender-render-api. Agent guide: /llms.txt.'
  version: 0.4.211
  x-limits:
  - id: frames_per_call
    value: 3000
    unit: frames
    applies_to:
    - render_final
    - POST /v1/jobs
    - POST /v1/estimate
    alternative: split the range into several calls of up to 3,000 frames (frame_start / frame_end)
  - id: frames_per_part
    value: 240
    unit: frames
    applies_to:
    - render_final
    - POST /v1/jobs
    alternative: 'nothing to do: a final longer than 240 frames runs as parts under one job id and comes back as one video'
  - id: resolution_free_time
    value: 2073600
    unit: pixels_per_frame
    applies_to:
    - render_final
    - POST /v1/jobs
    alternative: buy any credit to open 3840x2160, or render at 1920x1080 and upscale
    display: 1920x1080
  - id: resolution_prepaid_credit
    value: 8294400
    unit: pixels_per_frame
    applies_to:
    - render_final
    - POST /v1/jobs
    alternative: 'no larger frame is offered: render the shot as several cameras or crops and join them'
    display: 3840x2160
  - id: preview_resolution
    value: 921600
    unit: pixels_per_frame
    applies_to:
    - render_preview
    - render_review
    alternative: previews are scaled down to this size; use render_final for the full size
    display: 1280x720
  - id: preview_frames
    value: 4
    unit: frames
    applies_to:
    - render_preview
    alternative: use render_final with a frame range for more frames
  - id: job_gpu_time
    value: 36000
    unit: gpu_seconds
    applies_to:
    - render_final
    - POST /v1/jobs
    alternative: split the frames over several jobs, or lower samples / resolution (render_estimate tells the time first)
  - id: upload_one_request
    value: 100
    unit: MB
    applies_to:
    - POST /v1/files
    - https://render.janction.jp/upload form
    alternative: 'larger files: the CLI and the local (stdio) MCP send them in resumable parts (POST /v1/uploads), the https://render.janction.jp/upload page does the same in a browser, or pass a public https link as scene_url'
  - id: upload_by_link
    value: 512
    unit: MB
    applies_to:
    - scene_url
    - POST /v1/files/url
    alternative: put the file on the https://render.janction.jp/upload page (resumable parts) instead
  - id: asset_size
    value: 128
    unit: MB
    applies_to:
    - assets
    - asset_urls
    - POST /v1/files/{id}/assets
    alternative: lower the texture resolution, compress it, or pack it into the .blend
  - id: script_size
    value: 2
    unit: MB
    applies_to:
    - scene_script
    - .py scenes
    alternative: 'keep data out of the script: send it as assets or build the scene into a .blend'
  - id: remote_mcp_local_files
    value: false
    unit: boolean
    applies_to:
    - remote MCP (Claude.ai, ChatGPT and other connectors)
    alternative: 'a remote MCP server cannot read files on the user''s computer: the user drops the file on https://render.janction.jp/upload and passes the link it shows as scene_url, or uses the CLI, the local (stdio) MCP server or the Blender add-on'
  - id: upload_link_lifetime
    value: 12
    unit: hours
    applies_to:
    - https://render.janction.jp/upload links
    alternative: use the link within this time (a job that uses it keeps the scene); upload again after it expires
  - id: files_kept
    value: 24
    unit: hours_after_last_use
    applies_to:
    - scenes
    - results
    - download links
    alternative: download the results before then; a key that has paid 500 JPY or more in total keeps them 7 days (normally); asking for the job again gives fresh links while the files are kept
  - id: blend_resumable_upload
    value: 1024
    unit: MB
    applies_to:
    - POST /v1/uploads
    - CLI
    - local (stdio) MCP
    - https://render.janction.jp/upload
    alternative: a key that has paid 500 JPY or more in total sends up to 5120 MB (saving a card alone does not open it; keys that had it through a saved card before 2026-10-14 keep it)
    paid: 5120
    with_card_or_credit: 5120
    with_card_or_credit_note: former name of paid, kept for older readers
servers:
- url: https://render.janction.jp
security:
- ApiKeyAuth: []
tags:
- name: Try
paths:
  /v1/try:
    post:
      summary: First preview without a key
      description: Render once without a key. JSON {scene_script | scene_url, frames?, width?, height?, samples?, camera?, environment?, blender?, engine?}. Renders a 720p preview and returns the image links together with an API key created for you (label 'guest'); use it as X-API-Key afterwards. One free try per network per 24 hours, then POST /v1/keys. Waits up to about a minute; if the GPU is lent out it returns the queued job and the key (poll GET /v1/jobs/{id}).
      operationId: try_preview_v1_try_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Try Preview V1 Try Post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                scene_script:
                  type: string
                scene_url:
                  type: string
                  format: uri
                frames:
                  items:
                    type: integer
                  type: array
                  description: 'preview: 1-4 frame numbers'
                width:
                  type: integer
                  description: 'final: at most 1920x1080 pixels per frame on free time, 3840x2160 with prepaid credit; preview: scaled to 1280x720'
                height:
                  type: integer
                  description: 'final: at most 1920x1080 pixels per frame on free time, 3840x2160 with prepaid credit; preview: scaled to 1280x720'
                samples:
                  type: integer
                camera:
                  type: string
                environment:
                  type: string
                blender:
                  type: string
                engine:
                  type: string
      tags:
      - Try
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
externalDocs:
  url: https://render.janction.jp/llms.txt
  description: Guides for agents (llms.txt) and humans (/blender-render-api)