Première requête en Go avec openai-go : base URL, clé, usage

Vous avez déjà du code Go qui parle à une API de style OpenAI, ou vous êtes sur le point d'en écrire. Pour l'envoyer à CheapTokens, vous changez deux options sur le client et une chaîne, l'id du modèle. Le SDK reste le même : le package officiel openai-go, v3.

Ci-dessous le programme complet, puis ce que fait chaque ligne, comment lire la réponse et les compteurs de tokens, et comment empêcher une requête bloquée de suspendre votre service. Versions vérifiées par rapport au README d'openai-go le 3 novembre 2026 : le dernier tag sur cette page est v3.91.1, et il nécessite Go 1.26 ou plus récent.

Ce qu'il vous faut avant de commencer#

• Go 1.26 ou plus récent. Sur Go 1.25, épinglez v3.74.0 ; sur Go 1.22–1.24, épinglez v3.44.0 (le README indique que l'ancienne branche ne reçoit aucune correction garantie).
• Une clé API CheapTokens. Gardez-la dans une variable d'environnement, pas dans le fichier source.
• L'adresse de l'API : https://api.cheaptokens.dev/v1. Elle parle le format OpenAI Chat Completions, donc openai-go fonctionne sans wrapper. La documentation contient la même adresse et la page des clés.
• Un id de modèle. Nous utilisons deepseek-ai/DeepSeek-V4-Flash-0731 : 380K de contexte et jusqu'à 32 768 tokens dans une réponse. Utilisez l'id complet ; le nom court des tableaux de prix n'est pas accepté par l'API.

go mod init example.com/first-request
go get -u 'github.com/openai/openai-go/[email protected]'

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Le programme complet#

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

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

func main() {
	client := openai.NewClient(
		option.WithBaseURL("https://api.cheaptokens.dev/v1"),
		option.WithAPIKey(os.Getenv("CHEAPTOKENS_API_KEY")),
		option.WithMaxRetries(2),
		option.WithRequestTimeout(30*time.Second),
	)

	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
	defer cancel()

	resp, err := client.Chat.Completions.New(ctx, openai.ChatCompletionNewParams{
		Model: "deepseek-ai/DeepSeek-V4-Flash-0731",
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.UserMessage("Explain in two sentences what a token is."),
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	if len(resp.Choices) == 0 {
		log.Fatal("no choices in the response")
	}

	fmt.Println(resp.Choices[0].Message.Content)
	fmt.Println("finish_reason:", resp.Choices[0].FinishReason)
	fmt.Println("input tokens:", resp.Usage.PromptTokens)
	fmt.Println("output tokens:", resp.Usage.CompletionTokens)
	fmt.Println("total tokens:", resp.Usage.TotalTokens)
}

Les éléments qui comptent :

• option.WithBaseURL(...) est la seule ligne qui fait passer le SDK d'OpenAI à CheapTokens. Utilisez l'adresse exactement comme dans la documentation.
• option.WithAPIKey(os.Getenv(...)) passe la clé explicitement. Sans elle, le client lit OPENAI_API_KEY, ce qui est pratique quand vous portez du code existant : définissez cette variable sur une clé CheapTokens et le code n'a besoin d'aucun changement de clé. Il en va de même pour OPENAI_BASE_URL, mais un WithBaseURL explicite le remplace, donc pas de surprise si les deux existent.
• Model est une simple chaîne dans le SDK (ChatModel est un alias de string), donc n'importe quel id de modèle fonctionne, pas seulement les constantes montrées dans le README.
• openai.UserMessage(...) est un tour utilisateur. L'exemple du README utilise DeveloperMessage et une constante GPT ; ici un message utilisateur et un id sous forme de chaîne suffisent.

Lire la réponse, finish_reason et usage#

Les trois proviennent de champs que le SDK analyse déjà pour vous :

• resp.Choices[0].Message.Content est le texte (un string).
• resp.Choices[0].FinishReason est aussi un string. stop signifie que le modèle a terminé de lui-même ; length signifie que la réponse a atteint la limite de tokens et a été coupée. Si vous voyez length, lisez pourquoi une réponse s'arrête en milieu de phrase.
• resp.Usage contient PromptTokens (ce que vous avez envoyé), CompletionTokens (ce que le modèle a écrit) et TotalTokens, tous des int64.

La sortie ressemblera à ceci : la réponse, puis finish_reason: avec une valeur, puis trois compteurs de tokens. Les chiffres diffèrent à chaque exécution, donc journalisez-les. C'est ce que vous payez, et les tokens de sortie sont le côté le plus cher.

Retries et timeouts : trois limites différentes#

C'est là que les services Go souffrent généralement : par défaut, le SDK n'a aucun timeout, donc une connexion bloquée peut attendre indéfiniment. Trois réglages corrigent cela, et ils agissent à des niveaux différents :

• option.WithMaxRetries(2) : le SDK réessaie les erreurs de connexion, 408, 409, 429 et 5xx avec une courte attente exponentielle. Deux retries est déjà la valeur par défaut ; 0 désactive les retries. Vous pouvez le définir sur le client, ou sur un appel unique.
• option.WithRequestTimeout(30*time.Second) : la limite pour une tentative.
• La deadline du context : la limite pour l'appel entier, retries et attentes inclus.

Donc avec 2 retries, il peut y avoir jusqu'à 3 tentatives : 3 × 30 = 90 secondes d'attente au pire, plus les courtes pauses entre les tentatives. Un contexte de deux minutes couvre cela. Si vous voulez une règle stricte de réponse en 20 secondes pour un handler web, raccourcissez le contexte, pas seulement le timeout par tentative.

Pour un contexte plus long sur le choix de ces chiffres, la version Python du même conseil se trouve dans OpenAI Python SDK timeout and retries. La logique se transpose en Go.

Combien coûtent mille de ces appels#

Disons que vous exploitez un petit service qui fait 1 000 requêtes par jour, chacune avec environ 800 tokens d'entrée et 300 tokens de sortie. Sur deepseek-ai/DeepSeek-V4-Flash-0731, cette journée coûte $0.042 (1 000 × 800 tokens d'entrée, 1 000 × 300 tokens de sortie). Le tableau montre la même charge sur nos modèles ; compté au total, entrée et sortie ensemble, c'est moins cher qu'OpenRouter.

Mettez vos propres chiffres. Votre première exécution affiche les vrais PromptTokens et CompletionTokens, donc vous n'avez pas à deviner la moyenne :

Les prix sur la page de tarification et la page des modèles sont à jour et utilisent un prix fixe par modèle, sans heures de pointe.

Si ça ne fonctionne pas#

• L'erreur mentionne 401 : la clé est vide ou incorrecte. os.Getenv renvoie une chaîne vide pour une variable non définie, donc vérifiez echo $CHEAPTOKENS_API_KEY dans le même terminal où vous lancez go run ..
• L'erreur mentionne 404 ou un modèle inconnu : l'id. Copiez-le en entier, avec le préfixe deepseek-ai/. Vous pouvez lister les ids dans l'appel de liste des modèles.
• go: module requires Go 1.26 : votre toolchain est plus ancien. Épinglez un tag SDK plus ancien comme indiqué en haut.
• L'appel se bloque puis échoue : c'est le timeout qui fait son travail. Vérifiez d'abord le chemin réseau, puis augmentez WithRequestTimeout si le modèle a vraiment besoin de plus de temps pour une longue réponse.

Si l'idée de base URL est nouvelle pour vous, ce qu'est base_url et comment basculer l'explique sans code.