---
title: "openai-go con una base URL personalizada (WithBaseURL)"
description: "Use el SDK oficial openai-go v3 con BroadNet Inference mediante option.WithBaseURL: chat completions, streaming con datos de uso y manejo de errores en Go."
url: https://broadrouter.com/es/guides/openai-go-sdk/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/openai-go-sdk/) (actualizado el 2026-11-16).

# Llame a BroadNet Inference desde Go con el SDK openai-go

Actualizado 2026-11-16

Instale github.com/openai/openai-go/v3 y cree el cliente con option.WithBaseURL("https://inference.broadnet.ai/v1") y option.WithAPIKey con su clave de BroadNet. Llame a client.Chat.Completions.New con un ID de modelo de BroadNet, como broadnet/glm-5.3, como string normal. Use chat completions, no la Responses API, y defina MaxTokens con margen para el razonamiento.

`openai-go` es la biblioteca oficial de OpenAI para Go. Acepta una base URL personalizada con `option.WithBaseURL`, así que puede llamar a cualquier API compatible con OpenAI. BroadNet Inference ofrece chat completions en `https://inference.broadnet.ai/v1`. BroadRouter es el sitio de la propia BroadNet; esta guía sigue el README de openai-go para la v3.99.0.

## Instalación

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

La versión actual requiere Go 1.26 o posterior.

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

Ejecútelo con `go run .`. Si se imprime una respuesta, la prueba está hecha: la clave, la URL y el ID del modelo funcionan.

-   **Model** es un string normal. `openai.ChatModel` es un alias de tipo de `string`, así que los IDs de BroadNet no necesitan conversión.
-   **Use `Chat.Completions`.** El README empieza por la Responses API (`client.Responses.New`), que BroadNet no ofrece. Su sección de Chat Completions dice que esa API está “supported indefinitely” (traducción: admitida de forma indefinida).
-   **`MaxTokens` frente a `MaxCompletionTokens`.** El SDK marca `max_tokens` como obsoleto en favor de `max_completion_tokens`, pero la referencia de la API de BroadNet describe `max_tokens`. Use `MaxTokens`.
-   **`SystemMessage`, no `DeveloperMessage`.** El ejemplo del README usa `DeveloperMessage`, que envía el rol `developer`. La referencia de la API de BroadNet no menciona ese rol, así que use `system` y `user`.

## Streaming con datos de uso

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

La documentación de BroadNet indica que el uso llega en el último chunk cuando `stream_options.include_usage` es true; ese chunk no tiene choices, de ahí la comprobación de longitud. Consulte [streaming de chat completions](https://broadrouter.com/es/guides/streaming-chat-completions/) para ver el formato de los datos.

## Errores y reintentos

El SDK devuelve `*openai.Error` para los estados que no son de éxito. Use `errors.As` y lea `StatusCode`:

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

openai-go reintenta algunos errores dos veces por defecto, con un backoff exponencial corto. Cámbielo con `option.WithMaxRetries(n)`. Los reintentos cuentan para los límites de tasa de BroadNet.

## Solución de problemas

-   **401.** La clave es incorrecta, caducó o se quedó sin saldo. Si no pasó `WithAPIKey`, el SDK usó `OPENAI_API_KEY`.
-   **404.** La base URL debe terminar en `/v1`, y la llamada debe ir a `Chat.Completions`, no a `Responses`. Después revise el ID del modelo. Los modelos de pago requieren una recarga; el crédito de $5 cubre solo `broadnet/gemma-4-26b-a4b` y los dos modelos Transcribe.
-   **`Content` vacío.** El razonamiento consumió el presupuesto de salida. Aumente `MaxTokens`. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 en curso. Limite las goroutines que llaman a la API al mismo tiempo. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).

## Términos de esta guía

[Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/)

El streaming es una forma de devolver la respuesta de un modelo de lenguaje en pequeños fragmentos mientras aún se genera, en lugar de una sola respuesta al final. Las APIs compatibles con OpenAI hacen streaming mediante server-sent events cuando la solicitud define stream como true.

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

La URL base es la dirección raíz fija de una API, como https://api.example.com/v1, que un cliente antepone a cada ruta de endpoint, como /chat/completions. En los SDKs compatibles con OpenAI, cambiar la URL base, junto con la clave de API y el ID del modelo, dirige el mismo código a otro proveedor.

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

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

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

Una API compatible con OpenAI es una API HTTP que acepta los mismos formatos de solicitud y respuesta que la API de OpenAI, como POST /v1/chat/completions, de modo que los SDKs y herramientas de OpenAI pueden usarla cambiando solo la URL base, la clave de API y el nombre del modelo.

[Backoff exponencial (exponential backoff)](https://broadrouter.com/es/glossary/exponential-backoff/)

El backoff exponencial es una estrategia de reintento en la que el cliente espera más tiempo tras cada intento fallido, normalmente duplicando la espera hasta un tope, antes de volver a intentarlo. Añadir jitter aleatorio a cada espera dispersa los reintentos de muchos clientes para que no lleguen al servidor en el mismo instante.

## Preguntas frecuentes

### ¿Puedo definir la URL de BroadNet con variables de entorno en lugar de opciones?

Sí. openai-go lee OPENAI\_API\_KEY y OPENAI\_BASE\_URL por defecto, así que openai.NewClient() sin opciones funciona si ambas contienen los valores de BroadNet. Un option.WithBaseURL explícito tiene prioridad sobre OPENAI\_BASE\_URL.

### ¿Cómo paso un ID de modelo de BroadNet si Model espera openai.ChatModel?

En openai-go, ChatModel es un alias de tipo de string, así que Model "broadnet/glm-5.3" compila tal cual.

### ¿Por qué usar SystemMessage en lugar de DeveloperMessage?

DeveloperMessage envía el rol developer, que OpenAI introdujo para sus propios modelos. La referencia de la API de BroadNet no menciona ese rol, así que el rol system estándar es la opción más segura.

### ¿Qué versión de Go necesito?

La versión actual de openai-go v3 requiere Go 1.26 o posterior. Su README indica fijar v3.74.0 si debe quedarse en Go 1.25.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [Usar el SDK de OpenAI para Node.js con BroadNet Inference](https://broadrouter.com/es/guides/openai-node-sdk/)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

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

**Fuentes**

-   [README de openai-go (v3.99.0, Go 1.26+) (consultado el 2026-11-15)](https://github.com/openai/openai-go)
-   [Código fuente de openai-go, ChatCompletionNewParams y option.WithBaseURL (consultado el 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [Referencia de la API de BroadNet Inference (consultada el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-go-sdk&utm_content=sources)
