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" }