---
title: "openai-go mit eigener Basis-URL (WithBaseURL) | BroadRouter"
description: "Das offizielle SDK openai-go v3 per option.WithBaseURL mit BroadNet Inference nutzen: Chat Completions, Streaming mit Usage und Fehlerbehandlung in Go."
url: https://broadrouter.com/de/guides/openai-go-sdk/
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/openai-go-sdk/) (aktualisiert am 2026-11-16).

# BroadNet Inference aus Go mit dem openai-go SDK aufrufen

Aktualisiert 2026-11-16

Installieren Sie github.com/openai/openai-go/v3 und erstellen Sie den Client mit option.WithBaseURL("https://inference.broadnet.ai/v1") und option.WithAPIKey mit Ihrem BroadNet-Schlüssel. Rufen Sie client.Chat.Completions.New mit einer BroadNet-Modell-ID wie broadnet/glm-5.3 als einfachem String auf. Nutzen Sie Chat Completions, nicht die Responses API, und setzen Sie MaxTokens mit Spielraum für Reasoning.

`openai-go` ist die offizielle Go-Bibliothek von OpenAI. Sie akzeptiert mit `option.WithBaseURL` eine eigene Basis-URL und kann damit jede OpenAI-kompatible API aufrufen. BroadNet Inference bietet Chat Completions unter `https://inference.broadnet.ai/v1`. BroadRouter ist die eigene Website von BroadNet; diese Anleitung folgt dem README von openai-go für v3.99.0.

## Installieren

```bash
go get -u 'github.com/openai/openai-go/v3@v3.99.0'
export BROADNET_API_KEY='your-broadnet-key'
```

Das aktuelle Release braucht Go 1.26 oder neuer.

## Chat Completion

```go
package main

import (
	"context"
	"fmt"
	"os"

	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/option"
)

func main() {
	client := openai.NewClient(
		option.WithBaseURL("https://inference.broadnet.ai/v1"),
		option.WithAPIKey(os.Getenv("BROADNET_API_KEY")),
	)

	resp, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
		Model: "broadnet/glm-5.3",
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.SystemMessage("You are a concise Go reviewer."),
			openai.UserMessage("How do I check if a slice is empty in Go?"),
		},
		MaxTokens: openai.Int(2000), // reasoning counts toward this limit
	})
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Choices[0].Message.Content)
}
```

Starten Sie es mit `go run .`. Eine ausgegebene Antwort ist Ihr Test: Schlüssel, URL und Modell-ID funktionieren.

-   **Model** ist ein einfacher String. `openai.ChatModel` ist ein Typalias für `string`, daher brauchen BroadNet-IDs keine Umwandlung.
-   **Nutzen Sie `Chat.Completions`.** Das README stellt die Responses API (`client.Responses.New`) an den Anfang, die BroadNet nicht listet. Im Abschnitt zu Chat Completions heißt es, diese API werde „supported indefinitely“ (Übersetzung: unbefristet unterstützt).
-   **`MaxTokens` oder `MaxCompletionTokens`.** Das SDK markiert `max_tokens` zugunsten von `max_completion_tokens` als veraltet, die API-Referenz von BroadNet beschreibt aber `max_tokens`. Verwenden Sie `MaxTokens`.
-   **`SystemMessage`, nicht `DeveloperMessage`.** Das Beispiel im README nutzt `DeveloperMessage`, das die Rolle `developer` sendet. Die API-Referenz von BroadNet erwähnt diese Rolle nicht, also verwenden Sie `system` und `user`.

## Streaming mit Usage

```go
stream := client.Chat.Completions.NewStreaming(context.TODO(), openai.ChatCompletionNewParams{
	Model:     "broadnet/deepseek-v4.1-flash",
	Messages:  []openai.ChatCompletionMessageParamUnion{openai.UserMessage("Count from one to five.")},
	MaxTokens: openai.Int(2000),
	StreamOptions: openai.ChatCompletionStreamOptionsParam{
		IncludeUsage: openai.Bool(true),
	},
})
defer stream.Close()

for stream.Next() {
	chunk := stream.Current()
	if len(chunk.Choices) > 0 {
		fmt.Print(chunk.Choices[0].Delta.Content)
	}
	if chunk.Usage.TotalTokens > 0 {
		fmt.Printf("\n%d tokens\n", chunk.Usage.TotalTokens)
	}
}
if err := stream.Err(); err != nil {
	panic(err)
}
```

Laut Dokumentation von BroadNet kommt die Usage im letzten Chunk, wenn `stream_options.include_usage` auf true steht; dieser Chunk hat keine Choices, daher die Längenprüfung. Das Wire-Format erklärt [Chat Completions streamen](https://broadrouter.com/de/guides/streaming-chat-completions/).

## Fehler und Retries

Das SDK gibt bei Statuscodes außerhalb des Erfolgsbereichs `*openai.Error` zurück. Verwenden Sie `errors.As` und lesen Sie `StatusCode`:

```go
var apierr *openai.Error
if errors.As(err, &apierr) && apierr.StatusCode == 429 {
	// back off, then retry
}
```

openai-go wiederholt manche Fehler standardmäßig zweimal mit kurzem exponentiellem Backoff. Ändern Sie das mit `option.WithMaxRetries(n)`. Retries zählen zu den Rate Limits von BroadNet.

## Fehlerbehebung

-   **401.** Der Schlüssel ist falsch, abgelaufen oder das Kontingent ist aufgebraucht. Wenn Sie kein `WithAPIKey` übergeben haben, hat das SDK `OPENAI_API_KEY` verwendet.
-   **404.** Die Basis-URL muss auf `/v1` enden, und der Aufruf muss an `Chat.Completions` gehen, nicht an `Responses`. Prüfen Sie danach die Modell-ID. Kostenpflichtige Modelle erfordern eine Aufladung; das Guthaben von $5 deckt nur `broadnet/gemma-4-26b-a4b` und die beiden Transcribe-Modelle ab.
-   **Leeres `Content`.** Reasoning hat das Ausgabebudget verbraucht. Erhöhen Sie `MaxTokens`. [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. Begrenzen Sie die Goroutinen, die die API gleichzeitig aufrufen. Siehe [Fehler und Retries](https://broadrouter.com/de/guides/errors-and-retries/).

## Begriffe in dieser Anleitung

[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.

[Chat Completions API](https://broadrouter.com/de/glossary/chat-completions-api/)

Die Chat Completions API ist der HTTP-Endpoint von OpenAI, POST /v1/chat/completions, der einen Modellnamen und eine Liste von Nachrichten mit Rollen entgegennimmt und die nächste Nachricht des Modells zurückgibt. Ihr Format für Anfrage und Antwort wurde zum gemeinsamen Standard, den OpenAI-kompatible Anbieter und SDKs übernehmen.

[Basis-URL (Base URL)](https://broadrouter.com/de/glossary/base-url/)

Eine Basis-URL ist die feste Stammadresse einer API, etwa https://api.example.com/v1, die ein Client vor jeden Endpoint-Pfad wie /chat/completions setzt. In OpenAI-kompatiblen SDKs lenkt eine geänderte Basis-URL, zusammen mit API-Schlüssel und Modell-ID, denselben Code zu einem anderen Anbieter.

[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.

[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.

[OpenAI-kompatible API](https://broadrouter.com/de/glossary/openai-compatible-api/)

Eine OpenAI-kompatible API ist eine HTTP-API, die dieselben Anfrage- und Antwortformate wie die OpenAI API akzeptiert, etwa POST /v1/chat/completions. OpenAI-SDKs und Tools können sie deshalb nutzen, wenn nur Basis-URL, API-Schlüssel und Modellname geändert werden.

[Prepaid-Guthaben (Prepaid Credit)](https://broadrouter.com/de/glossary/prepaid-credit/)

Prepaid-Guthaben ist Geld, das vor der Nutzung auf ein API-Konto eingezahlt wird. Jede Anfrage zieht ihre Kosten vom Guthaben ab, und wenn es aufgebraucht ist, stoppen abgerechnete Anfragen, bis Sie aufladen. So sind die Ausgaben auf das eingezahlte Geld begrenzt.

[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.

## Häufige Fragen

### Kann ich die BroadNet-URL per Umgebungsvariable statt über Optionen setzen?

Ja. openai-go liest standardmäßig OPENAI\_API\_KEY und OPENAI\_BASE\_URL, daher funktioniert openai.NewClient() ohne Optionen, wenn beide BroadNet-Werte enthalten. Ein explizites option.WithBaseURL hat Vorrang vor OPENAI\_BASE\_URL.

### Wie übergebe ich eine BroadNet-Modell-ID, wenn Model openai.ChatModel erwartet?

ChatModel ist in openai-go ein Typalias für string, daher kompiliert Model "broadnet/glm-5.3" unverändert.

### Warum SystemMessage statt DeveloperMessage?

DeveloperMessage sendet die Rolle developer, die OpenAI für seine eigenen Modelle eingeführt hat. Die API-Referenz von BroadNet erwähnt diese Rolle nicht, daher ist die übliche Rolle system die sicherere Wahl.

### Welche Go-Version brauche ich?

Das aktuelle openai-go v3 braucht Go 1.26 oder neuer. Laut README sollten Sie v3.74.0 festschreiben, wenn Sie bei Go 1.25 bleiben müssen.

## Verwandte Anleitungen

-   [OpenAI Python SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-python-sdk/)
-   [OpenAI Node.js SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-node-sdk/)
-   [Chat Completions streamen und abgebrochene Verbindungen behandeln](https://broadrouter.com/de/guides/streaming-chat-completions/)
-   [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-openai-go-sdk&utm_content=page-cta) ·

**Quellen**

-   [README von openai-go (v3.99.0, Go 1.26+) (geprüft am 2026-11-15)](https://github.com/openai/openai-go)
-   [Quellcode von openai-go, ChatCompletionNewParams und option.WithBaseURL (geprüft am 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [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-openai-go-sdk&utm_content=sources)
