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.

Header
Authorization: Bearer cm_live_YOUR_KEY

Render

POST/api/v1/render

source.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

200
{
  "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

GET/api/v1/render/:job?wait_s=50

Long-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.

POST/api/v1/render/:job/cancel

Stops planning and every running chunk. Pictures already made stay saved.

Stills

POST/api/v1/render/frames

Still pictures at the times you name, in seconds. At most 24 a call. The answer is a signed link for each time.

JSON
{
  "source": { "kind": "hyperframes", "entry": "index.html", "url": "https://example.com/scene.zip" },
  "at_s": [0.5, 3.0, 7.25],
  "width": 1280
}

Usage

GET/api/v1/render/usage?limit=25

Your 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.

200
{
  "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.

ToolDoes
renderStart a render. The answer is a link, an ETA in seconds and a price.
render_framesStill pictures at the times you name, in seconds. At most 24.
render_jobRead a render, or wait until it changes.
render_cancelStop 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.

bash
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 usage

What you can send

KindNeeds
hyperframesindex.html and assets. Animations seek, and they register on window.__timelines.
blendermain.blend and/or scene.py. final uses Cycles. previs and draft use EEVEE unless the file pins one.
mitsubascene.xml or scene.py. The variant is cuda_ad_rgb.
shadermain.frag, main.wgsl or main.slang, with time, frame and resolution.
compositegraph.json layers, each with a start and an end in seconds. A layer can cut a subject out.
filmA Clypmint project id.
ffmpeggraph.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.

StatusCodeMeaning
400unknown_fieldThe field name is wrong. The answer names the nearest field and a fix.
422bad_sourceThe source is not usable. The answer names the file and line when it can.
402over_budgetThe quote is over max_usd. The answer includes the estimate.
402balance_too_lowThe Clypmint API balance cannot cover the quote. Add balance, then retry.
404not_foundNo render with that id.
429rate_limitedWait the number of seconds in retry_after_s.
503engine_unavailableThat engine is down. Wait the number of seconds in retry_after_s.