Resumo do clima com IA

AI Weather Summary

O endpoint /summary gera narrativas climaticas usando inteligencia artificial. Suporta 3 periodos (today, tomorrow, week) e 3 idiomas (pt, en, es). Os textos sao escritos em linguagem natural, prontos para exibicao direta na sua interface.

The /summary endpoint generates AI-powered weather narratives. It supports 3 periods (today, tomorrow, week) and 3 languages (pt, en, es). The texts are written in natural language, ready for direct display in your UI.

1. Buscar resumo / Get summary

O endpoint recebe a cidade, o periodo e o idioma desejado: 

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://weather.api.insyde.one';

async function getWeatherSummary(city, period = 'today', lang = 'pt') {
  const url = `${BASE}/summary?city=${city}&period=${period}&lang=${lang}&key=${API_KEY}`;
  const res = await fetch(url);
  return res.json();
}

const summary = await getWeatherSummary('São Paulo', 'today', 'pt');

2. Parametros / Parameters

ParametroObrigatorioDescricao / Description
citySim / YesNome da cidade / City name
periodNao / Notoday, tomorrow ou week (padrao: today) / Default: today
langNao / Nopt, en ou es (padrao: pt) / Default: pt

3. Resposta da API / API Response

Exemplo de resposta para Sao Paulo com periodo today e idioma pt: 

{
  "city": "São Paulo",
  "period": "today",
  "language": "pt",
  "title": "Pancadas de chuva refrescam São Paulo nesta terça",
  "subtitle": "Temperatura cai 5 graus após frente fria; guarda-chuva é indispensável",
  "summary": "Dia chuvoso com máxima de 24°C e mínima de 18°C. Chuva forte no período da tarde.",
  "text": "São Paulo amanhece com céu nublado e sensação térmica de 19°C..."
}
Dica: Os resumos sao gerados uma vez por combinacao de cidade + periodo + idioma e cacheados permanentemente no Bunny Storage. Chamadas subsequentes retornam o conteudo cacheado instantaneamente.
Tip: Summaries are generated once per city+period+lang and cached permanently on Bunny Storage. Subsequent calls return the cached content instantly.

4. Exemplo completo / Complete example

const periods = ['today', 'tomorrow', 'week'];

async function showAllPeriods(city, lang = 'pt') {
  for (const period of periods) {
    const data = await getWeatherSummary(city, period, lang);

    console.log(`\n--- ${period.toUpperCase()} ---`);
    console.log(data.title);
    console.log(data.subtitle);
    console.log(`[${data.summary}]`);
    console.log(data.text);
  }
}

showAllPeriods('São Paulo', 'pt');

Back to Weather API docs