The Gale AI API brings Tomorrow.io's weather intelligence to your application. Ask weather questions in plain language and generate 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 link. |
| Weather summary | POST /v4/gale-ai/summary | Get a weather summary for a location across a specific time window. |
Usage & Quota
Gale AI API access is a premium API. If you receive an authorization error, contact your Tomorrow.io account manager to have it enabled.
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 | 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 | Defines the 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": "..." } }. |