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/modelsGet 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