OpenAI Chat Completions API verwenden

Rufe OpenAI-kompatible Chat Completions mit POST https://bettertoken.ai/v1/chat/completions auf. Die meisten external tools verwenden die Base URL https://bettertoken.ai/v1 und hängen /chat/completions selbst an.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Full request URL	https://bettertoken.ai/v1/chat/completions
Model	YOUR_MODEL_ID

Voraussetzungen

• Erstelle einen BetterToken API Key
• Kopiere eine Model ID aus der model plaza oder dem Dialog Setup des Keys
• Bereite ein Terminal mit curl oder Python 3 / Node.js vor

Installation

curl

curl benötigt kein SDK. Stelle sicher, dass curl --version im Terminal funktioniert.

Python

python -m pip install openai

JavaScript

npm install openai

Manuelle Konfiguration

curl

curl "https://bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[
        {"role": "user", "content": "Hello"},
    ],
)

print(response.choices[0].message.content)

JavaScript SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://bettertoken.ai/v1",
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "Hello" }],
});

console.log(response.choices[0].message.content);

Verbindung prüfen

Im Playground auf der rechten Seite:

1. Trage YOUR_API_KEY unter Authorization ein.
2. Ersetze model durch YOUR_MODEL_ID.
3. Bearbeite messages und sende den Request.

Der Playground verwendet bereits die vollständige URL https://bettertoken.ai/v1/chat/completions.

Eine 200-Antwort mit Modellausgabe in choices[0].message.content bestätigt die Verbindung.

Modell wechseln

Ersetze YOUR_MODEL_ID durch die vollständige Model ID aus der model plaza oder dem Dialog Setup. Kürze die Model ID nicht anhand ihres Anzeigenamens.

Häufige Fehler

Fehler	Lösung
401	Bestätige Authorization: Bearer YOUR_API_KEY und kopiere dann den BetterToken API Key erneut.
404	Direkte HTTP-Aufrufe verwenden https://bettertoken.ai/v1/chat/completions; SDK-base_url verwendet https://bettertoken.ai/v1.
Modell nicht gefunden	Verwende die vollständige Model ID aus der model plaza oder dem Dialog Setup.
Ungültiger Request	Stelle sicher, dass messages ein Array ist und jedes Element role und content enthält.

Technische Details

Base URL und vollständige Request-URL

Tools, die eine vollständige Request-URL erfordern, etwa GitHub Copilot und TRAE, verwenden https://bettertoken.ai/v1/chat/completions. Tools, die den Pfad selbst anhängen, etwa Cursor, Cline, OpenCode, n8n und Dify, verwenden nur https://bettertoken.ai/v1.

POST/v1/chat/completionsAusprobieren

Autorisierungen

Authorizationstringheadererforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body application/json

modelstringerforderlich

A model ID currently available in the model plaza. Check the model plaza for the latest options.

Beispiel:"YOUR_MODEL_ID"

messagesobject[]erforderlich

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

messages[].rolestringerforderlich

Beispiel:"user"

messages[].contentstringerforderlich

Beispiel:"Hello"

streambooleanStandard: false

Whether to request a streaming response.

Antwort

200The Chat Completions result from the selected model.

400Invalid request format or parameters.

401The BetterToken API Key is missing or invalid.

402The account has insufficient credit or balance.

429The request exceeded a rate or concurrency limit, or the upstream service is busy.

500The gateway or upstream service returned an error.