---
title: "openai-go dengan base URL kustom (WithBaseURL) | BroadRouter"
description: "Pakai SDK resmi openai-go v3 dengan BroadNet Inference lewat option.WithBaseURL: chat completions, streaming dengan usage, dan penanganan error di Go."
url: https://broadrouter.com/id/guides/openai-go-sdk/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/openai-go-sdk/) (diperbarui 2026-11-16).

# Memanggil BroadNet Inference dari Go dengan SDK openai-go

Diperbarui 2026-11-16

Instal github.com/openai/openai-go/v3 dan buat client dengan option.WithBaseURL("https://inference.broadnet.ai/v1") serta option.WithAPIKey berisi kunci BroadNet Anda. Panggil client.Chat.Completions.New dengan ID model BroadNet seperti broadnet/glm-5.3 sebagai string biasa. Gunakan chat completions, bukan Responses API, dan atur MaxTokens dengan ruang untuk penalaran.

`openai-go` adalah library Go resmi dari OpenAI. Library ini menerima base URL kustom lewat `option.WithBaseURL`, jadi bisa memanggil API apa pun yang kompatibel dengan OpenAI. BroadNet Inference melayani chat completions di `https://inference.broadnet.ai/v1`. BroadRouter adalah situs milik BroadNet sendiri; panduan ini mengikuti README openai-go untuk v3.99.0.

## Instalasi

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

Rilis saat ini membutuhkan Go 1.26 atau lebih baru.

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

Jalankan dengan `go run .`. Jawaban yang tercetak adalah tesnya: kunci, URL, dan ID model berfungsi.

-   **Model** adalah string biasa. `openai.ChatModel` adalah type alias untuk `string`, jadi ID BroadNet tidak perlu dikonversi.
-   **Gunakan `Chat.Completions`.** README dibuka dengan Responses API (`client.Responses.New`), yang tidak dicantumkan BroadNet. Bagian Chat Completions di README menyebut API itu “supported indefinitely” (terjemahan: didukung tanpa batas waktu).
-   **`MaxTokens` vs `MaxCompletionTokens`.** SDK menandai `max_tokens` sebagai deprecated dan menyarankan `max_completion_tokens`, tetapi referensi API BroadNet menjelaskan `max_tokens`. Gunakan `MaxTokens`.
-   **`SystemMessage`, bukan `DeveloperMessage`.** Contoh di README memakai `DeveloperMessage`, yang mengirim role `developer`. Referensi API BroadNet tidak menyebut role itu, jadi gunakan `system` dan `user`.

## Streaming dengan 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)
}
```

Menurut dokumentasi BroadNet, usage dikirim di chunk terakhir jika `stream_options.include_usage` bernilai true; chunk itu tidak berisi choices, karena itulah ada pengecekan panjang. Lihat [streaming chat completions](https://broadrouter.com/id/guides/streaming-chat-completions/) untuk format datanya.

## Error dan percobaan ulang

SDK mengembalikan `*openai.Error` untuk status yang tidak sukses. Gunakan `errors.As` dan baca `StatusCode`:

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

Secara default openai-go mengulang beberapa jenis error dua kali dengan exponential backoff singkat. Ubah dengan `option.WithMaxRetries(n)`. Percobaan ulang ikut dihitung dalam rate limit BroadNet.

## Troubleshooting

-   **401.** Kunci salah, kedaluwarsa, atau jatahnya habis. Jika Anda tidak memberikan `WithAPIKey`, SDK memakai `OPENAI_API_KEY`.
-   **404.** Base URL harus diakhiri `/v1`, dan panggilan harus ke `Chat.Completions`, bukan `Responses`. Lalu periksa ID model. Model berbayar memerlukan top up; kredit $5 hanya mencakup `broadnet/gemma-4-26b-a4b`.
-   **`Content` kosong.** Penalaran menghabiskan jatah output. Naikkan `MaxTokens`. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. Batasi jumlah goroutine yang memanggil API sekaligus. Lihat [error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).

## Istilah dalam panduan ini

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

Base URL adalah alamat root tetap sebuah API, seperti https://api.example.com/v1, yang ditempatkan client di depan setiap path endpoint, seperti /chat/completions. Di SDK yang kompatibel dengan OpenAI, mengganti base URL bersama kunci API dan ID model akan mengarahkan kode yang sama ke penyedia lain.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

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

Streaming adalah cara mengembalikan respons model bahasa dalam potongan-potongan kecil selagi masih dihasilkan, bukan sebagai satu balasan utuh di akhir. API yang kompatibel dengan OpenAI melakukan streaming lewat server-sent events jika permintaan mengatur stream ke true.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

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

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

[Exponential backoff](https://broadrouter.com/id/glossary/exponential-backoff/)

Exponential backoff adalah strategi percobaan ulang di mana client menunggu makin lama setelah setiap percobaan yang gagal, biasanya menggandakan jedanya sampai batas tertentu, sebelum mencoba lagi. Menambahkan jitter acak pada setiap jeda menyebarkan percobaan ulang dari banyak client agar tidak menghantam server pada saat yang sama.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

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

API kompatibel OpenAI adalah API HTTP yang menerima format permintaan dan respons yang sama dengan API OpenAI, seperti POST /v1/chat/completions, sehingga SDK dan tool OpenAI bisa memakainya hanya dengan mengganti base URL, kunci API, dan nama model.

## Pertanyaan umum

### Bisakah URL BroadNet diatur lewat environment variable, bukan option?

Bisa. Secara default openai-go membaca OPENAI\_API\_KEY dan OPENAI\_BASE\_URL, jadi openai.NewClient() tanpa option sudah jalan jika keduanya berisi nilai BroadNet. option.WithBaseURL yang ditulis eksplisit akan menimpa OPENAI\_BASE\_URL.

### Bagaimana memberikan ID model BroadNet jika Model mengharapkan openai.ChatModel?

Di openai-go, ChatModel adalah type alias untuk string, jadi Model "broadnet/glm-5.3" langsung bisa dikompilasi apa adanya.

### Kenapa memakai SystemMessage dan bukan DeveloperMessage?

DeveloperMessage mengirim role developer, yang diperkenalkan OpenAI untuk model-modelnya sendiri. Referensi API BroadNet tidak menyebut role itu, jadi role system standar adalah pilihan yang lebih aman.

### Versi Go berapa yang dibutuhkan?

openai-go v3 saat ini membutuhkan Go 1.26 atau lebih baru. README-nya menyarankan pin ke v3.74.0 jika Anda harus tetap di Go 1.25.

## Panduan terkait

-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [Memakai OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-node-sdk/)
-   [Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [Semua alat yang bisa dipakai dengan BroadNet Inference (bahasa Inggris)](https://broadrouter.com/integrations/): SDK, agen coding, antarmuka chat, dan alat otomatisasi, lengkap dengan pengaturan persis untuk masing-masing

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

-   [README openai-go (v3.99.0, Go 1.26+) (diperiksa 2026-11-15)](https://github.com/openai/openai-go)
-   [Kode sumber openai-go, ChatCompletionNewParams dan option.WithBaseURL (diperiksa 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [Referensi API BroadNet Inference (diperiksa 2026-11-15) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-go-sdk&utm_content=sources)
