---
title: "openai-go でカスタムのベース URL を使う（WithBaseURL） | BroadRouter"
description: "公式の openai-go v3 SDK を option.WithBaseURL で BroadNet Inference につなぎ、Go でチャット補完、使用量付きのストリーミング、エラー処理を行う方法です。"
url: https://broadrouter.com/ja/guides/openai-go-sdk/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。[英語の原文を読む](https://broadrouter.com/guides/openai-go-sdk/)（2026-11-16 更新）。

# Go の openai-go SDK から BroadNet Inference を呼び出す

更新日 2026-11-16

github.com/openai/openai-go/v3 をインストールし、option.WithBaseURL("https://inference.broadnet.ai/v1") と、BroadNet のキーを渡した option.WithAPIKey でクライアントを作成します。client.Chat.Completions.New には broadnet/glm-5.3 などの BroadNet のモデル ID をそのまま文字列で渡します。Responses API ではなくチャット補完を使い、MaxTokens は推論の分も見込んで設定してください。

`openai-go` は OpenAI 公式の Go ライブラリです。`option.WithBaseURL` でカスタムのベース URL を指定できるので、OpenAI 互換の API ならどれでも呼び出せます。BroadNet Inference は `https://inference.broadnet.ai/v1` でチャット補完を提供しています。BroadRouter は BroadNet 自身のサイトです。この記事は openai-go v3.99.0 の README に従っています。

## インストール

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

現在のリリースには Go 1.26 以上が必要です。

## チャット補完

```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)
}
```

`go run .` で実行します。回答が表示されればテストは成功で、キー、URL、モデル ID が正しく動いています。

-   **Model** は普通の文字列です。`openai.ChatModel` は `string` の型エイリアスなので、BroadNet の ID を変換する必要はありません。
-   **`Chat.Completions` を使います。** README は最初に Responses API（`client.Responses.New`）を紹介していますが、BroadNet はこの API を記載していません。README の Chat Completions のセクションには、この API は “supported indefinitely”（訳：無期限にサポートされる）と書かれています。
-   **`MaxTokens` と `MaxCompletionTokens`。** SDK は `max_tokens` を非推奨とし、`max_completion_tokens` を推奨していますが、BroadNet の API リファレンスに記載されているのは `max_tokens` です。`MaxTokens` を使ってください。
-   **`DeveloperMessage` ではなく `SystemMessage`。** README の例は `DeveloperMessage` を使っており、これは `developer` ロールを送ります。BroadNet の API リファレンスにはこのロールの記載がないので、`system` と `user` を使ってください。

## 使用量付きのストリーミング

```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)
}
```

BroadNet のドキュメントによると、`stream_options.include_usage` が true のとき、使用量は最後のチャンクで届きます。そのチャンクには choices がないため、長さをチェックしています。データ形式は [chat completions のストリーミング](https://broadrouter.com/ja/guides/streaming-chat-completions/)を参照してください。

## エラーとリトライ

成功以外のステータスでは、SDK は `*openai.Error` を返します。`errors.As` で取り出し、`StatusCode` を確認します。

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

openai-go はデフォルトで、一部のエラーを短い指数バックオフで 2 回リトライします。`option.WithMaxRetries(n)` で変更できます。リトライも BroadNet のレート制限にカウントされます。

## トラブルシューティング

-   **401。** キーが間違っている、期限切れ、または利用枠を使い切っています。`WithAPIKey` を渡していない場合、SDK は `OPENAI_API_KEY` を使っています。
-   **404。** ベース URL は `/v1` で終わっている必要があり、呼び出し先は `Responses` ではなく `Chat.Completions` でなければなりません。そのうえでモデル ID を確認してください。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは `broadnet/gemma-4-26b-a4b` と 2 つの Transcribe モデルだけです。
-   **`Content` が空。** 推論（reasoning）が出力の上限を使い切っています。`MaxTokens` を上げてください。[回答が空になる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **429。** 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。API を同時に呼び出す goroutine の数を制限してください。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。

## このガイドの用語

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[ベース URL（base URL）](https://broadrouter.com/ja/glossary/base-url/)

ベース URL とは、https://api.example.com/v1 のような API の固定のルートアドレスで、クライアントが /chat/completions などのエンドポイントパスの前に付けます。OpenAI 互換の SDK では、API キーとモデル ID と一緒にベース URL を変えるだけで、同じコードを別のプロバイダーに向けられます。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[max\_tokens（最大出力トークン数）](https://broadrouter.com/ja/glossary/max-tokens/)

max\_tokens とは、モデルが 1 回の応答で生成できるトークン数の上限を決める LLM API のパラメーターです。生成が上限に達すると止まり、応答は途中で打ち切られたものとして、たとえば finish\_reason が "length" になります。

[OpenAI 互換 API（OpenAI-compatible API）](https://broadrouter.com/ja/glossary/openai-compatible-api/)

OpenAI 互換 API とは、POST /v1/chat/completions など OpenAI API と同じリクエスト形式とレスポンス形式を受け付ける HTTP API です。OpenAI の SDK やツールは、ベース URL、API キー、モデル名を変えるだけで利用できます。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[指数バックオフ（exponential backoff）](https://broadrouter.com/ja/glossary/exponential-backoff/)

指数バックオフ（exponential backoff）とは、失敗するたびに待ち時間を長くして再試行するリトライ戦略で、通常は上限まで遅延を 2 倍ずつ増やします。各待ち時間にランダムなジッターを加えると、多数のクライアントの再試行が分散し、同時にサーバーへ集中しなくなります。

## よくある質問

### オプションではなく環境変数で BroadNet の URL を設定できますか？

できます。openai-go はデフォルトで OPENAI\_API\_KEY と OPENAI\_BASE\_URL を読むので、両方に BroadNet の値を入れておけば、オプションなしの openai.NewClient() で動きます。明示的な option.WithBaseURL は OPENAI\_BASE\_URL より優先されます。

### Model が openai.ChatModel 型なのに、BroadNet のモデル ID をどう渡せばいいですか？

openai-go では ChatModel は string の型エイリアスなので、Model "broadnet/glm-5.3" はそのままコンパイルできます。

### DeveloperMessage ではなく SystemMessage を使うのはなぜですか？

DeveloperMessage は developer ロールを送ります。これは OpenAI が自社モデル向けに導入したロールです。BroadNet の API リファレンスにはこのロールの記載がないので、標準の system ロールのほうが安全です。

### どのバージョンの Go が必要ですか？

現在の openai-go v3 には Go 1.26 以上が必要です。README には、Go 1.25 のままにする必要がある場合は v3.74.0 に固定するよう書かれています。

## 関連ガイド

-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [OpenAI Node.js SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-node-sdk/)
-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)
-   [BroadNet Inference で使えるすべてのツール（英語）](https://broadrouter.com/integrations/)：SDK、コーディングエージェント、チャット UI、自動化ツールと、それぞれの正確な設定

実際のワークロードで試してください。新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-go-sdk&utm_content=page-cta) ·

**出典**

-   [openai-go の README（v3.99.0、Go 1.26 以上）（2026-11-15 確認）](https://github.com/openai/openai-go)
-   [openai-go のソース、ChatCompletionNewParams と option.WithBaseURL（2026-11-15 確認）](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-go-sdk&utm_content=sources)
