Docs

API

Render from your own scripts, tools and agents. The REST API and the MCP server use the same credits, entitlements and refunds as the studio. API access is part of the paid plans: you need a plan or a credit pack to create a key.

API keys

Create and revoke keys at app.3dstudio.co/account/api. You must be signed in.
A key starts with tds_live_ and is shown once, when you create it. We store only a hash of it, so we cannot show it again. If you lose a key, revoke it and create a new one.
Each account can have 10 active keys and can create 10 new keys a day.
Paid status is checked on every request. If the plan or purchase behind a key ends, the key stops working.
Send the key in the header Authorization: Bearer YOUR_API_KEY. Keep it out of public code.

REST endpoints

Base address: https://app.3dstudio.co. Answers are JSON.

Method	Path	What it does
`POST`	`/api/v1/render`	Make a render. Paid accounts only. Multipart (field image) or JSON (image_url). Fields: look, notes (up to 400 characters), quality (standard or hd), lock (locked, balanced, loose), input (untextured, textured, render), materials (keep, restyle), seed. The call returns when the render is done, which can take up to about two minutes.
`GET`	`/api/v1/renders?limit=10`	Your newest renders, limit 1 to 50.
`GET`	`/api/v1/renders/{id}`	Status and image link of one render.
`GET`	`/api/v1/looks`	The values the look field accepts. Public, no key needed.

Pictures: JPG, PNG or WebP, under 10 MB. An image_url must be a public https link. Credits: Standard is 5 and HD is 10 per render. A render that fails is refunded.

Example

curl https://app.3dstudio.co/api/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F image=@view.png \
  -F look=ext-daylight \
  -F quality=standard

The answer contains id, status, image_url, quality, look, credits (left) and credits_charged. Use the id with GET /api/v1/renders/{id} to read it again later. Changing and relighting a render are available through the MCP server, not the REST API.

Errors

Errors are JSON with an error message and, where it helps, a code or reason.

Status	Meaning
`400`	Unknown look, bad quality value, or no image sent.
`401`	The key is missing, not valid or was revoked.
`402`	Out of credits (`code: out_of_credits`, with the credits you have and the number needed).
`403`	The account is not paid yet (`reason: upgrade`).
`415`	The file is not a JPG, PNG or WebP, or is over 10 MB.
`429`	Too many renders (`code: rate_limited`), with a `Retry-After` header in seconds.
`503`	The service is not available right now.

Rate limits

REST: 20 renders per 10 minutes per account, however many keys it has. Reads (listing renders, getting one render, looks) are not counted.
MCP: 20 renders, changes and relights an hour per paid account and 5 an hour for free accounts.
Each render call runs until the render is done, which can take up to about two minutes. Set a long enough timeout in your client.

MCP for agents

The remote MCP server is at https://app.3dstudio.co/api/mcp (Streamable HTTP, JSON responses). Chat apps such as ChatGPT and Claude sign in with OAuth, see ChatGPT and Claude. Agents and scripts can send an API key as a Bearer token instead.

Tools: render_screenshot, start_upload, change_render, relight, list_looks, get_credits, list_renders, get_render. Each has a title and read-only or write hints, and the full list with arguments and costs is on the connector page. A change costs 5 credits in Standard or 10 in HD, and a relight costs 10.

OAuth discovery metadata is published at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server.

Questions

Write to hello@3dstudio.co.