Docs

Quickstart

OpenRobotics gives you one endpoint for every robot foundation model. Create an account, create an API key, and send it as a bearer token.

Authentication

Every request carries your key in the Authorization header. Keys start with sk-orb-v1-. Keep them server-side; never ship them in client code.

Authorization: Bearer sk-orb-v1-…

Check a key

GET /api/v1/key returns the key’s name, usage and remaining credit — handy for verifying a key works.

curl https://openrobotics.ai/api/v1/key \
  -H "Authorization: Bearer $OPENROBOTICS_API_KEY"

List models

GET /api/v1/models returns every available model with its type, price and latency.

curl https://openrobotics.ai/api/v1/models

Get actions

POST /api/v1/act takes an instruction plus the robot’s current observation and returns an action chunk. Coming soon — this is the request shape the inference API will use.

import os, base64, requests

obs = {
  "image": base64.b64encode(open("wrist_cam.jpg", "rb").read()).decode(),
  "state": [0.12, -0.48, 0.33, 0.0, 1.57, 0.0, 0.04],   # joints + gripper
}

res = requests.post(
  "https://openrobotics.ai/api/v1/act",
  headers={"Authorization": f"Bearer {os.environ['OPENROBOTICS_API_KEY']}"},
  json={
    "model": "physical-intelligence/pi0",
    "instruction": "pick up the red cup and place it in the sink",
    "observation": obs,
    "action_horizon": 50,
  },
)
actions = res.json()["actions"]   # 50 x 7 action chunk