---
title: "openai-go مع base URL مخصّص (WithBaseURL) | BroadRouter"
description: "استخدم حزمة openai-go v3 الرسمية مع BroadNet Inference عبر option.WithBaseURL: إكمال المحادثات، والبث مع بيانات الاستخدام، ومعالجة الأخطاء في Go."
url: https://broadrouter.com/ar/guides/openai-go-sdk/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/openai-go-sdk/) (حُدّث في 2026-11-16).

# استدعاء BroadNet Inference من Go بحزمة openai-go

آخر تحديث 2026-11-16

ثبّت github.com/openai/openai-go/v3 وأنشئ العميل مع option.WithBaseURL("https://inference.broadnet.ai/v1") وoption.WithAPIKey مضبوطًا على مفتاح BroadNet. استدعِ client.Chat.Completions.New مع معرّف نموذج من BroadNet مثل broadnet/glm-5.3 كسلسلة نصية عادية. استخدم إكمال المحادثات لا Responses API، واضبط MaxTokens بما يترك مساحة للاستدلال المنطقي.

`openai-go` هي مكتبة Go الرسمية من OpenAI. تقبل base URL مخصّصًا عبر `option.WithBaseURL`، لذا يمكنها استدعاء أي واجهة API متوافقة مع OpenAI. ويقدّم BroadNet Inference إكمال المحادثات على `https://inference.broadnet.ai/v1`. موقع BroadRouter هو موقع BroadNet نفسها، ويتبع هذا الدليل ملف README لـ openai-go في الإصدار v3.99.0.

## التثبيت

```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 .`. ظهور إجابة مطبوعة هو اختبارك: المفتاح والعنوان ومعرّف النموذج تعمل.

-   **الحقل Model** سلسلة نصية عادية. فـ `openai.ChatModel` اسم بديل للنوع `string`، لذا لا تحتاج معرّفات BroadNet إلى أي تحويل.
-   **استخدم `Chat.Completions`.** يبدأ ملف README بـ Responses API (`client.Responses.New`)، وهي واجهة لا يدرجها BroadNet. ويقول قسم Chat Completions في الملف إن تلك الواجهة “supported indefinitely” (ترجمة: مدعومة إلى أجل غير مسمّى).
-   **`MaxTokens` مقابل `MaxCompletionTokens`.** تَسِم حزمة SDK الحقل `max_tokens` بأنه مُهمَل (deprecated) لصالح `max_completion_tokens`، لكن المرجع التقني لـ BroadNet يصف `max_tokens`. استخدم `MaxTokens`.
-   **`SystemMessage` لا `DeveloperMessage`.** يستخدم مثال README الدالة `DeveloperMessage` التي ترسل الدور `developer`. لا يذكر المرجع التقني لـ BroadNet هذا الدور، فاستخدم `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، ومن هنا فحص الطول. راجع [البث المتدفق لإكمال المحادثات](https://broadrouter.com/ar/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 محاولة بعض الأخطاء مرتين افتراضيًا مع تراجع أُسّي قصير. غيّر ذلك بـ `option.WithMaxRetries(n)`. وتُحتسب إعادات المحاولة ضمن حدود المعدّل في BroadNet.

## حل المشكلات

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استُنفدت حصته. وإذا لم تمرّر `WithAPIKey`، فقد استخدمت حزمة SDK المتغير `OPENAI_API_KEY`.
-   **404.** يجب أن ينتهي base URL بـ `/v1`، وأن يذهب الاستدعاء إلى `Chat.Completions` لا `Responses`. ثم تحقّق من معرّف النموذج. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلا `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **`Content` فارغ.** استهلك الاستدلال المنطقي ميزانية المخرجات. ارفع `MaxTokens`. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. قلّل عدد goroutines التي تستدعي الواجهة في وقت واحد. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

## مصطلحات في هذا الدليل

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

## أسئلة شائعة

### هل يمكنني ضبط عنوان BroadNet بمتغيرات البيئة بدلًا من الخيارات؟

نعم. تقرأ openai-go المتغيرين OPENAI\_API\_KEY وOPENAI\_BASE\_URL افتراضيًا، لذا يعمل openai.NewClient() دون خيارات إذا كان المتغيران يحملان قيم BroadNet. ويتقدّم option.WithBaseURL الصريح على OPENAI\_BASE\_URL.

### كيف أمرّر معرّف نموذج BroadNet والحقل Model يتوقع openai.ChatModel؟

ChatModel في openai-go اسم بديل (type alias) للنوع string، لذا يُصرَّف (compile) الحقل Model "broadnet/glm-5.3" كما هو دون مشكلات.

### لماذا SystemMessage بدلًا من DeveloperMessage؟

ترسل DeveloperMessage الدور developer، وهو دور قدّمته OpenAI لنماذجها. لا يذكر المرجع التقني لـ BroadNet هذا الدور، لذا فالدور system المعتاد هو الخيار الأسلم.

### ما إصدار Go الذي أحتاجه؟

يتطلب الإصدار الحالي openai-go v3 الإصدار Go 1.26 أو أحدث. ويقول ملف README إن عليك تثبيت الإصدار v3.74.0 إن كنت مضطرًا إلى البقاء على Go 1.25.

## أدلة ذات صلة

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-go-sdk&utm_content=page-cta) ·

**المصادر**

-   [ملف README لـ openai-go (الإصدار 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=ar-guides-openai-go-sdk&utm_content=sources)
