Kurs Home Assistant od Zera

OpenAI od zera: billing, projekt, API key i pierwszy Conversation Agent w Home Assistant

Lekcja 22 kursu MarkLabs: OpenAI API od zera w Home Assistant. Projekt, billing, prepaid, API key, oficjalna integracja, Conversation Agent, GPT-5.6 Luna, testy

Home Assistant LAB · Głos i AI w praktyce · Lekcja 22

OpenAI od zera: billing, projekt, API key i pierwszy Conversation Agent w Home Assistant

W poprzedniej lekcji przygotowaliśmy zasady korzystania z płatnego cloud AI: oddzieliliśmy ChatGPT od API, policzyliśmy koszt, ustaliliśmy zakres danych i zachowaliśmy lokalny plan B. Teraz po raz pierwszy naprawdę podłączamy OpenAI do Home Assistant. Nie zaczynamy jednak od Voice PE, sterowania domem ani wyszukiwania w sieci. Najpierw budujemy najprostszy możliwy tor tekstowy, dzięki któremu osobno potwierdzimy projekt, billing, klucz API, oficjalną integrację oraz pierwszy działający Conversation Agent.

Dlaczego ten etap jest ważny

Cloud AI łatwo uruchomić zbyt szybko: billing, nowy model, Voice PE, STT, TTS, narzędzia Home Assistant i Web Search można zmienić jednocześnie. Gdy coś wtedy nie działa, nie wiadomo, która warstwa zawiodła. W tej lekcji celowo zwalniamy. Najpierw udowadniamy, że samo API i Conversation Agent działają poprawnie, a dopiero później dokładamy kolejne elementy.

W pełnej lekcji zrobisz to krok po kroku

Oddzielamy ChatGPT od OpenAI API i zakładamy osobny projekt

Wyjaśniamy, dlaczego abonament ChatGPT nie opłaca API używanego przez Home Assistant. Tworzymy osobny projekt Home Assistant LAB, żeby klucz, koszty i Usage nie mieszały się z innymi eksperymentami. Od początku wiemy więc, który ruch w panelu OpenAI dotyczy naszego domu.

Ustawiamy billing tak, żeby pierwszy test nie zamienił się w otwarty rachunek

Przechodzimy przez małe saldo prepaid, Auto-recharge OFF, budżet projektu i alerty. Nie traktujemy budżetu jako magicznego bezpiecznika. Sprawdzamy, co faktycznie kontroluje, gdzie pojawiają się koszty i dlaczego po pierwszych requestach zawsze zaglądamy do Usage.

Tworzymy project-scoped API key i bezpiecznie przekazujemy go do Home Assistant

Klucz ma należeć do właściwego projektu i służyć tylko temu laboratorium. Pokazujemy prosty baseline uprawnień oraz wariant Restricted. Równocześnie ustalamy miejsca, w których sekretu nigdy nie zapisujemy: publiczny YAML, Git, screenshot, forum ani opis skryptu.

Dodajemy oficjalną integrację OpenAI i pierwszy Conversation Agent

W Home Assistant przechodzimy przez Ustawienia > Urządzenia i usługi, dodajemy OpenAI i wyjaśniamy aktualny układ podwpisów: Conversation, AI Task, Speech-to-text i Text-to-speech. Pierwszy agent OpenAI Baseline powstaje na ustawieniach rekomendowanych przez Home Assistant, ale bez prawa do sterowania domem.

Testujemy tekstowo, zanim do równania wejdzie mikrofon i Voice PE

Pierwszy request wykonujemy przez Conversation: Process conversation. Dzięki temu, jeśli coś zawiedzie, nie analizujemy wake wordu, STT ani TTS. Robimy również test negatywny: model bez Control Home Assistant ma przyznać, że nie zna realnego stanu domu, zamiast przekonująco go wymyślać.

Tworzymy OpenAI Luna LAB, mierzymy Usage i zostawiamy czysty baseline pod Voice

Drugi Conversation Agent dostaje GPT-5.6 Luna, krótki polski prompt, niski reasoning, niską verbosity i limit odpowiedzi. Sprawdzamy conversation_id, rzeczywiste zużycie oraz koszt serii testowej. Na końcu wiemy dokładnie, co działa i czego jeszcze świadomie nie włączyliśmy.

Pełna wersja zawiera
  • różnicę między ChatGPT Plus/Pro a płatnym OpenAI API
  • osobny projekt Home Assistant LAB
  • sprawdzenie właściwej organizacji i projektu przed utworzeniem klucza
  • billing API i małe saldo prepaid
  • Auto-recharge OFF jako bezpieczny start laboratorium
  • budżet projektu i alerty kosztowe
  • wyjaśnienie, czego budżet pilnuje, a czego nie gwarantuje
  • project-scoped API key zamiast jednego klucza do wszystkiego
  • wariant prostych uprawnień i wariant Restricted
  • Models Read i Responses Write w macierzy uprawnień
  • zasady bezpiecznego przechowywania sekretu
  • dodanie oficjalnej integracji OpenAI w polskim Home Assistant
  • wyjaśnienie, dlaczego nie używamy custom Base URL
  • podwpisy Conversation, AI Task, Speech-to-text i Text-to-speech
  • utworzenie OpenAI Baseline
  • Recommended settings jako test zgodności, nie ślepy wybór produkcyjny
  • Control Home Assistant OFF
  • Web Search OFF
  • Store requests and responses OFF
  • pierwszy test przez Conversation: Process conversation
  • przykład conversation.process z response_variable
  • test odpowiedzi po polsku
  • negatywny test pytania o realny stan domu
  • negatywny test próby sterowania przy wyłączonych tools
  • utworzenie OpenAI Luna LAB
  • GPT-5.6 Luna jako tani baseline do kolejnych testów
  • Maximum tokens 1000, reasoning low i verbosity low
  • krótkie polskie Instructions
  • test pięciu pytań na Baseline i Luna LAB
  • conversation_id i różnicę między kontynuacją a świeżą sesją
  • Usage filtrowane po projekcie Home Assistant LAB
  • uwagę o czasie raportowanym w UTC
  • opcjonalny debug input, cached, output, reasoning i total tokens
  • rotację klucza API jako kontrolowany test
  • rollback bez naruszania lokalnej Ollamy i Okay Nabu
  • OpenAI Setup Checklist, API Key Permission Matrix, Test Pack i First Usage Log
  • warunek PASS przed przejściem do Voice PE
Jak pracujemy w pełnej wersji

Nie przeskakujemy od założenia konta prosto do działającego Jarvisa. Najpierw potwierdzamy projekt i billing, potem klucz, następnie integrację i dopiero na końcu Conversation Agent. Pierwszy test wykonujemy tekstowo, dlatego mikrofon, wake word, Whisper i Piper nie mogą ukryć prawdziwej przyczyny błędu.

Nie włączamy też kilku kosztownych funkcji jednocześnie. Control Home Assistant, Web Search, STT i TTS czekają na osobne etapy. Dzięki temu po pierwszym requestcie możemy otworzyć Usage i dokładnie wiedzieć, za co zapłaciliśmy.

Na końcu etap musi dać się zweryfikować. Baseline odpowiada, Luna LAB odpowiada, model nie udaje wiedzy o realnym stanie domu, Usage jest widoczne, koszt został zapisany, a lokalny tor z poprzednich lekcji pozostaje nietknięty.

Efekt po zakończeniu lekcji

OpenAI jest realnie podłączone do Home Assistant, ale nadal pracuje w kontrolowanej piaskownicy. Masz osobny projekt, bezpieczny klucz, działający OpenAI Baseline i OpenAI Luna LAB, potrafisz wykonać test przez conversation.process i widzisz rzeczywisty koszt w Usage. Model nadal nie steruje domem, a Voice PE nie został jeszcze przełączony na chmurę. Dzięki temu Lekcja 23 może dołożyć tylko jedną nową warstwę: dźwięk.

Chcesz podłączyć OpenAI do Home Assistant bez zgadywania, gdzie powstaje koszt i co naprawdę widzi model?

Ta lekcja jest częścią kursu Smart Home od Zera na platformie MarkLabs E-Learning. Pełna wersja prowadzi od projektu i billingu aż do dwóch działających Conversation Agentów, testu Usage i bezpiecznego rollbacku.

Kup dostęp do kursu: 29 zł
Dożywotni dostęp | Wszystkie lekcje | Bez subskrypcji
🔒

Pełna treść dostępna po zakupie kursu

Za symboliczne 29 zł zyskujesz dostęp do 200+ stron praktycznej wiedzy o Home Assistant — wszystkich lekcji, przykładów i aktualizacji.

  • Dożywotni dostęp do całego kursu
  • Nowe lekcje bez dodatkowych opłat
  • Bez reklam i bez abonamentu

Nikt nie jest nieomylny. Coś nie gra w tej lekcji? Zgłoś błąd