Four steps from grid to paths. Any language, any framework.
Send your 2D grid to /v1/precompute. GridViper builds an optimized navigation structure. This is a one-time cost per grid layout — typically under a second for game-sized maps.
Call /v1/path with a start and goal. Each query reuses the precomputed structure, so response times are consistently fast regardless of grid size. Change goals every tick with no restart cost.
Use /v1/replan when goals change mid-movement. Unlike traditional pathfinders that restart from scratch, GridViper serves new paths from the existing navigation structure. This is where the 8–13× speedup comes from.
For game loops, use /v1/path/batch to send all agent queries in a single HTTP request. For coordinated movement with collision avoidance, use /v1/multi-agent. Both keep your frame budget predictable.
Three curl commands to go from zero to pathfinding.
1. Precompute a grid
curl -X POST https://api.gridviper.com/v1/precompute \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"grid_id":"demo","grid":[[0,0,0,0,0],[0,1,1,0,0],[0,0,0,1,0],[0,1,0,0,0],[0,0,0,0,0]]}'
2. Find a path
curl -X POST https://api.gridviper.com/v1/path \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"grid_id":"demo","start":[0,0],"goal":[4,4]}'
3. Replan to a new goal
curl -X POST https://api.gridviper.com/v1/replan \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"grid_id":"demo","start":[2,2],"goal":[0,4]}'
Ready to try it?
Get Free API Key →API status: api.gridviper.com/health