name: senseaudio-weather-broadcast description: Fetch weather data and generate a spoken weather broadcast using SenseAudio TTS. metadata: openclaw: emoji: "🌤️" requires: env: - SENSEAUDIO_API_KEY bins: - curl - jq primaryEnv: SENSEAUDIO_API_KEY homepage: https://senseaudio.cn/docs

Weather Broadcast / 天氣播報

Fetch real-time weather data and generate a natural-sounding weather broadcast audio using SenseAudio TTS.

獲取即時天氣資料，並使用 SenseAudio TTS 生成自然流暢的天氣播報音訊。

Quick Start / 快速開始

1. Get Weather + Generate Broadcast / 獲取天氣並生成播報

# Set your API key / 設定 API 金鑰
export SENSEAUDIO_API_KEY="your_api_key"

# Fetch weather and generate broadcast for Beijing / 獲取北京天氣並生成播報
CITY="Beijing"
WEATHER=$(curl -s "wttr.in/${CITY}?format=%l:+%c+%t+%h+%w&lang=zh")

# Generate broadcast text / 生成播報文本
BROADCAST_TEXT="天氣播報：${WEATHER}。祝您出行愉快！"

# Call SenseAudio TTS / 呼叫 SenseAudio TTS
curl -X POST https://api.senseaudio.cn/v1/t2a_v2 \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"SenseAudio-TTS-1.0\",
    \"text\": \"$BROADCAST_TEXT\",
    \"stream\": false,
    \"voice_setting\": {
      \"voice_id\": \"male_0004_a\",
      \"speed\": 0.95
    },
    \"audio_setting\": {
      \"format\": \"mp3\",
      \"sample_rate\": 32000
    }
  }" -o response.json

# Extract and save audio / 提取並儲存音訊
jq -r '.data.audio' response.json | xxd -r -p > weather_broadcast.mp3

Weather Data Sources / 天氣資料來源

wttr.in (Primary / 主要)

Free weather service, no API key required. / 免費天氣服務，無需 API 金鑰。

# Quick one-liner / 快速查詢
curl -s "wttr.in/Shanghai?format=3"
# Output: Shanghai: ⛅️ +18°C

# Detailed format / 詳細格式
curl -s "wttr.in/Shanghai?format=%l:+%c+%t+%h+%w"
# Output: Shanghai: ⛅️ +18°C 65% ↙12km/h

# Chinese output / 中文輸出
curl -s "wttr.in/上海?lang=zh&format=3"

Format codes / 格式程式碼: - %c condition / 天氣狀況 - %t temperature / 溫度 - %h humidity / 溼度 - %w wind / 風速 - %l location / 地點 - %m moon phase / 月相

Options / 選項: - ?lang=zh Chinese / 中文 - ?m metric / 公制 - ?1 today only / 僅今天 - ?0 current only / 僅當前

Open-Meteo (Fallback / 備用)

Free JSON API for programmatic use. / 免費 JSON API，適合程式化使用。

# Get coordinates first, then query / 先獲取座標，再查詢
# Beijing: 39.9, 116.4
curl -s "https://api.open-meteo.com/v1/forecast?latitude=39.9&longitude=116.4&current_weather=true"

Complete Python Example / 完整 Python 示例

import requests
import os

SENSEAUDIO_API_KEY = os.environ.get("SENSEAUDIO_API_KEY")
TTS_URL = "https://api.senseaudio.cn/v1/t2a_v2"

def get_weather(city: str, lang: str = "zh") -> str:
    """Fetch weather from wttr.in / 從 wttr.in 獲取天氣"""
    url = f"https://wttr.in/{city}?format=%l:+%c+%t+%h+%w&lang={lang}"
    resp = requests.get(url, timeout=10)
    return resp.text.strip()

def generate_broadcast_text(weather: str, lang: str = "zh") -> str:
    """Generate broadcast script / 生成播報文本"""
    if lang == "zh":
        return f"天氣播報：{weather}。<break time=300>請根據天氣情況合理安排出行，祝您生活愉快！"
    else:
        return f"Weather report: {weather}. <break time=300>Please plan your day accordingly. Have a great day!"

def text_to_speech(text: str, output_file: str = "weather_broadcast.mp3", voice_id: str = "male_0004_a"):
    """Convert text to speech using SenseAudio TTS / 使用 SenseAudio TTS 轉換文本為語音"""
    headers = {
        "Authorization": f"Bearer {SENSEAUDIO_API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "model": "SenseAudio-TTS-1.0",
        "text": text,
        "stream": False,
        "voice_setting": {
            "voice_id": voice_id,
            "speed": 0.95,
            "vol": 1.0,
            "pitch": 0
        },
        "audio_setting": {
            "format": "mp3",
            "sample_rate": 32000
        }
    }

    resp = requests.post(TTS_URL, json=payload, headers=headers, timeout=30)
    result = resp.json()

    if result.get("data") and result["data"].get("audio"):
        audio_bytes = bytes.fromhex(result["data"]["audio"])
        with open(output_file, "wb") as f:
            f.write(audio_bytes)
        print(f"Audio saved: {output_file}")
        print(f"Duration: {result['extra_info']['audio_length']}ms")
        return output_file
    else:
        raise Exception(f"TTS failed: {result.get('base_resp', {}).get('status_msg', 'Unknown error')}")

def weather_broadcast(city: str, output_file: str = "weather_broadcast.mp3", lang: str = "zh"):
    """Main function: fetch weather and generate broadcast / 主函式：獲取天氣並生成播報"""
    print(f"Fetching weather for {city}...")
    weather = get_weather(city, lang)
    print(f"Weather: {weather}")

    broadcast_text = generate_broadcast_text(weather, lang)
    print(f"Broadcast text: {broadcast_text}")

    print("Generating audio...")
    return text_to_speech(broadcast_text, output_file)

if __name__ == "__main__":
    # Example usage / 示例用法
    weather_broadcast("Beijing", "beijing_weather.mp3", "zh")
    # weather_broadcast("London", "london_weather.mp3", "en")
7w4.net有更好的技能外掛。

Voice Options / 音色選項

See SenseAudio Voice List for all available voices.

檢視 SenseAudio 音色列表 獲取所有可用音色。

TTS Parameters / TTS 引數

Audio Output / 音訊輸出

Tips / 提示

1. Use <break time=500> to add pauses in broadcast / 使用 <break time=500> 在播報中新增停頓
2. Set speed: 0.95 for clearer broadcast / 設定 speed: 0.95 使播報更清晰
3. URL-encode city names with spaces: New+York / 城市名有空格時需 URL 編碼
4. Use ?lang=zh for Chinese weather descriptions / 使用 ?lang=zh 獲取中文天氣描述

Error Handling / 錯誤處理

try:
    weather_broadcast("Beijing")
except requests.exceptions.Timeout:
    print("Request timeout, please retry")
except Exception as e:
    print(f"Error: {e}")

Related / 相關資源

• SenseAudio TTS API
• wttr.in Help
• Open-Meteo Docs

這是一款實用且文件友好的天氣播報工具，能快速將天氣資訊轉化為語音播報。優點是使用簡單、示例豐富，支援中英文雙語，並提供了備用資料來源保證穩定性。不足之處在於功能相對基礎，缺少自動化配置和錯誤提示機制，對新手使用者不太友好。總體而言，適合有技術基礎的使用者快速上手使用。