The Gale AI API brings Tomorrow.io's weather intelligence to your application. Ask weather questions in plain language and generate structured weather summaries- no need to assemble raw data yourself.
Endpoints
| Endpoint | Method | Purpose |
|---|---|---|
| Ask a weather question | POST /v4/gale-ai/chat | Ask a natural-language weather question and get a conversational answer. Supports multi-turn conversations and optional map links. |
| Weather summary | POST /v4/gale-ai/summary | Get a structured weather summary for a location across a specific time window. |
Enabling accessGale AI API access is a premium API. If you receive an authorization error, contact your Tomorrow.io account manager to have it enabled.
Usage & Quota
Each successful call consumes one Gale interaction from your account's quota. Validation errors (400/404) do not count against your quota.
- Every response returns your remaining balance in the
X-Quota-Remaining-Galeheader. - When your balance reaches zero, requests return
402 Payment Requiredwith error codeGALE_QUOTA_LIMIT_REACHED.
Common Conventions
These apply to both endpoints:
| Concept | Notes |
|---|---|
| Response envelope | Successful responses wrap the payload in a data object. Every response includes a request id — include it when contacting support. |
| Units | units accepts metric (default) or imperial. |
| Language | language overrides your account's default response language. |
| Timezone | timezone accepts an IANA zone (e.g. America/New_York) and anchors all time phrasing. Invalid zones return 400. Omit to use the location's local timezone. |
| Errors | Error responses use the shape { "data": { "error": "..." } }. |