Render API
Send a project. Clypmint returns a link, how many seconds it should take, and the price.
Base URL: https://clypmint.com/api/v1/render
Auth
Make a key in the dashboard. It is the same account as the B-Roll API. Send it as a bearer token. The command reads CLYPMINT_API_KEY.
Authorization: Bearer cm_live_YOUR_KEYRender
/api/v1/rendersource.kind is the project. out is the picture: width, height, fps, codec and quality (previs, draft or final). Times are seconds. Set dry_run to true to see the price and start nothing. max_usd is the most you will spend. Send the same idempotency_key when you retry.
curl -X POST https://clypmint.com/api/v1/render \
-H "Authorization: Bearer cm_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"source":{"kind":"hyperframes","entry":"index.html","url":"https://example.com/scene.zip"},"out":{"width":1920,"height":1080,"fps":30,"codec":"h264","quality":"draft","audio":true}}'Response
{
"job": "rj_example",
"state": "queued",
"link": "https://media.clypmint.com/r/example/index.m3u8",
"eta_s": 42,
"usd": 0.37
}While it renders, link is a playlist of what is done. When it finishes, link is the file.
Job
/api/v1/render/:job?wait_s=50Long-poll. The answer arrives when the state changes, or when wait_s passes. wait_s is at most 50 seconds. The body matches the render call.
/api/v1/render/:job/cancelStops planning and every running chunk. Pictures already made stay saved.
Stills
/api/v1/render/framesStill pictures at the times you name, in seconds. At most 24 a call. The answer is a signed link for each time.
{
"source": { "kind": "hyperframes", "entry": "index.html", "url": "https://example.com/scene.zip" },
"at_s": [0.5, 3.0, 7.25],
"width": 1280
}Usage
/api/v1/render/usage?limit=25Your renders on the Clypmint API balance, newest first, and the balance itself. For each render: the job, the engine, the seconds of compute that finished, the cents it took and its state. reserved is a quote still held, settled is the final charge, and released gave the whole quote back. limit is 1 to 100. Pass next_cursor as cursor for the next page.
{
"balance": { "name": "Clypmint API balance", "cents": 963, "add_funds": "https://clypmint.com/broll/dashboard" },
"month_cents": 37,
"usage": [
{
"job": "rj_example",
"engine": "chromium",
"worker_class": "CPU",
"seconds": 4.2,
"cents": 1,
"quote_cents": 2,
"state": "settled",
"job_state": "done",
"created_at": "2026-11-10T15:00:00.000Z",
"finished_at": "2026-11-10T15:00:31.000Z"
}
],
"next_cursor": null
}MCP
The server is https://clypmint.com/mcp. Sign in with the same key. Four tools, and render takes the same JSON as the REST call.
| Tool | Does |
|---|---|
render | Start a render. The answer is a link, an ETA in seconds and a price. |
render_frames | Still pictures at the times you name, in seconds. At most 24. |
render_job | Read a render, or wait until it changes. |
render_cancel | Stop a render. Pictures already made stay saved. |
CLI
Set CLYPMINT_API_KEY. clypmint render prints the link, the ETA and the price. --wait stays until the render changes.
npx clypmint render . --res 1920x1080 --fps 30 --quality draft --codec h264 --wait
npx clypmint frames . --at 1.5,3
npx clypmint job <id> --wait
npx clypmint render usageWhat you can send
| Kind | Needs |
|---|---|
hyperframes | index.html and assets. Animations seek, and they register on window.__timelines. |
blender | main.blend and/or scene.py. final uses Cycles. previs and draft use EEVEE unless the file pins one. |
mitsuba | scene.xml or scene.py. The variant is cuda_ad_rgb. |
shader | main.frag, main.wgsl or main.slang, with time, frame and resolution. |
composite | graph.json layers, each with a start and an end in seconds. A layer can cut a subject out. |
film | A Clypmint project id. |
ffmpeg | graph.json with inputs and one filtergraph. |
Remotion stays off until its license is confirmed.
Cut-out, tracking, voice
A composite layer can cut a subject out from a short phrase, a point or a box. Tracking locks type to a surface, or rides a face. Voice finish takes a phone or webcam voice up to a finished track. The quote covers the seconds those steps take.
Pricing
- You pay per second of compute. The quote is the most you pay. Failed chunks and cache hits cost nothing.
- CPU: $0.00004 per core-second. Memory is included.
- L4: $0.0005 a second.
- L40S: $0.0012 a second.
- H100: $0.0025 a second.
- One Clypmint API balance, shared with the B-Roll API. You start with $2. Add from $10 to $1,000. The balance never expires.
- 60 seconds of 1080p HyperFrames is about 1 to 4 cents.
- 60 seconds of 1080p Blender Cycles at 128 samples, on a simple scene, is about $5. A heavier scene costs more, and the quote says so first.
Errors
An error is never a bare code. It names the code, the field when there is one, and a fix.
| Status | Code | Meaning |
|---|---|---|
400 | unknown_field | The field name is wrong. The answer names the nearest field and a fix. |
422 | bad_source | The source is not usable. The answer names the file and line when it can. |
402 | over_budget | The quote is over max_usd. The answer includes the estimate. |
402 | balance_too_low | The Clypmint API balance cannot cover the quote. Add balance, then retry. |
404 | not_found | No render with that id. |
429 | rate_limited | Wait the number of seconds in retry_after_s. |
503 | engine_unavailable | That engine is down. Wait the number of seconds in retry_after_s. |