SDK OpenAI et Anthropic : exemples avec BetterToken

Utilisez le SDK OpenAI avec la Base URL https://bettertoken.ai/v1, ou le SDK Anthropic avec https://bettertoken.ai. Les exemples envoient une courte requête de texte via Chat Completions, Responses ou Messages avec votre BetterToken API Key.

Choisir un SDK et une Base URL

API	SDK	Base URL	Authentification HTTP	Référence
Chat Completions	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Référence Chat Completions
Responses	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Responses
Messages	Anthropic	`https://bettertoken.ai`, sans `/v1`	`x-api-key: YOUR_API_KEY`	Messages

Le SDK ajoute le chemin de l’endpoint et les en-têtes d’authentification. Le SDK Anthropic envoie aussi l’en-tête de version de l’API. Si vous adaptez du code existant, consultez la comparaison des protocoles.

Prérequis

Suivez le démarrage rapide pour créer une BetterToken API Key et ajouter du crédit. Copiez depuis la model plaza un Model ID disponible pour l’endpoint que vous comptez appeler. Remplacez les deux valeurs d’exemple avant d’envoyer une requête. Définissez ces variables dans le terminal où vous exécuterez les exemples. Les commandes de cette page utilisent la syntaxe macOS / Linux :

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
export BETTERTOKEN_MODEL_ID="YOUR_MODEL_ID"

Pour Python, installez les SDK dans l’environnement virtuel de votre projet :

python3 -m venv .venv
source .venv/bin/activate
python -m pip install openai anthropic

Pour JavaScript, installez les paquets dans votre projet, enregistrez chaque exemple dans un fichier .mjs distinct, puis exécutez-le avec node :

npm install openai @anthropic-ai/sdk

Tous les exemples lisent la Key depuis BETTERTOKEN_API_KEY. Ils désactivent les nouvelles tentatives du SDK pour qu’un test ne déclenche pas plusieurs tentatives à votre insu. Pour définir la politique de votre application, consultez les erreurs et limites.

Appeler Chat Completions

Utilisez messages pour la conversation d’entrée. Une réponse de texte réussie contient choices[0].message.content.

Python
JavaScript
curl

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    messages=[{"role": "user", "content": "Reply with one word: OK"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai/v1",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  messages: [{ role: "user", content: "Reply with one word: OK" }],
});
console.log(response.choices[0].message.content);

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with one word: OK\"}]}"

Appeler Responses

Utilisez input pour le prompt. Les SDK OpenAI proposent la propriété output_text pour accéder au texte ; la réponse HTTP en JSON contient un tableau output. Examinez les éléments de type message et leur contenu textuel sans supposer que tous les éléments de sortie sont du texte.

Python
JavaScript
curl

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.responses.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    input="Reply with one word: OK",
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai/v1",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.responses.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  input: "Reply with one word: OK",
});
console.log(response.output_text);

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/responses" \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"input\":\"Reply with one word: OK\"}"

Appeler Messages

Utilisez messages et fournissez max_tokens. Pour cette courte requête, une réponse de texte réussie comprend un bloc tel que content[0].text. De manière générale, parcourez content et ne lisez que les blocs avec type: "text".

Python
JavaScript
curl

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai",
    timeout=120.0,
    max_retries=0,
)
response = client.messages.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with one word: OK"}],
)
for block in response.content:
    if block.type == "text":
        print(block.text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.messages.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with one word: OK" }],
});
for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/messages" \
  -H "x-api-key: $BETTERTOKEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"max_tokens\":256,\"messages\":[{\"role\":\"user\",\"content\":\"Reply with one word: OK\"}]}"

Erreurs fréquentes

Symptôme	Vérification et correction
URL incorrecte ou `404`	La Base URL du SDK OpenAI comprend `/v1` ; celle du SDK Anthropic ne le comprend pas. N’ajoutez pas la route finale à la Base URL d’un SDK.
`401` ou identifiant absent	Les exemples transmettent explicitement la Key depuis `BETTERTOKEN_API_KEY`. Les requêtes OpenAI directes utilisent Bearer ; les requêtes Messages directes utilisent `x-api-key`.
Modèle introuvable	Remplacez `YOUR_MODEL_ID` par un Model ID exact et disponible dans la model plaza. Vérifiez sa disponibilité pour l’endpoint choisi.
Les requêtes atteignent un ancien endpoint	Vérifiez les arguments du SDK et les variables héritées ; consultez effacer les variables d’environnement en conflit.
Texte vide ou réponse incomplète	Examinez la réponse complète et le motif d’arrêt ; consultez les limites de tokens de sortie.

Puis-je utiliser la même Key avec les deux SDK ?

Oui. Une BetterToken API Key fonctionne avec tous les modèles disponibles. Utilisez la Base URL et le format de requête propres à chaque SDK.

Puis-je ajouter le streaming, des outils ou une sortie structurée ?

La prise en charge du streaming et des appels d’outils varie selon le modèle. Testez d’abord une petite requête avec votre Model ID ; suivez le guide du streaming et des appels d’outils. Pour la validation JSON et la sortie structurée selon le modèle, consultez la FAQ sur le JSON structuré.

Référence de l'API

Guides de développement

SDK OpenAI et Anthropic : exemples avec BetterToken

Choisir un SDK et une Base URL

Prérequis

Appeler Chat Completions

Appeler Responses

Appeler Messages

Erreurs fréquentes

Puis-je utiliser la même Key avec les deux SDK ?

Puis-je ajouter le streaming, des outils ou une sortie structurée ?

Ressources associées

Références officielles

​Choisir un SDK et une Base URL

​Prérequis

​Appeler Chat Completions

​Appeler Responses

​Appeler Messages

​Erreurs fréquentes

​Puis-je utiliser la même Key avec les deux SDK ?

​Puis-je ajouter le streaming, des outils ou une sortie structurée ?

​Ressources associées

​Références officielles

Choisir un SDK et une Base URL

Prérequis

Appeler Chat Completions

Appeler Responses

Appeler Messages

Erreurs fréquentes

Puis-je utiliser la même Key avec les deux SDK ?

Puis-je ajouter le streaming, des outils ou une sortie structurée ?

Ressources associées

Références officielles