Senlay — API Documentation

API Documentation

Give any AI agent real-time physical world awareness with one API call

Overview

Senlay provides the Physical World Model — a real-time, multi-layered representation of physical reality at any coordinate on Earth. One API call gives your AI agent complete environmental awareness: atmosphere, ocean, terrain, air quality, and satellite observation.

Authentication

Authorization: Bearer sl_live_your_key_here

Get your key: senlay.world/register

Endpoint: GET /api/v1/pwm

Returns the complete Physical World Model for any location.

Parameters

Parameter	Required	Description
`lat`	Yes	Latitude (-90 to 90)
`lng`	Yes	Longitude (-180 to 180)

Response

The response includes:

pwm — Raw sensor data with all 5 layers (atmosphere, hydrosphere, terrain, air_quality)
satellite — Sentinel-2 imagery metadata + Google satellite URL (if configured)
context_string — Pre-formatted text ready to inject into any AI system prompt
tier — Your account tier
requests_today / daily_limit — Usage tracking

Example Request

curl -H "Authorization: Bearer sl_live_your_key" \
  "https://senlay.world/api/v1/pwm?lat=36.01&lng=-5.60"

Quick Start with Claude

import anthropic, requests

# 1. Get Physical World Model from Senlay
pwm = requests.get(
    "https://senlay.world/api/v1/pwm",
    params={"lat": 36.01, "lng": -5.60},
    headers={"Authorization": "Bearer sl_live_your_key"}
).json()

# 2. Give your AI physical senses
client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    system=f"You have real-time physical world awareness:\n\n{pwm['context_string']}",
    messages=[{"role": "user", "content": "Is it safe to kitesurf here right now?"}]
)
print(response.content[0].text)

Quick Start with OpenAI

from openai import OpenAI
import requests

pwm = requests.get(
    "https://senlay.world/api/v1/pwm",
    params={"lat": 36.01, "lng": -5.60},
    headers={"Authorization": "Bearer sl_live_your_key"}
).json()

client = OpenAI()
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": f"Physical World Model:\n\n{pwm['context_string']}"},
        {"role": "user", "content": "Should I fly my drone here today?"}
    ]
)
print(response.choices[0].message.content)

Quick Start with JavaScript

const pwmRes = await fetch(
  "https://senlay.world/api/v1/pwm?lat=36.01&lng=-5.60",
  { headers: { Authorization: "Bearer sl_live_your_key" } }
);
const pwm = await pwmRes.json();

// Inject into any AI provider's system prompt:
const systemPrompt = `You are aware of the physical world:\n\n${pwm.context_string}`;

// Works with Claude, OpenAI, Gemini, Llama, Mistral — any LLM.

Physical World Model Layers

Layer	Data	Source
Atmosphere	Wind, temperature, pressure, humidity, clouds, 24h forecast	Open-Meteo
Hydrosphere	Waves, swell, period, direction (coastal locations)	Open-Meteo Marine
Lithosphere / Bathymetry	Elevation or ocean depth, 9-point terrain profile	Open-Meteo Elevation
Air Quality	PM2.5, PM10, UV index, European AQI	Open-Meteo Air Quality
Satellite	Sentinel-2 imagery metadata, Google satellite view	Copernicus, Google

Rate Limits

Tier	Daily Limit	Price
Free	100 requests/day	$0
Pro	10,000 requests/day	Contact us
Enterprise	Unlimited	Contact us

Use Cases

Water sports AI — kitesurfing, surfing, sailing condition analysis
Drone operations — flight safety assessment from wind + terrain
Agriculture — crop management from weather + soil + satellite
Search & rescue — drift prediction from currents + wind + bathymetry
Construction — weather-dependent scheduling
Environmental monitoring — coastline erosion, air quality, water clarity
Any AI agent — that needs to understand the physical world

Get Your API Key