Govee API Key: beantragen, testen und in Home Assistant nutzen

Für die meisten Govee-Lampen brauchst du keinen API-Schlüssel: Die LAN-Steuerung und Matter laufen lokal und ganz ohne Key. Es gibt aber Geräte, die beides nicht können. Meine Govee H6008 mit Hardware 1.02.01 ist so ein Fall – sie hat weder den Schalter „LAN Steuerung“ noch Matter. Für solche Lampen, für Szenen und Segmente und für eigene Skripte führt der Weg über die offizielle Govee-API. Und dafür brauchst du den Govee API Key.

In dieser Anleitung zeige ich, wie du den Schlüssel in der Govee-Home-App beantragst, ihn mit einer einzigen Kommandozeile testest, welche Limits gelten und wie du ihn in Home Assistant einsetzt. Dazu kommt eine Regel, die viele ältere Anleitungen noch nicht kennen: Seit dem 15. Mai 2026 macht jeder neue Schlüssel den alten sofort ungültig.

Das Wichtigste in Kürze

• Beantragen: In der Govee-Home-App unter Profil → Zahnrad → „API-Schlüssel beantragen“ Name und Grund eintragen und die Servicebedingungen bestätigen. Der Schlüssel kommt per E-Mail, die Freigabe liegt bei Govee.
• Nur ein Schlüssel pro Konto: Seit dem 15. Mai 2026 macht ein neu erzeugter Key alle älteren sofort ungültig.
• Nur für die Cloud nötig: LAN-Steuerung, Matter und Bluetooth funktionieren ohne Schlüssel.
• Aktuelle API: openapi.api.govee.com mit dem Header Govee-API-Key. Geräteliste, Status und Steuerung laufen über drei Endpunkte.
• Limits pro Minute: Laut aktueller Doku zum Beispiel 30 Statusabfragen pro Minute und Gerät. Die oft genannten 10.000 Abrufe pro Tag gelten für die alte API, die etwa hacs-govee noch nutzt.
• Praxistest: Bei mir bestätigte die API Schaltbefehle nach 0,61 Sekunden. Geräte ohne Cloud-Verbindung melden aber ihren letzten bekannten Zustand – entscheidend ist das Feld online.
• Home Assistant: GoveeLife (HACS) nutzt die neue API, govee2mqtt kombiniert LAN, Cloud und Govee-Konto. Die ältere Integration hacs-govee hängt noch an der alten API mit Tageslimit.

Brauchst du überhaupt einen Govee API Key?

Der API Key öffnet nur einen von vier Wegen zu deinen Govee-Geräten – und zwar den einzigen, der über das Internet läuft. Bevor du ihn beantragst, lohnt der Blick auf die Alternativen:

Die Reihenfolge aus dem Ratgeber Govee in Home Assistant einbinden gilt auch hier: LAN zuerst, dann Matter, die Cloud nur für den Rest. Den Key brauchst du also vor allem für drei Fälle: Geräte ohne LAN und Matter wie meine H6008, Funktionen wie Szenen und Segmente, die lokal nicht ankommen, und eigene Skripte oder Automationen außerhalb von Home Assistant.

Govee API Key beantragen: Schritt für Schritt

1. Öffne die Govee-Home-App und tippe unten rechts auf das Profil-Symbol.
2. Öffne oben rechts über das Zahnrad die Einstellungen.
3. Wähle den Punkt „API-Schlüssel beantragen“. In der englischen App heißt er „Apply for API Key“.
4. Füll die Pflichtfelder „Name“ und „Grund für Antrag“ aus, als Grund zum Beispiel „Steuerung über Home Assistant“. Ein klarer Grund hilft, denn die Freigabe liegt bei Govee.
5. Lies die „Govee Developer API Servicebedingungen“, setz den Haken und tipp auf „Senden“.
6. Govee schickt den Schlüssel per E-Mail an die Adresse deines Govee-Kontos.

Govee schreibt im Formular selbst dazu, die Funktion sei nur für Nutzer sinnvoll, die ihre Geräte per Programmierung steuern wollen. Für Home Assistant und eigene Skripte trifft genau das zu.

Den Govee API Key testen: Geräte per curl abfragen

Der schnellste Test braucht nur ein Terminal mit curl, etwa unter Linux oder macOS. Damit der Schlüssel nicht in der Shell-Historie landet, liest du ihn zuerst verdeckt ein: Befehl starten, Key einfügen, Enter drücken. Der zweite Befehl fragt dann die Geräteliste ab, python3 -m json.tool macht die Antwort nur lesbarer:

read -rs GOVEE_KEY
curl -s https://openapi.api.govee.com/router/api/v1/user/devices \
  -H "Govee-API-Key: $GOVEE_KEY" | python3 -m json.tool

Kommt "code": 200 zurück, funktioniert der Key. Im Feld data steht dann für jedes Gerät deines Kontos ein Eintrag:

• sku – die Modellnummer, etwa H6008.
• device – die Geräte-ID. Sie sieht aus wie eine verlängerte MAC-Adresse und gehört in jeden Steuerbefehl.
• deviceName – der Name aus der Govee-App.
• capabilities – was das Gerät über die Cloud kann, zum Beispiel powerSwitch, brightness oder colorRgb, jeweils mit erlaubtem Wertebereich.

Welche Modelle die API überhaupt unterstützt, steht in Govees Liste der unterstützten Produkte. Darin finden sich zum Beispiel die Glühbirnen H6008 und H600D, der LED-Streifen H61A2 und die Außenstrahler H7060. Ganz verlassen kannst du dich nicht darauf: In meiner Geräteliste tauchte auch das Thermometer H5075 auf, das in Govees Liste fehlt – Messwerte lieferte es über die API allerdings nicht.

Bei mir kam die Antwort nach 0,87 Sekunden mit 45 Einträgen: 32 Lampen, fünf Thermometer, ein Heizgerät und sieben Gruppen oder DreamView-Szenarien aus der App, die keinen Gerätetyp haben. So sieht der Eintrag einer meiner H6008 aus – Name und Geräte-ID habe ich geändert:

{
  "sku": "H6008",
  "device": "AA:BB:CC:DD:EE:FF:00:11",
  "deviceName": "Wohnzimmer",
  "type": "devices.types.light",
  "capabilities": [
    {
      "type": "devices.capabilities.on_off",
      "instance": "powerSwitch"
    },
    {
      "type": "devices.capabilities.range",
      "instance": "brightness",
      "parameters": {
        "dataType": "INTEGER",
        "range": {
          "min": 1,
          "max": 100,
          "precision": 1
        },
        "unit": "unit.percent"
      }
    },
    {
      "type": "devices.capabilities.color_setting",
      "instance": "colorRgb"
    },
    {
      "type": "devices.capabilities.color_setting",
      "instance": "colorTemperatureK",
      "parameters": {
        "dataType": "INTEGER",
        "range": {
          "min": 2000,
          "max": 9000,
          "precision": 1
        }
      }
    },
    {
      "type": "devices.capabilities.dynamic_scene",
      "instance": "lightScene"
    },
    {
      "type": "devices.capabilities.dynamic_scene",
      "instance": "diyScene"
    }
  ]
}

Das Ergebnis ist für meine H6008 die eigentliche Nachricht: Über die Cloud bekommt sie Ein/Aus, Helligkeit, Farbe, Farbtemperatur und sogar Szenen – also mehr als lokal, wo sie weder LAN noch Matter kann. Die verfügbaren Szenen fragst du über einen eigenen Endpunkt ab.

Status einer Lampe abfragen

Für den Status schickst du Modell und Geräte-ID per POST an den Endpunkt device/state. Die requestId ist frei wählbar und kommt in der Antwort zurück:

curl -s -X POST https://openapi.api.govee.com/router/api/v1/device/state \
  -H "Govee-API-Key: $GOVEE_KEY" -H "Content-Type: application/json" \
  -d '{"requestId":"1","payload":{"sku":"H6008","device":"AA:BB:CC:DD:EE:FF:00:11"}}'

Die Antwort enthält unter anderem online, also ob das Gerät gerade mit der Govee-Cloud verbunden ist, sowie den aktuellen Wert von powerSwitch, Helligkeit und Farbe.

Lampe schalten, dimmen und färben

Steuerbefehle gehen an device/control. Typ und Instanz kommen aus den capabilities der Geräteliste. Einschalten sieht so aus:

curl -s -X POST https://openapi.api.govee.com/router/api/v1/device/control \
  -H "Govee-API-Key: $GOVEE_KEY" -H "Content-Type: application/json" \
  -d '{"requestId":"2","payload":{"sku":"H6008","device":"AA:BB:CC:DD:EE:FF:00:11",
       "capability":{"type":"devices.capabilities.on_off","instance":"powerSwitch","value":1}}}'

Der Farbwert ist eine einzige Zahl aus Rot, Grün und Blau: Rot × 65.536 + Grün × 256 + Blau. Orange mit R 255, G 128, B 0 ergibt also 16.744.448. Den genauen Bereich für Helligkeit und Farbtemperatur liefert jedes Gerät selbst in seiner Geräteliste.

Den Praxistest habe ich mit meiner Office-Lampe gemacht, einer Govee H6065. Den Einschaltbefehl bestätigte die API nach 0,61 Sekunden, die Statusabfrage vier Sekunden später meldete die Lampe als eingeschaltet. Ausschalten klappte genauso schnell, Helligkeit und Farbtemperatur waren danach unverändert.

Limits: Wie oft darfst du die Govee-API abfragen?

Govee begrenzt die Zahl der Anfragen pro Minute. Die aktuelle Entwicklerdoku nennt diese Werte (Stand Oktober 2026):

Wer darüber liegt, bekommt den HTTP-Status 429 „too many request“. Ältere Anleitungen und Integrationen nennen noch ein Tageslimit von 10.000 Abrufen – das stammt aus Govees Referenz zur alten API unter developer-api.govee.com/v1. Die alte Adresse antwortet zwar noch, die aktuelle Doku beschreibt aber nur noch die neue. Für Home Assistant heißt das: Ein Abfrageintervall von 60 bis 120 Sekunden, wie es die Integration GoveeLife empfiehlt, bleibt auch mit vielen Geräten weit unter den Grenzen.

Wie ernst Govee das alte Tageslimit nimmt, zeigt meine zweite Home-Assistant-Instanz. Dort fragt die ältere Integration hacs-govee 21 Govee-Lampen über die alte API ab. Im Mai 2026 antwortete Govee beim Start mit HTTP 429 und dem Hinweis „the limit is 10000 requests every 24 hours“. Die Integration brach daraufhin mit einem Programmfehler ab und stand bis Ende Oktober auf „Setup-Fehler“. Zur Einordnung: Bei 21 Geräten erlaubt das alte Limit nur eine Statusabfrage pro Gerät etwa alle drei Minuten, denn 21 × 86.400 Sekunden ÷ 10.000 ergibt rund 181 Sekunden.

Govee API Key in Home Assistant nutzen

Drei Community-Integrationen arbeiten mit dem Schlüssel:

So richtest du GoveeLife ein:

1. In HACS über das Drei-Punkte-Menü „Benutzerdefinierte Repositories“ öffnen, https://github.com/disforw/goveelife als Typ „Integration“ hinzufügen und herunterladen.
2. Home Assistant neu starten.
3. Unter Einstellungen → Geräte & Dienste → Integration hinzufügen nach „GoveeLife“ suchen.
4. API Key eintragen und optional das Abfrageintervall in Sekunden festlegen.

Wichtig: Laufen einige Lampen schon über die LAN-Integration, tauchen sie nach dem Einrichten doppelt auf. Deaktiviere dann die Cloud-Einträge dieser Geräte und nutz die Cloud nur für Geräte, die lokal nicht erreichbar sind.

Wer noch hacs-govee nutzt, sollte zwei Dinge wissen. Die Integration spricht die alte API an und teilt sich damit das Tageslimit von 10.000 Abfragen für alle Geräte des Kontos. Und antwortet Govee beim Start mit Fehler 429, bricht sie mit der Meldung „object has no attribute rate_limit_delay“ ab – ein Fehler, der seit September 2024 im Issue #172 gemeldet ist und für den bisher nur nicht übernommene Korrekturvorschläge existieren. Setz das Abfrageintervall deshalb so hoch, dass das Tageslimit für alle Geräte reicht, oder steig auf GoveeLife mit der neuen API um.

Sicherheit: So gehst du mit dem Schlüssel um

• Der Key ist ein Generalschlüssel: Wer ihn hat, kann alle Geräte deines Govee-Kontos abfragen und schalten – bei Heizlüftern oder Luftbefeuchtern geht es dann nicht mehr nur ums Licht.
• Nie öffentlich zeigen: Keinen Screenshot, keinen Forenbeitrag und kein Fehlerprotokoll mit Key posten. Auch die Geräte-IDs vor dem Teilen unkenntlich machen.
• Sicher ablegen: In Home Assistant steckt der Key in der Konfiguration der Integration. In eigenen Skripten liest du ihn aus einer Datei mit den Rechten 600 oder aus einer Umgebungsvariablen, nie fest im Code.
• Bei Verdacht neu beantragen: Seit Mai 2026 sperrt ein Neuantrag den alten Schlüssel automatisch.

Häufige Fehler und Lösungen

Fazit

Der Govee API Key ist schnell beantragt und öffnet die Cloud für Geräte, die lokal nicht erreichbar sind – bei mir die H6008. Für alles, was LAN oder Matter kann, bleibt die lokale Steuerung die bessere Wahl: schneller, ohne Internet und ohne Limits. Und seit Mai 2026 gilt: nur ein aktiver Schlüssel pro Konto, also vor jedem Neuantrag die Dienste mit dem alten Key notieren.

Im Test mit meiner Office-Lampe reagierte die API in gut einer halben Sekunde. Das reicht für Automationen locker – solange du die Limits im Blick behältst und vor jeder Entscheidung prüfst, ob das Gerät überhaupt online ist.

Weiterlesen: Govee in Home Assistant einbinden, Home Assistant einrichten und Matter Smart Home: was der Standard wirklich bringt.

FAQ

Was ist der Govee API Key?

Ein persönlicher Schlüssel für die offizielle Entwickler-API von Govee. Damit fragen Programme wie Home Assistant oder eigene Skripte die Geräte deines Govee-Kontos über die Cloud ab und steuern sie.

Wie lange dauert es, bis der Govee API Key kommt?

Der Schlüssel kommt per E-Mail an die Adresse deines Govee-Kontos, darauf weist auch das Antragsformular hin. Laut der Doku der Integration GoveeLife dauert das meist nur wenige Minuten. Die Freigabe liegt aber bei Govee, ein klar formulierter Grund im Antrag hilft.

Läuft der Govee API Key ab?

Die Doku nennt kein Ablaufdatum. Ungültig wird der Schlüssel, sobald du einen neuen erzeugst.

Kann ich mehrere Govee API Keys haben?

Nein. Seit dem 15. Mai 2026 ist pro Govee-Konto nur ein Schlüssel aktiv. Jeder neue macht alle älteren sofort ungültig.

Kann ich das Govee-Thermometer H5075 über die API abfragen?

In der Praxis nicht. Bei mir stehen zwar beide H5075 in der Geräteliste der API, melden aber online: false und leere Werte für Temperatur und Luftfeuchte. In Govees offizieller Liste der API-Modelle fehlt das H5075 auch (Stand Oktober 2026). Es funkt per Bluetooth, in Home Assistant liest du es deshalb über die Integration „Govee Bluetooth“ aus. Für die API sind WLAN-Modelle wie das H5179 gedacht.

Was ist der Unterschied zwischen Govee API und LAN-API?

Die Govee-API läuft über die Cloud und braucht den Key. Die LAN-API spricht die Lampe direkt im Heimnetz per UDP an, braucht keinen Schlüssel und kein Internet – aber den Schalter „LAN Steuerung“ in der App, den nicht jedes Gerät hat.

Quellen

• Govee Developer Platform: Apply Govee-API-Key
• Govee Developer Platform: Geräteliste und Abruflimits
• Govee Developer Platform: Geräte steuern
• Govee Developer Platform: Gerätestatus abfragen
• Govee Developer Platform: Unterstützte Modelle
• Govee: Neue Regel für API-Schlüssel ab 15. Mai 2026
• Govee: Referenz der alten API v1 (PDF, mit Tageslimit)
• Microsoft Learn: Govee-Connector mit Anleitung zum API-Key-Antrag
• GoveeLife auf GitHub
• govee2mqtt auf GitHub
• hacs-govee auf GitHub
• hacs-govee: Issue #172 „object has no attribute rate_limit_delay“