{"openapi":"3.1.0","info":{"title":"JANCTION Render 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.257","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"}],"paths":{"/v1/":{"get":{"summary":"Api Root","operationId":"api_root_v1__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stats":{"get":{"summary":"Public Stats","operationId":"public_stats_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/pricing":{"get":{"summary":"Public Pricing","operationId":"public_pricing_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/health":{"get":{"summary":"Service status","operationId":"health_route_v1_health_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Health Route V1 Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Workers, queue, whether the GPU is lent out, supported inputs/presets/Blender versions, 7-day stats, lanes (preview / final workers, queued chunks, oldest wait). No key needed.","security":[]}},"/v1/capabilities":{"get":{"summary":"V1 Capabilities","operationId":"v1_capabilities_v1_capabilities_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys":{"post":{"summary":"Create an API key","operationId":"create_key_v1_keys_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Key V1 Keys Post"}}}}},"description":"Creates a key (new keys start with free GPU time, see GET /v1/pricing; then the metered price per GPU-second in GET /v1/pricing from prepaid credit). Body: optional {\"label\"}. Send the returned api_key as the X-API-Key header on every other call.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string"},"source":{"type":"string"},"found_via":{"type":"string"}}}}}}}},"/v1/keys/revoke":{"post":{"summary":"Revoke this key","description":"Use when a key leaked. The key and every app connected with it stop working at once.","operationId":"revoke_own_key_v1_keys_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Own Key V1 Keys Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/rotate":{"post":{"summary":"Rotate Own Key","operationId":"rotate_own_key_v1_keys_rotate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/current":{"delete":{"summary":"Revoke Current Key","operationId":"revoke_current_key_v1_keys_current_delete","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Current Key V1 Keys Current Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/data":{"delete":{"summary":"Erase my inputs and results now","description":"Deletes every scene, render and share page of this key immediately instead of waiting for the retention period. Running jobs are cancelled first. The billing ledger and the key stay (revoke the key with POST /v1/keys/revoke). Backups keep a copy for up to 14 days.","operationId":"erase_my_data_v1_me_data_delete","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Erase My Data V1 Me Data Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connections":{"get":{"summary":"Apps connected with this key","operationId":"list_connections_v1_connections_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Connections V1 Connections Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"OAuth connections (Claude, ChatGPT, Codex...) made with this key: app name, where it returns, last use."}},"/v1/connections/{conn_id}":{"delete":{"summary":"Disconnect one app","description":"Revokes that app's token only.","operationId":"disconnect_v1_connections__conn_id__delete","parameters":[{"name":"conn_id","in":"path","required":true,"schema":{"type":"string","title":"Conn Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Disconnect V1 Connections  Conn Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/card":{"post":{"summary":"Billing Card","operationId":"billing_card_v1_billing_card_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Billing Card V1 Billing Card Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"summary":"Usage, free GPU time today and credit for this key","operationId":"me_v1_me_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Me V1 Me Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/limits":{"post":{"summary":"Set My Limits","operationId":"set_my_limits_v1_me_limits_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set My Limits V1 Me Limits Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_yen":{"type":"integer"},"day_yen":{"type":"integer"}}}}}}}},"/v1/me/email":{"post":{"summary":"Set My Email","operationId":"set_my_email_v1_me_email_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set My Email V1 Me Email Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete My Email","operationId":"delete_my_email_v1_me_email_delete","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete My Email V1 Me Email Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/email/confirm":{"get":{"summary":"Email Confirm Page","operationId":"email_confirm_page_v1_email_confirm_get","parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string","default":"","title":"T"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Email Confirm Page V1 Email Confirm Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Email Confirm","operationId":"email_confirm_v1_email_confirm_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Email Confirm V1 Email Confirm Post"}}}}}}},"/v1/email/unsubscribe":{"get":{"summary":"Email Unsubscribe Page","operationId":"email_unsubscribe_page_v1_email_unsubscribe_get","parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string","default":"","title":"T"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Email Unsubscribe Page V1 Email Unsubscribe Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Email Unsubscribe","operationId":"email_unsubscribe_v1_email_unsubscribe_post","parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string","default":"","title":"T"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Email Unsubscribe V1 Email Unsubscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files":{"post":{"summary":"Upload a scene","operationId":"upload_file_v1_files_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_v1_files_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload File V1 Files Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"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)."}},"/v1/files/lookup":{"get":{"summary":"Find an earlier upload by sha256","description":"Query `sha256`; returns the scene_id if this key already uploaded the same bytes.","operationId":"lookup_file_v1_files_lookup_get","parameters":[{"name":"sha256","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sha256"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Lookup File V1 Files Lookup Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}":{"get":{"summary":"Scene details","operationId":"get_file_v1_files__file_id__get","parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get File V1 Files  File Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/url":{"post":{"summary":"Upload File From Url","operationId":"upload_file_from_url_v1_files_url_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload File From Url V1 Files Url Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"description":"https link to a .blend, .py or 3D file","format":"uri","type":"string"},"asset_urls":{"items":{"type":"string"},"type":"array"}},"required":["url"]}}}}}},"/v1/files/{file_id}/assets":{"post":{"summary":"Add companion files to a scene","description":"multipart `files`: textures, .bin buffers, .mtl and similar that the scene references.","operationId":"upload_assets_v1_files__file_id__assets_post","parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_assets_v1_files__file_id__assets_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Assets V1 Files  File Id  Assets Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/assets/search":{"get":{"summary":"Search CC0 assets on Poly Haven","description":"q (words), kind (models | textures | hdris). Results carry spec 'polyhaven:<id>' and the entry file; pass the spec as an asset URL.","operationId":"assets_search_v1_assets_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","default":"models","title":"Kind"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Assets Search V1 Assets Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/manifest":{"post":{"summary":"Scene Manifest","operationId":"scene_manifest_v1_files__file_id__manifest_post","parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Scene Manifest V1 Files  File Id  Manifest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{file_id}/assets/urls":{"post":{"summary":"Add assets by URL or Poly Haven id","description":"{\"urls\": [\"https://...\", \"polyhaven:wooden_table_02\"]}; Poly Haven files land under <id>/ next to the scene.","operationId":"add_assets_urls_v1_files__file_id__assets_urls_post","parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Add Assets Urls V1 Files  File Id  Assets Urls Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/uploads":{"options":{"summary":"Upload Options","operationId":"upload_options_v1_uploads_options","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Start an upload in parts","operationId":"create_upload_v1_uploads_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}},{"name":"upload-length","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload-Length"}},{"name":"upload-metadata","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload-Metadata"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Opens a resumable upload (tus 1.0) for a large .blend or 3D file: send Upload-Length and the file name (Upload-Metadata), then PATCH the bytes in order. Over the limit it answers 413 upload_limit with the current and paid limits and a top-up link."}},"/v1/uploads/limits":{"get":{"summary":"How big a file this key can send","operationId":"upload_limits_v1_uploads_limits_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Limits V1 Uploads Limits Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"The largest .blend and other 3D file this key can upload in parts, the part size and how long an upload can stay open. Free keys send .blend files up to 1 GB; keys that have paid 500 JPY or more in total up to 5 GB."}},"/v1/uploads/{upload_id}":{"head":{"summary":"Where an upload stopped","operationId":"head_upload_v1_uploads__upload_id__head","parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Returns Upload-Offset: how many bytes the server has, so an interrupted upload continues from there with PATCH."},"get":{"summary":"Upload status","operationId":"get_upload_v1_uploads__upload_id__get","parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Upload V1 Uploads  Upload Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"The upload's size, bytes received, state and, once complete and checked, the scene_id to render."},"delete":{"summary":"Cancel an upload","operationId":"delete_upload_v1_uploads__upload_id__delete","parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Stops an unfinished upload and deletes the bytes received so far."},"patch":{"summary":"Send the next part","operationId":"patch_upload_v1_uploads__upload_id__patch","parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}},{"name":"upload-offset","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload-Offset"}},{"name":"upload-checksum","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload-Checksum"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Appends bytes at Upload-Offset (Content-Type application/offset+octet-stream). When the last part arrives the server checks the file (sha256, format) and turns it into a scene."}},"/v1/jobs/{job_id}/share":{"post":{"summary":"Share a finished render as a public page","description":"{title?, note?, include_script?, listed?} -> {share_id, url}; the page keeps the image/video after the job expires, until DELETE.","operationId":"share_job_v1_jobs__job_id__share_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Share Job V1 Jobs  Job Id  Share Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"note":{"type":"string"},"prompt":{"type":"string"},"include_script":{"type":"boolean"},"listed":{"type":"boolean"}}}}}}},"delete":{"summary":"Remove the share page","operationId":"unshare_job_v1_jobs__job_id__share_delete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unshare Job V1 Jobs  Job Id  Share Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shares":{"get":{"summary":"Your share pages","operationId":"my_shares_v1_shares_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response My Shares V1 Shares Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/feedback":{"post":{"summary":"Job Feedback","operationId":"job_feedback_v1_jobs__job_id__feedback_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Job Feedback V1 Jobs  Job Id  Feedback Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Job Feedback Get","operationId":"job_feedback_get_v1_jobs__job_id__feedback_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Job Feedback Get V1 Jobs  Job Id  Feedback Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shares/{share_id}/script":{"get":{"summary":"Share Script","operationId":"share_script_v1_shares__share_id__script_get","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"string","title":"Share Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/batches":{"post":{"summary":"Submit many renders at once (e.g. a product catalog)","description":"Body: {items: [{ref, scene_url | scene_id, outcome?, job?, notify_url?}], outcome?: turntable|product-shot, defaults?: {...}, notify_url?}. Up to 100 items. Returns 202 with batch_id; each item is fetched and submitted in the background (same quota and limits as single jobs; an item that fails gets its own error and the rest continue). Idempotency-Key supported.","operationId":"create_batch_v1_batches_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Your recent batches","operationId":"list_batches_v1_batches_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Batches V1 Batches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/batches/{batch_id}":{"get":{"summary":"Batch status","operationId":"get_batch_v1_batches__batch_id__get","parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string","title":"Batch Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Batch V1 Batches  Batch Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Per item: pending / submitted (job_id and job status) / error, and totals. Poll every 10-30 s."}},"/v1/batches/{batch_id}/retry":{"post":{"summary":"Submit only the failed items again","description":"Items that rendered or are rendering are left alone (nothing is drawn or charged twice). By default only failures that can succeed on a retry; body {refs?: [...], include_non_retryable?: bool}. Up to 3 retries per item.","operationId":"retry_batch_v1_batches__batch_id__retry_post","parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string","title":"Batch Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Retry Batch V1 Batches  Batch Id  Retry Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/outcomes":{"get":{"summary":"Outcomes Catalog","operationId":"outcomes_catalog_v1_outcomes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Outcomes Catalog V1 Outcomes Get"}}}}}}},"/v1/outcomes/{name}":{"post":{"summary":"Submit Outcome","operationId":"submit_outcome_v1_outcomes__name__post","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks":{"post":{"summary":"Submit Task","operationId":"submit_task_v1_tasks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Task V1 Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks/{task_id}":{"get":{"summary":"Get Task","operationId":"get_task_v1_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task V1 Tasks  Task Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs":{"post":{"summary":"Submit a render job","operationId":"submit_job_v1_jobs_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Job V1 Jobs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Body: {scene_id, kind: preview|final|info, frames: [..] (preview) or frame_start/frame_end (final), width, height, samples, engine: cycles|eevee, output: png|exr (frames) or mp4|webm|prores|gif|webp (video) or blend (the built scene as a .blend, not rendered, free), transparent (alpha background; png/exr/webm/gif/webp), notify_url (https; one JSON POST when the job finishes), fps, camera, environment: studio|sunset|overcast|night|compare, environment_strength, environment_visible, blender: 5.0|5.2, orbit, orbit_frames, orbit_elevation, orbit_target, orbit_distance, preset: product|turntable|animation (fills the camera, light, backdrop, frames and output for that purpose; what you pass wins)}. Returns job_id, status and eta.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scene_id":{"type":"string","description":"from POST /v1/files, POST /v1/files/url or an earlier job; or send scene_script / scene_url instead"},"scene_script":{"type":"string","description":"the scene as bpy Python code (text), used when scene_id is absent"},"scene_url":{"type":"string","description":"https link to a .blend, .py or 3D file, used when scene_id is absent","format":"uri"},"asset_urls":{"items":{"type":"string"},"type":"array","description":"extra files with scene_script / scene_url: https links or 'polyhaven:<id>' CC0 assets"},"kind":{"enum":["preview","final","info"],"type":"string"},"frames":{"items":{"type":"integer"},"type":"array","description":"preview: 1-4 frame numbers"},"frame_start":{"type":"integer"},"frame_end":{"type":"integer","description":"final: up to 3,000 frames per call (frame_start..frame_end); longer than 240 runs as parts under one job id"},"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"},"fps":{"type":"integer"},"output":{"enum":["auto","png","exr","mp4","webm","prores","gif","webp","blend","prores4444"],"type":"string"},"camera":{"type":"string"},"cameras":{"items":{"type":"string"},"type":"array"},"environment":{"enum":["","studio","sunset","overcast","night","compare"],"type":"string"},"environment_strength":{"type":"number"},"environment_visible":{"type":"boolean"},"blender":{"enum":["","5.0","5.2"],"type":"string"},"engine":{"enum":["","cycles","eevee"],"type":"string"},"transparent":{"type":"boolean"},"orbit":{"type":"boolean"},"orbit_frames":{"type":"integer"},"orbit_elevation":{"type":"number"},"orbit_target":{"type":"string"},"orbit_distance":{"type":"number"},"preset":{"enum":["","product","turntable","animation"],"type":"string"},"max_yen":{"type":"integer","description":"ceiling for this job; 0 = only if it fits the free time"},"notify_url":{"type":"string","description":"https; one signed POST when the job finishes","format":"uri"},"compare_to":{"type":"string","description":"final only: job_id of an earlier final of this key (j_... or b_...); when this render finishes the job also has compare.mp4 (before / after side by side, frames matched by number), compare.gif, compare.png and compare.json (change score per frame, most changed frames). Missing or expired files are explained in compare, the render itself still finishes"},"passes":{"type":"array","items":{"type":"string","enum":["depth","mist","normal","diffuse","glossy","emission","ao","shadow_catcher","crypto_object","crypto_material"]},"description":"final only, Cycles: render passes for compositing. Each frame becomes one multilayer OpenEXR (frame_NNNN.exr) holding the denoised beauty and these passes; output must be 'exr' or 'auto'. passes.json lists the layers found in the files"},"variations":{"type":"array","items":{"type":"object","additionalProperties":false,"description":"one variant; anything left out uses the job's own settings","properties":{"label":{"type":"string","maxLength":40,"description":"short text on the tile (default: what the variant changes)"},"environment":{"type":"string","enum":["","studio","sunset","overcast","night"]},"environment_strength":{"type":"number","exclusiveMinimum":0,"maximum":10},"camera":{"type":"string","description":"an existing camera object name"},"colors":{"type":"object","additionalProperties":{"description":"'#rrggbb' / '#rrggbbaa' (sRGB, like Blender's colour picker) or [r, g, b] / [r, g, b, a] (linear, 0-1)","anyOf":[{"type":"string","pattern":"^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"},{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":3,"maxItems":4}]},"maxProperties":16,"description":"object name -> colour"}}},"minItems":2,"maxItems":8,"description":"preview only: 2-8 variants of one frame, each rendered on its own GPU and tiled in one labelled sheet; the job lists each variant's render_final arguments. Not with cameras, orbit or environment='compare'"},"colors":{"type":"object","additionalProperties":{"description":"'#rrggbb' / '#rrggbbaa' (sRGB, like Blender's colour picker) or [r, g, b] / [r, g, b, a] (linear, 0-1)","anyOf":[{"type":"string","pattern":"^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"},{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":3,"maxItems":4}]},"description":"object name -> colour for its material's Principled Base Color (a copy per render; the scene file is unchanged)"},"deliver":{"type":"array","items":{"type":"string","enum":["x","vertical","square"]},"description":"final animations only: extra MP4s made from the rendered frames on the server (no extra GPU time). x = H.264 + silent AAC that fits X (up to 2 min 20 s, 512 MB, 1920x1080 or 1280x720, yuv420p, faststart) as social_x.mp4; vertical = 1080x1920 (social_vertical.mp4); square = 1080x1080 (social_square.mp4). The whole frame is kept on a blurred fill, nothing is cropped"},"auto_samples":{"type":"boolean","description":"final, Cycles: pick the samples automatically (samples is then the maximum). A small test render of one frame runs first, billed like a preview; POST /v1/estimate shows its cost and the possible saving"},"probe_frame":{"type":"integer","description":"auto_samples: the frame to test (default: the middle frame)"}}}}}}},"get":{"summary":"List recent jobs","operationId":"list_jobs_v1_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"summary","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Summary"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Jobs V1 Jobs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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"}}}}}}}},"/v1/estimate":{"post":{"summary":"Estimate GPU seconds before rendering","description":"Same body as POST /v1/jobs. Returns seconds, a human sentence, quota headroom and queue state.","operationId":"estimate_job_v1_estimate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Estimate Job V1 Estimate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scene_id":{"type":"string","description":"from POST /v1/files, POST /v1/files/url or an earlier job; or send scene_script / scene_url instead"},"scene_script":{"type":"string","description":"the scene as bpy Python code (text), used when scene_id is absent"},"scene_url":{"type":"string","description":"https link to a .blend, .py or 3D file, used when scene_id is absent","format":"uri"},"asset_urls":{"items":{"type":"string"},"type":"array","description":"extra files with scene_script / scene_url: https links or 'polyhaven:<id>' CC0 assets"},"kind":{"enum":["preview","final","info"],"type":"string"},"frames":{"items":{"type":"integer"},"type":"array","description":"preview: 1-4 frame numbers"},"frame_start":{"type":"integer"},"frame_end":{"type":"integer","description":"final: up to 3,000 frames per call (frame_start..frame_end); longer than 240 runs as parts under one job id"},"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"},"fps":{"type":"integer"},"output":{"enum":["auto","png","exr","mp4","webm","prores","gif","webp","blend","prores4444"],"type":"string"},"camera":{"type":"string"},"cameras":{"items":{"type":"string"},"type":"array"},"environment":{"enum":["","studio","sunset","overcast","night","compare"],"type":"string"},"environment_strength":{"type":"number"},"environment_visible":{"type":"boolean"},"blender":{"enum":["","5.0","5.2"],"type":"string"},"engine":{"enum":["","cycles","eevee"],"type":"string"},"transparent":{"type":"boolean"},"orbit":{"type":"boolean"},"orbit_frames":{"type":"integer"},"orbit_elevation":{"type":"number"},"orbit_target":{"type":"string"},"orbit_distance":{"type":"number"},"preset":{"enum":["","product","turntable","animation"],"type":"string"},"max_yen":{"type":"integer","description":"ceiling for this job; 0 = only if it fits the free time"},"compare_to":{"type":"string","description":"final only: job_id of an earlier final of this key (j_... or b_...); when this render finishes the job also has compare.mp4 (before / after side by side, frames matched by number), compare.gif, compare.png and compare.json (change score per frame, most changed frames). Missing or expired files are explained in compare, the render itself still finishes"},"passes":{"type":"array","items":{"type":"string","enum":["depth","mist","normal","diffuse","glossy","emission","ao","shadow_catcher","crypto_object","crypto_material"]},"description":"final only, Cycles: render passes for compositing. Each frame becomes one multilayer OpenEXR (frame_NNNN.exr) holding the denoised beauty and these passes; output must be 'exr' or 'auto'. passes.json lists the layers found in the files"},"variations":{"type":"array","items":{"type":"object","additionalProperties":false,"description":"one variant; anything left out uses the job's own settings","properties":{"label":{"type":"string","maxLength":40,"description":"short text on the tile (default: what the variant changes)"},"environment":{"type":"string","enum":["","studio","sunset","overcast","night"]},"environment_strength":{"type":"number","exclusiveMinimum":0,"maximum":10},"camera":{"type":"string","description":"an existing camera object name"},"colors":{"type":"object","additionalProperties":{"description":"'#rrggbb' / '#rrggbbaa' (sRGB, like Blender's colour picker) or [r, g, b] / [r, g, b, a] (linear, 0-1)","anyOf":[{"type":"string","pattern":"^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"},{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":3,"maxItems":4}]},"maxProperties":16,"description":"object name -> colour"}}},"minItems":2,"maxItems":8,"description":"preview only: 2-8 variants of one frame, each rendered on its own GPU and tiled in one labelled sheet; the job lists each variant's render_final arguments. Not with cameras, orbit or environment='compare'"},"colors":{"type":"object","additionalProperties":{"description":"'#rrggbb' / '#rrggbbaa' (sRGB, like Blender's colour picker) or [r, g, b] / [r, g, b, a] (linear, 0-1)","anyOf":[{"type":"string","pattern":"^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"},{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":3,"maxItems":4}]},"description":"object name -> colour for its material's Principled Base Color (a copy per render; the scene file is unchanged)"},"deliver":{"type":"array","items":{"type":"string","enum":["x","vertical","square"]},"description":"final animations only: extra MP4s made from the rendered frames on the server (no extra GPU time). x = H.264 + silent AAC that fits X (up to 2 min 20 s, 512 MB, 1920x1080 or 1280x720, yuv420p, faststart) as social_x.mp4; vertical = 1080x1920 (social_vertical.mp4); square = 1080x1080 (social_square.mp4). The whole frame is kept on a blurred fill, nothing is cropped"},"auto_samples":{"type":"boolean","description":"final, Cycles: pick the samples automatically (samples is then the maximum). A small test render of one frame runs first, billed like a preview; POST /v1/estimate shows its cost and the possible saving"},"probe_frame":{"type":"integer","description":"auto_samples: the frame to test (default: the middle frame)"}}}}}}}},"/v1/jobs/{job_id}":{"get":{"summary":"Job status","operationId":"get_job_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Job V1 Jobs  Job Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"status queued|running|done|failed|canceled, progress, eta, artifacts (each with view_url, a signed link that opens without a key), warnings. A finished final also carries delivery_report: verdict deliverable|check|problem with plain reasons (frames, video, black frames, flicker, grain); the full check is the artifact report.json, with a contact sheet report_sheet.png."},"delete":{"summary":"Cancel Job","operationId":"cancel_job_v1_jobs__job_id__delete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Job V1 Jobs  Job Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/next-actions":{"get":{"summary":"Job Next Actions","operationId":"job_next_actions_v1_jobs__job_id__next_actions_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Job Next Actions V1 Jobs  Job Id  Next Actions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/recipe":{"get":{"summary":"Job Recipe","operationId":"job_recipe_v1_jobs__job_id__recipe_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Job Recipe V1 Jobs  Job Id  Recipe Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/storage/save":{"post":{"summary":"Storage Save","operationId":"storage_save_v1_jobs__job_id__storage_save_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Storage Save V1 Jobs  Job Id  Storage Save Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/cancel":{"post":{"summary":"Cancel a job","operationId":"cancel_job_post_v1_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Job Post V1 Jobs  Job Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/scenes/{scene_id}/preflight":{"post":{"summary":"Scene Preflight","operationId":"scene_preflight_v1_scenes__scene_id__preflight_post","parameters":[{"name":"scene_id","in":"path","required":true,"schema":{"type":"string","title":"Scene Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Scene Preflight V1 Scenes  Scene Id  Preflight Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/artifacts/{name}":{"get":{"summary":"Download an artifact","operationId":"get_artifact_v1_jobs__job_id__artifacts__name__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"sheet.png (preview), frame_0001.png / .exr..., output.mp4 / .webm / .mov / .gif / .webp, log.txt (the last part of Blender's output, kept for finished and failed jobs alike). Needs X-API-Key; without one, use the artifact's view_url."}},"/v1/jobs/{job_id}/archive":{"get":{"summary":"Download every file of a job as one zip","description":"Stored, not compressed. only=png,exr keeps those extensions. Use it for frame sequences: fetching hundreds of frames one by one runs into the rate limit (429). Needs X-API-Key.","operationId":"get_archive_v1_jobs__job_id__archive_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"only","in":"query","required":false,"schema":{"type":"string","default":"","title":"Only"}},{"name":"first","in":"query","required":false,"schema":{"type":"string","default":"","title":"First"}},{"name":"last","in":"query","required":false,"schema":{"type":"string","default":"","title":"Last"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ui/events":{"post":{"summary":"Ui Event","operationId":"ui_event_v1_ui_events_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ui Event V1 Ui Events Post"}}}}}}},"/v1/drops":{"post":{"summary":"Create Drop","operationId":"create_drop_v1_drops_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_drop_v1_drops_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/start/aifix":{"post":{"summary":"Start Aifix","operationId":"start_aifix_v1_start_aifix_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Start Aifix V1 Start Aifix Post"}}}}}}},"/v1/billing/checkout":{"post":{"summary":"Billing Checkout","operationId":"billing_checkout_v1_billing_checkout_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Billing Checkout V1 Billing Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_yen":{"type":"integer"}},"required":["amount_yen"]}}}}}},"/v1/billing/x402/topup":{"post":{"summary":"Billing X402 Topup","operationId":"billing_x402_topup_v1_billing_x402_topup_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/sync":{"post":{"summary":"Billing Sync","operationId":"billing_sync_v1_billing_sync_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Billing Sync V1 Billing Sync Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/success":{"get":{"summary":"Billing Success","operationId":"billing_success_v1_billing_success_get","parameters":[{"name":"session_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Session Id"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","default":"","title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/cancel":{"get":{"summary":"Billing Cancel","operationId":"billing_cancel_v1_billing_cancel_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","default":"","title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/webhook":{"post":{"summary":"Billing Webhook","operationId":"billing_webhook_v1_billing_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Webhook V1 Billing Webhook Post"}}}}}}},"/v1/ledger":{"get":{"summary":"Ledger","operationId":"ledger_v1_ledger_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ledger V1 Ledger Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/autocharge":{"get":{"summary":"Get Autocharge","operationId":"get_autocharge_v1_billing_autocharge_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Autocharge V1 Billing Autocharge Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Post Autocharge","operationId":"post_autocharge_v1_billing_autocharge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Autocharge V1 Billing Autocharge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/autocharge/off":{"post":{"summary":"Post Autocharge Off","operationId":"post_autocharge_off_v1_billing_autocharge_off_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Autocharge Off V1 Billing Autocharge Off Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/plans":{"get":{"summary":"Get Plans","operationId":"get_plans_v1_billing_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Plans V1 Billing Plans Get"}}}}}}},"/v1/billing/subscribe":{"post":{"summary":"Post Subscribe","operationId":"post_subscribe_v1_billing_subscribe_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Subscribe V1 Billing Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/subscription/cancel":{"post":{"summary":"Post Subscription Cancel","operationId":"post_subscription_cancel_v1_billing_subscription_cancel_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Subscription Cancel V1 Billing Subscription Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/portal":{"post":{"summary":"Post Portal","operationId":"post_portal_v1_billing_portal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Portal V1 Billing Portal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/storage-grants":{"get":{"summary":"My Grants","operationId":"my_grants_v1_me_storage_grants_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response My Grants V1 Me Storage Grants Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/storage-grants/{grant_id}/revoke":{"post":{"summary":"My Grant Revoke","operationId":"my_grant_revoke_v1_me_storage_grants__grant_id__revoke_post","parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response My Grant Revoke V1 Me Storage Grants  Grant Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_create_drop_v1_drops_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"html":{"type":"string","title":"Html","default":""},"lang":{"type":"string","title":"Lang","default":"en"}},"type":"object","required":["file"],"title":"Body_create_drop_v1_drops_post"},"Body_upload_assets_v1_files__file_id__assets_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"}},"type":"object","required":["files"],"title":"Body_upload_assets_v1_files__file_id__assets_post"},"Body_upload_file_v1_files_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_v1_files_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"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)"},"security":[{"ApiKeyAuth":[]}]}