API changelog

October 28, 2026

• Changed A render’s file keeps the format the model made it in, PNG or JPEG, and its file name and Content-Type now say which. Before, a JPEG could be stored and served as .png.
• Changed At most 3 renders run at once per workspace, as documented; a large batch could start more than that before.
• Changed POST /scenes refuses a setting other than indoor or outdoor with 422 invalid_request, rather than reading it as indoors. A request refused for its body no longer counts toward the 500 a day.
• Changed An image_url served with the wrong Content-Type (a JPEG sent as application/octet-stream, say) is read by its bytes and accepted.
• Changed A refused batch names the scene or product to fix: Scene 42 is not in your workspace., or the scene a surface or a repeat is in.
• Changed A fault on our side while checking a key, adding a scene or creating renders answers 500 server_error in the documented error shape.
• Docs What a failed scene means, that material_type is other rather than null when unknown, when upscale_status is null, and both 401 types on every reference page.

October 21, 2026

• Added Renders have an upscale_status, so a request that asked for an upscale can tell whether its image is upscaled. See Upscaling.
• Added A workspace can add up to 500 scenes a day through the API. Past that, POST /scenes answers 429 rate_limited until midnight UTC.
• Changed A render for a product that is not in your workspace now always answers 404 not_found. Without a surface_id it could answer 422 about the surface before.
• Changed A workspace with no credits is told so, with 402 insufficient_credits, rather than that it has used all 0 of them.
• Changed A render request that could not be charged for a reason on our side now answers 500 server_error, with nothing charged, where it could answer 404.
• Docs These API docs are published.

Version 1

The first version of the API, in early access, with 8 endpoints:

• GET /me Retrieve your account
• GET /products List all products
• GET /scenes List all scenes
• POST /scenes Create a scene
• GET /scenes/{id} Retrieve a scene
• POST /renders Create renders
• GET /renders/{id} Retrieve a render
• DELETE /renders/{id} Cancel a render