PV Forecast Service
Global Solar Power Prediction Platform
Global Solar Power Prediction Platform
When setting up new PV projects, please consider the following model guidelines to achieve the highest prediction accuracy:
Provide precise latitude, longitude, and correct timezone name (e.g. Australia/Adelaide). Weather parameters are automatically pulled from Open-Meteo.
DC power calculations use the NMOT reference (e.g. 800 W/m² at 45°C). Avoid shifting cell temperature reference coefficients without understanding thermal coefficients.
To compare predicted vs. actual metrics, verify the upload CSV matches the format: 时间戳,Solar Power(kW) in local site timezone.
Input coordinates below to get real-time weather and forecasts directly from our global meteorological engine, independent of any project.
Our server runs at http://localhost:8004. To query programmatically or feed forecast JSON arrays to EMS optimization algorithms, authenticate your calls with your API Key.
# Include the API key in headers:
X-API-Key: <YOUR_API_KEY>
To acquire the prediction sequence as a JSON array (rather than downloading a file), specify format=json in the request parameters.
GET /api/v1/forecasts/{forecast_id}/data?format=json
# Sample Response Structure:
{
"forecast_id": "8a72b53b-ad2b-4fa8-bdc1-1e9a3b6fc8e2",
"data": [
{
"time": "2026-06-11 08:00:00+09:30",
"power_kw": 1256.40,
"poa_global": 340.50,
"cell_temp": 18.40,
"temp_air": 12.00,
"cloud_cover": 20
},
...
]
}
To inspect endpoints and execute schema testing, access the auto-generated documentation endpoints. Both endpoints are protected by HTTP Basic Authentication (configured in config.py).
Use the following token to interface external EMS systems directly with our forecasting engines:
********
curl -X POST "http://localhost:8004/api/v1/forecasts" \
-H "X-API-Key: <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"project_id": "YOUR_PROJECT_ID",
"start_date": "2026-06-11",
"end_date": "2026-06-17",
"resolution": "15min"
}'