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.
鉴权
将 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.
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.
请求体
application/jsonA GPU id from GET /v1/gpu/types.
Stop after this long without a task (5–60, default 15).
Never run longer than this (0.25–24, default 4).
The one-click recipe it is for (informational).
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).
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
路径参数
The machine's id, as listed or created.
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.
路径参数
The machine's id, as listed or created.
请求体
application/jsonscript, render, turntable or export.
script: Blender Python (bpy).
render (or script, to open first): https URL of a .blend or a .zip holding one.
turntable: https URL of a glb, gltf, fbx, obj, stl, ply or usd model.
A frame ("12") or a range ("1-120", back as an MP4).
cycles (default) or eevee.
Cycles samples.
Render width in pixels (with height).
Render height in pixels.
export: blend, glb, fbx, obj, usd; render: mp4 (default) or png frames.
Stop the task after this long (1–180).
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
路径参数
The machine's id, as listed or created.
The run's id.
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
路径参数
The machine's id, as listed or created.
The run's id.
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).
路径参数
The machine's id, as listed or created.
请求体
application/jsonThe file name, its extension included.
Its size.
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.
路径参数
The machine's id, as listed or created.
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" }