DemoAPI.org

Docs / built-in service

A deliberately small API.

Three endpoints, JSON responses, no keys. Use them to test a client or see what a clear demo page can look like.

OpenAPI 3.1

/openapi.json

Quick start

The health endpoint is the smallest complete request:

curl https://demoapi.org/api/demo/model-health

Responses use application/json. POST routes require the same content type and a body no larger than 32 KB.

Local receipts

Want a concrete ComfyUI project that stays entirely on your machine? The Local Run Receipts walkthrough includes a no-model prompt, a loopback-only runner, and the source for the optional custom node.

Endpoints

GET /api/demo/model-health

Check whether a small local model service is ready to take work. Open its request console.

POST /api/demo/vision-job

Preview how an image inspection job would be accepted and scheduled. Open its request console.

POST /api/demo/robot-route

Validate a short waypoint plan before handing it to a robot controller. Open its request console.

Limits

Built-in demo routes allow 20 requests per minute per network address in a running edge instance. This is an abuse brake, not a service-level guarantee. Responses carry Cache-Control: no-store.

Errors

Validation failures return a short JSON error and an appropriate HTTP status. Unsupported content types return 415, large bodies return 413, and request caps return 429. Error responses do not include stack traces or environment details.