eroq

Platform

GPU machines

Rent a cloud computer with a GPU and Blender, billed by the second, driven task by task.

RTX 5090 292, L40S 460, RTX PRO 6000 1136, H100 1853, B300 3794 credits per hour, billed by the second

A GPU machine is a cloud computer prepared with Blender 5.2 (Cycles on the GPU through OptiX). You never get a shell: you send it tasks and get files back. GET /v1/gpu/types lists the GPUs with their price per hour, POST /v1/gpu/machines launches one (1–3 minutes to come up; tasks sent meanwhile wait for it).

Tasks. script runs your Blender Python (bpy) on the machine's scene, which persists from one task to the next, then renders a preview (only bpy, bmesh, mathutils, math and a few pure modules import; no file, network or OS access). render renders a .blend (or a .zip holding one) given by file — a frame ("12") or a range ("1-120", back as an MP4). turntable puts a 3D model (model: glb, gltf, fbx, obj, stl, ply, usd) on a studio backdrop and turns the camera around it. export sends the scene back as .blend, .glb, .fbx, .obj or .usd (in a .zip). Files are signed links, kept 7 days after the machine stops. To send your own file, POST /v1/gpu/machines/{id}/files returns a presigned put URL and the url to pass as file or model.

Billing. By the second, from launch until the machine stops: five minutes are taken at launch and topped up while it runs, the unused part comes back at the stop. It stops by itself after idle_minutes without a task (5–60, default 15), at max_hours (0.25–24, default 4) or when the balance runs out. Paid plans only (Hobby and up); two machines per workspace.

인증

Authorizationstringheader필수

API 키를 Bearer 토큰으로 보내요: Bearer eroq_sk_…. 키는 키 페이지에서 만들 수 있어요.

The GPUs, their price per hour, the task kinds and the one-click recipes

The GPUs, their price per hour, the task kinds and the one-click recipes. No key needed.

GET/v1/gpu/types
The GPUs, their price per hour, the task kinds and the one-click recipes
curl https://eroq.ai/v1/gpu/types \
  -H "Authorization: Bearer $EROQ_API_KEY"
{
"object": "list",
"data": [{ "id": "l40s", "name": "L40S", "vram_gb": 48, "credits_per_hour": 460, "credits_at_launch": 39, "best_for": "Heavy scenes that need 48 GB" }],
"software": [{ "id": "blender", "name": "Blender", "version": "5.2" }]
}

Launch a machine

Launch a machine: takes its first five minutes, returns it starting.

POST/v1/gpu/machines

본문

application/json
gpustring필수

A GPU id from GET /v1/gpu/types.

idle_minutesnumber

Stop after this long without a task (5–60, default 15).

max_hoursnumber

Never run longer than this (0.25–24, default 4).

recipestring

The one-click recipe it is for (informational).

Launch a machine
curl https://eroq.ai/v1/gpu/machines \
  -H "Authorization: Bearer $EROQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "gpu": "l40s",
  "idle_minutes": 15,
  "max_hours": 4
}'
{ "id": "gpu_150619b208e436e1", "object": "gpu.machine", "status": "starting", "gpu": { "id": "l40s", "name": "L40S", "vram_gb": 48 }, "credits_per_hour": 460, "credits_prepaid": 39, "seconds": 0 }

Your machines, newest first

Your machines, newest first (?open=1: the running ones).

GET/v1/gpu/machines
Your machines, newest first
curl https://eroq.ai/v1/gpu/machines \
  -H "Authorization: Bearer $EROQ_API_KEY"
{ "object": "list", "data": [{ "id": "gpu_150619b208e436e1", "status": "ready", "seconds": 204, "credits_spent": 27 }] }

One machine, its meter and its tasks

GET/v1/gpu/machines/{id}

경로 매개변수

idstring필수

The machine's id, as listed or created.

One machine, its meter and its tasks
curl https://eroq.ai/v1/gpu/machines/MACHINE_ID \
  -H "Authorization: Bearer $EROQ_API_KEY"
{ "id": "gpu_150619b208e436e1", "object": "gpu.machine", "status": "ready", "blender": "5.2.4", "device": { "name": "NVIDIA L40S", "util": 97 }, "seconds": 204, "credits_spent": 27, "runs": [] }

Send a task

Send a task (202): it runs as soon as the machine is free.

POST/v1/gpu/machines/{id}/runs

경로 매개변수

idstring필수

The machine's id, as listed or created.

본문

application/json
kindstring필수

script, render, turntable or export.

codestring

script: Blender Python (bpy).

filestring

render (or script, to open first): https URL of a .blend or a .zip holding one.

modelstring

turntable: https URL of a glb, gltf, fbx, obj, stl, ply or usd model.

framesstring

A frame ("12") or a range ("1-120", back as an MP4).

enginestring

cycles (default) or eevee.

samplesinteger

Cycles samples.

widthinteger

Render width in pixels (with height).

heightinteger

Render height in pixels.

formatstring

export: blend, glb, fbx, obj, usd; render: mp4 (default) or png frames.

timeout_minutesnumber

Stop the task after this long (1–180).

Send a task
curl https://eroq.ai/v1/gpu/machines/MACHINE_ID/runs \
  -H "Authorization: Bearer $EROQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "script",
  "code": "import bpy\nbpy.ops.mesh.primitive_monkey_add(size=2)\n"
}'
{ "id": "run_efc85d997a9ab677", "object": "gpu.run", "kind": "script", "status": "queued", "progress": 0, "outputs": [] }

A task, its log, what Blender saw and its files

GET/v1/gpu/machines/{id}/runs/{run}

경로 매개변수

idstring필수

The machine's id, as listed or created.

runstring필수

The run's id.

A task, its log, what Blender saw and its files
curl https://eroq.ai/v1/gpu/machines/MACHINE_ID/runs/{run} \
  -H "Authorization: Bearer $EROQ_API_KEY"
{ "id": "run_efc85d997a9ab677", "object": "gpu.run", "status": "succeeded", "result": { "backend": "optix", "scene": { "object_count": 4 } }, "outputs": [{ "name": "preview.png", "bytes": 172161, "url": "https://cdn.eroq.ai/…" }] }

Cancel a waiting or running task

POST/v1/gpu/machines/{id}/runs/{run}/cancel

경로 매개변수

idstring필수

The machine's id, as listed or created.

runstring필수

The run's id.

Cancel a waiting or running task
curl -X POST https://eroq.ai/v1/gpu/machines/MACHINE_ID/runs/{run}/cancel \
  -H "Authorization: Bearer $EROQ_API_KEY"
{ "id": "run_efc85d997a9ab677", "status": "canceled" }

A presigned upload for a file the machine will use

A presigned upload for a file the machine will use (.blend, .zip, 3D model, up to 5 GB).

POST/v1/gpu/machines/{id}/files

경로 매개변수

idstring필수

The machine's id, as listed or created.

본문

application/json
namestring필수

The file name, its extension included.

bytesinteger필수

Its size.

A presigned upload for a file the machine will use
curl https://eroq.ai/v1/gpu/machines/MACHINE_ID/files \
  -H "Authorization: Bearer $EROQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "scene.blend",
  "bytes": 48211200
}'
{ "name": "scene.blend", "put": "https://…(PUT the bytes here)", "url": "https://cdn.eroq.ai/…(pass as file)" }

Stop the machine

Stop the machine: billed to the second, the rest goes back.

POST/v1/gpu/machines/{id}/stop

경로 매개변수

idstring필수

The machine's id, as listed or created.

Stop the machine
curl -X POST https://eroq.ai/v1/gpu/machines/MACHINE_ID/stop \
  -H "Authorization: Bearer $EROQ_API_KEY"
{ "id": "gpu_150619b208e436e1", "status": "stopped", "seconds": 204, "credits_spent": 27, "credits_prepaid": 78, "stop_reason": "user" }