OpenAI- und Anthropic-SDKs mit BetterToken nutzen

Nutze das OpenAI-SDK mit der Base URL https://bettertoken.ai/v1 oder das Anthropic-SDK mit https://bettertoken.ai. Die Beispiele senden mit deinem BetterToken API Key eine kurze Textanfrage über Chat Completions, Responses oder Messages.

SDK und Base URL wählen

API	SDK	Base URL	Authentifizierung per HTTP	Referenz
Chat Completions	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Referenz für Chat Completions
Responses	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Responses
Messages	Anthropic	`https://bettertoken.ai`, ohne `/v1`	`x-api-key: YOUR_API_KEY`	Messages

Das SDK ergänzt den Endpunktpfad und die Authentifizierungsheader. Das Anthropic-SDK sendet außerdem den Header für die API-Version. Wenn du bestehenden Code anpasst, hilft der Protokollvergleich.

Voraussetzungen

Folge dem Schnellstart, um einen BetterToken API Key zu erstellen und Guthaben aufzuladen. Kopiere aus der model plaza eine Model ID, die für den gewünschten Endpunkt verfügbar ist. Ersetze beide Platzhalter, bevor du eine Anfrage sendest. Setze diese Variablen in dem Terminal, in dem du die Beispiele ausführst. Die Shell-Befehle auf dieser Seite verwenden die Syntax für macOS / Linux:

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

Installiere die SDKs für Python in der virtuellen Umgebung deines Projekts:

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

Installiere für JavaScript die Pakete im Projekt. Speichere jedes Beispiel in einer eigenen .mjs-Datei und führe es mit node aus:

npm install openai @anthropic-ai/sdk

Alle Beispiele lesen den Key aus BETTERTOKEN_API_KEY. Sie deaktivieren SDK-Wiederholungen, damit ein Test nicht unbemerkt mehrere Versuche auslöst. Hinweise zu Wiederholungsregeln für deine Anwendung findest du unter Fehler und Limits.

Chat Completions aufrufen

Verwende messages für die Eingabekonversation. Eine erfolgreiche Textantwort enthält 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\"}]}"

Responses aufrufen

Verwende input für den Prompt. Die OpenAI-SDKs stellen mit output_text eine Eigenschaft für den bequemen Textzugriff bereit; die HTTP-Antwort im JSON-Format enthält ein output-Array. Prüfe die Nachrichtenelemente und deren Textinhalt, statt für jedes Ausgabeelement Text vorauszusetzen.

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\"}"

Messages aufrufen

Verwende messages und gib max_tokens an. Bei dieser kurzen Textanfrage enthält eine erfolgreiche Antwort einen Textblock wie content[0].text. Durchlaufe grundsätzlich content und lies nur Blöcke mit 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\"}]}"

Häufige Fehler

Symptom	Prüfung und Lösung
Falsche URL oder `404`	Die Base URL des OpenAI-SDKs enthält `/v1`, die des Anthropic-SDKs nicht. Hänge die endgültige Route nicht an die Base URL eines SDKs an.
`401` oder fehlende Zugangsdaten	Die Beispiele übergeben den Key ausdrücklich aus `BETTERTOKEN_API_KEY`. Direkte OpenAI-Anfragen verwenden Bearer, direkte Messages-Anfragen `x-api-key`.
Modell nicht gefunden	Ersetze `YOUR_MODEL_ID` durch eine exakte, verfügbare Model ID aus der model plaza. Prüfe sie für den gewählten Endpunkt.
Anfragen erreichen einen alten Endpunkt	Prüfe SDK-Argumente und geerbte Variablen; siehe konfligierende Umgebungsvariablen löschen.
Leerer Text oder unvollständige Antwort	Prüfe die vollständige Antwort und den Abbruchgrund; siehe Limits für Ausgabetokens.

Kann ich denselben Key für beide SDKs verwenden?

Ja. Ein BetterToken API Key funktioniert mit allen verfügbaren Modellen. Verwende für jedes SDK die passende Base URL und das passende Anfrageformat.

Kann ich Streaming, Tools oder strukturierte Ausgaben ergänzen?

Die Unterstützung für Streaming und Tool-Aufrufe hängt vom Modell ab. Teste zunächst eine kleine Anfrage mit deiner Model ID; nutze die Anleitung zu Streaming und Tool-Aufrufen. Für JSON-Validierung und modellabhängige strukturierte Ausgaben hilft die FAQ zu strukturiertem JSON.

API-Referenz

Entwicklerleitfäden

OpenAI- und Anthropic-SDKs mit BetterToken nutzen

SDK und Base URL wählen

Voraussetzungen

Chat Completions aufrufen

Responses aufrufen

Messages aufrufen

Häufige Fehler

Kann ich denselben Key für beide SDKs verwenden?

Kann ich Streaming, Tools oder strukturierte Ausgaben ergänzen?

Weitere Informationen

Offizielle Referenzen

​SDK und Base URL wählen

​Voraussetzungen

​Chat Completions aufrufen

​Responses aufrufen

​Messages aufrufen

​Häufige Fehler

​Kann ich denselben Key für beide SDKs verwenden?

​Kann ich Streaming, Tools oder strukturierte Ausgaben ergänzen?

​Weitere Informationen

​Offizielle Referenzen

SDK und Base URL wählen

Voraussetzungen

Chat Completions aufrufen

Responses aufrufen

Messages aufrufen

Häufige Fehler

Kann ich denselben Key für beide SDKs verwenden?

Kann ich Streaming, Tools oder strukturierte Ausgaben ergänzen?

Weitere Informationen

Offizielle Referenzen