---
title: "goose: eigenen OpenAI-kompatiblen Provider einrichten"
description: "Verbinden Sie den KI-Agenten goose als OpenAI-kompatiblen Custom Provider mit BroadNet Inference – über goose Desktop, goose configure oder eine JSON-Datei."
url: https://broadrouter.com/de/guides/goose-custom-provider/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/goose-custom-provider/) (aktualisiert am 2026-11-16).

# BroadNet Inference als Custom Provider in goose einbinden

Aktualisiert 2026-11-16

Legen Sie in goose einen Custom Provider vom Typ OpenAI Compatible an, mit API URL https://inference.broadnet.ai/v1/chat/completions, Ihrem BroadNet-Schlüssel und Modellen wie broadnet/glm-5.3. Nutzen Sie den Button Add Custom Provider in goose Desktop, goose configure im Terminal oder eine JSON-Datei in ~/.config/goose/custom\_providers/. goose setzt auf Tool Calling, starten Sie also mit GLM 5.3 oder Qwen3.8 27B.

goose ist ein quelloffener KI-Agent mit Desktop-App und CLI. Dienste, die nicht eingebaut sind, fügen Sie als **Custom Provider** hinzu, und goose unterstützt OpenAI-kompatible. BroadNet Inference stellt Standard-Chat-Completions bereit und funktioniert daher auf diesem Weg. BroadRouter ist die Website von BroadNet selbst; die Schritte folgen der [Provider-Dokumentation von goose](https://goose-docs.ai/docs/getting-started/providers/) zum Stand von goose 1.59.

Die goose-Dokumentation warnt, dass goose „extensively uses tool calling“ (Übersetzung: Tool Calling intensiv nutzt) und dass Modelle ohne diese Fähigkeit nur chatten können, wenn alle Extensions deaktiviert sind. BroadNet gibt Tool Calling für GLM 5.3 und Qwen3.8 27B an; nehmen Sie für Agentenarbeit also eines dieser beiden.

## Option 1: goose Desktop

1.  Öffnen Sie die Seitenleiste, klicken Sie auf **Settings** und dann auf den Tab **Models**.
    
2.  Klicken Sie auf **Configure providers** und unten auf **Add Custom Provider**.
    
3.  Füllen Sie die Angaben aus:
    
    | Feld | Wert |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | Ihr BroadNet-Schlüssel |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | an |
    
4.  Klicken Sie auf **Create Provider** und wählen Sie dann den Provider und ein Modell aus.
    

## Option 2: goose CLI

Führen Sie `goose configure` aus, wählen Sie **Custom Providers** und dann **Add A Custom Provider**, und beantworten Sie die Abfragen mit denselben Werten: API-Typ OpenAI Compatible, die API URL von oben, Authentifizierung **Yes** mit statischem API-Schlüssel, die kommagetrennte Modellliste und Streaming an.

## Option 3: eine JSON-Datei

Legen Sie `~/.config/goose/custom_providers/broadnet.json` an (unter Windows `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Starten Sie dann eine Session damit:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

Die Datei kann für Ihr Team in ein Repository, denn der Schlüssel bleibt in der Umgebung.

## Testen

Beginnen Sie mit einer einfachen Frage wie „what can you do?“. Kommt eine Antwort, steht die Verbindung. Bitten Sie dann um etwas, das eine Ihrer aktivierten Extensions braucht. Ruft goose das Tool auf, funktioniert auch Tool Calling. Antwortet es nur mit Text und ruft nie ein Tool auf, wechseln Sie zu `broadnet/glm-5.3`.

## Preise in goose

goose kann die Kosten schätzen, wenn jedes Modell in der JSON-Datei `input_token_cost` und `output_token_cost` in USD pro Token hat. Nehmen Sie die Werte von der [Preisseite](https://broadrouter.com/de/pricing/) von BroadNet und teilen Sie den Preis pro Million durch 1.000.000. Fehlt eines der beiden Felder, greift goose auf die Preise aus seinem eigenen Katalog zurück, die von den Preisen von BroadNet abweichen können.

## Fehlerbehebung

-   **401.** Der Schlüssel ist falsch, abgelaufen oder sein Kontingent ist aufgebraucht, oder `BROADNET_API_KEY` ist in der Shell, die goose startet, nicht gesetzt.
-   **404.** Prüfen Sie die API URL. Sie sollte `https://inference.broadnet.ai/v1/chat/completions` lauten. Prüfen Sie, ob die Modell-ID exakt der von BroadNet entspricht. Kostenpflichtige Modelle brauchen eine Aufladung; das Guthaben von $5 deckt nur `broadnet/gemma-4-26b-a4b` und die beiden Transcribe-Modelle ab, und der Kontext von Gemma von 32.768 Token ist für Agentenarbeit knapp.
-   **Leere Antworten.** Bei DeepSeek V4.1 Flash, GLM 5.3 und Qwen3.8 27B zählt das Reasoning zum Output-Limit. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig laufende. Siehe [Fehlercodes und Retries](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Anfragen warten oder scheitern bei zwei goose-Sessions mit einem Plan-Schlüssel.** Eine [Plan-Session](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet immer nur eine Anfrage; geben Sie daher jeder goose-Session ihre eigene.

## Begriffe in dieser Anleitung

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

[API-Schlüssel (API Key)](https://broadrouter.com/de/glossary/api-key/)

Ein API-Schlüssel ist eine geheime Zeichenfolge, die einen Client beim Aufruf einer API identifiziert und autorisiert. LLM-APIs erwarten ihn meist im Header Authorization: Bearer, und wer den Schlüssel besitzt, kann Anfragen stellen, die dem Konto des Inhabers berechnet werden.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Streaming](https://broadrouter.com/de/glossary/streaming/)

Streaming ist eine Art, die Antwort eines Sprachmodells in kleinen Chunks zurückzugeben, während sie noch erzeugt wird, statt als eine Antwort am Ende. OpenAI-kompatible APIs streamen über Server-Sent Events, wenn die Anfrage stream auf true setzt.

[Token](https://broadrouter.com/de/glossary/token/)

Ein Token ist die Texteinheit, die ein Sprachmodell liest und schreibt: ein Wort, ein Wortteil, ein Satzzeichen oder eine Bytefolge, die der Tokenizer des Modells erzeugt. LLM-APIs zählen, begrenzen und berechnen die Nutzung meist in Tokens.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[KI-Agent (AI Agent)](https://broadrouter.com/de/glossary/agent/)

Ein KI-Agent ist ein System, in dem ein Sprachmodell seine eigenen Schritte auf ein Ziel hin steuert: Es entscheidet, welche Tools es aufruft, liest die Ergebnisse und wiederholt das, bis es eine endgültige Antwort liefert oder an ein Limit stößt. Ein festes Skript, das ein Modell an vorgegebenen Stellen aufruft, heißt dagegen meist Workflow.

## Häufige Fragen

### Endet die API URL in goose auf /v1 oder auf /v1/chat/completions?

Das Custom-Provider-Beispiel von goose nutzt die vollständige Chat-Completions-URL, verwenden Sie also https://inference.broadnet.ai/v1/chat/completions. So bleibt goose auch bei Chat Completions, dem Format, das BroadNet bereitstellt.

### Welches BroadNet-Modell funktioniert am besten mit goose?

GLM 5.3 (broadnet/glm-5.3). Laut goose-Dokumentation nutzt goose Tool Calling intensiv, und BroadNet gibt Tools nur für GLM 5.3 und Qwen3.8 27B an.

### Kann ich goose mit dem unbegrenzten Plan von BroadNet nutzen?

Die Pläne decken nur DeepSeek V4.1 Flash ab, und die BroadNet-Dokumentation nennt dafür kein Tool Calling. Laut goose können Modelle ohne Tool Calling nur chatten, wenn alle Extensions deaktiviert sind; testen Sie es also, bevor Sie einen Monat kaufen.

### Wo speichert goose den API-Schlüssel?

Im Schlüsselbund des Systems oder, wenn der Keyring aus ist, in secrets.yaml. Bei einer JSON-Datei liest goose stattdessen die Variable, die in api\_key\_env steht.

## Verwandte Anleitungen

-   [Kilo Code mit BroadNet Inference nutzen (Provider OpenAI Compatible)](https://broadrouter.com/de/guides/kilo-code-openai-compatible/)
-   [BroadNet Inference als eigenen Provider in opencode einrichten](https://broadrouter.com/de/guides/opencode-custom-provider/)
-   [So funktionieren die unbegrenzten LLM-API-Pläne für Agenten](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)
-   [Alle Tools, die mit BroadNet Inference funktionieren (auf Englisch)](https://broadrouter.com/integrations/): SDKs, Coding-Agenten, Chat-Oberflächen und Automatisierungstools, jeweils mit den genauen Einstellungen

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-goose-custom-provider&utm_content=page-cta) ·

**Quellen**

-   [goose-Dokumentation, Model providers und Configure Custom Provider (geprüft am 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose auf GitHub (aaif-goose/goose), v1.59.1 aktuell (geprüft am 2026-11-15)](https://github.com/aaif-goose/goose)
-   [API-Referenz von BroadNet Inference (geprüft am 2026-11-15) (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-goose-custom-provider&utm_content=sources)
