NAV
shell python

Introduction

Welcome to the Zeus AI API! You can use our API to access our continuous weather forecasts and historical datasets.

We have language bindings in Shell and Python. You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Authentication

To authorize, use this code:

# With shell, you can just pass the correct header with each request
curl "http://api.myzeus.ai/" \
  -H "Authorization: myzeusapikey"

Make sure to replace myzeusapikey with your API key.

Zeus AI expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: myzeusapikey

Helios

Helios is a nowcasting system that forecasts from the present time, updated every hour, up to 6-hours ahead. The forecasting model is continous in time and can be integrated at any temporal resolution. This provides a real-time and continous forecasting system.

GET http://api.myzeus.ai/helios/?latitude=42.36&longitude=-71.05

Variables

Version 1.0 variables listed below. See http://api.myzeus.ai/helios/variables for prior versions.

Name Units Description
ghi W/m^2 Global horizontal irradiance
dni W/m^2 Direct normalized irradiance
dhi W/m^2 Direct horizontal irradiance

Query Parameters

import requests

url = "https://api.myzeus.ai/helios/?latitude=41&longitude=-90&runtime=202504032000"
headers = {'x-api-key': myzeusapikey}
response = requests.request("GET", url, headers=headers)
print(response.text)

curl "http://api.myzeus.ai/helios/" \
  -H "x-api-key: myzeusapikey"

The above command returns JSON structured like this:

{
  "attrs": {
    "created_time": "2025-04-03T20:23:44"
  },
  "dims": {
    "valid_time": 7
  },
  "data_vars": {
    "dhi": {
      "dims": [
        "valid_time"
      ],
      "attrs": {
        "units": "W m-2"
      },
      "data": [
        140.25,
        130.12,
        48.72,
        6.99,
        0.34,
        0.49,
        0
      ]
    },
    "dni": {
      "dims": [
        "valid_time"
      ],
      "attrs": {
        "units": "W m-2"
      },
      "data": [
        6.24,
        43.53,
        15.12,
        1.94,
        0.68,
        0.99,
        0.52
      ]
    },
    "ghi": {
      "dims": [
        "valid_time"
      ],
      "attrs": {
        "units": "W m-2"
      },
      "data": [
        143.5,
        146.62,
        51.16,
        8.28,
        1.15,
        0.21,
        0.85
      ]
    }
  },
  "latitude": 42.38,
  "longitude": -71.06,
  "runtime": "2025-04-03T20:00:00",
  "valid_time": {
    "dims": [
      "valid_time"
    ],
    "attrs": {},
    "data": [
      "2025-04-03T20:00:00",
      "2025-04-03T21:00:00",
      "2025-04-03T22:00:00",
      "2025-04-03T23:00:00",
      "2025-04-04T00:00:00",
      "2025-04-04T01:00:00",
      "2025-04-04T02:00:00"
    ]
  }
}
Parameter Description
latitude Latitude default: 42.36
longitude Longitude default: -71.05
runtime default: Most recent time (format '%Y%m%d%H%M')
vars Meterological variables to select from forecast. default: All

Errors

The Zeus AI API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
shell python