API OpenAI Chat Completions

Appelez Chat Completions OpenAI compatible avec POST https://bettertoken.ai/v1/chat/completions. La plupart des outils externes utilisent la Base URL https://bettertoken.ai/v1 et ajoutent eux-mêmes /chat/completions.

Paramètres principaux

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

Prérequis

• Créez une BetterToken API Key
• Copiez un Model ID depuis le model plaza ou la boîte de dialogue Setup de la Key
• Préparez un terminal avec curl, ou Python 3 / Node.js

Installation

curl

curl ne nécessite pas de SDK. Vérifiez que curl --version fonctionne dans votre terminal.

Python

python -m pip install openai

JavaScript

npm install openai

Configuration manuelle

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);

Vérifier la connexion

Dans le Playground à droite :

1. Saisissez YOUR_API_KEY sous Authorization.
2. Remplacez model par YOUR_MODEL_ID.
3. Modifiez messages et envoyez la Request.

Le Playground utilise déjà l’URL complète https://bettertoken.ai/v1/chat/completions.

Une réponse 200 avec la sortie du modèle dans choices[0].message.content confirme la connexion.

Changer de modèle

Remplacez YOUR_MODEL_ID par le Model ID complet du model plaza ou de la boîte de dialogue Setup. Ne raccourcissez pas le Model ID selon son nom d’affichage.

Erreurs fréquentes

Erreur	Correction
401	Confirmez Authorization: Bearer YOUR_API_KEY, puis copiez à nouveau la BetterToken API Key.
404	Les appels HTTP directs utilisent https://bettertoken.ai/v1/chat/completions ; le SDK base_url utilise https://bettertoken.ai/v1.
Model not found	Utilisez le Model ID complet du model plaza ou de la boîte de dialogue Setup.
Invalid request	Confirmez que messages est un tableau et que chaque élément possède role et content.

Détails techniques

Base URL et URL complète de Request

Les outils qui exigent une URL de Request complète, comme GitHub Copilot et TRAE, utilisent https://bettertoken.ai/v1/chat/completions. Les outils qui ajoutent eux-mêmes le chemin, comme Cursor, Cline, OpenCode, n8n et Dify, utilisent uniquement https://bettertoken.ai/v1.

POST/v1/chat/completionsEssayer

Autorisations

Authorizationstringheaderrequis

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

Corps application/json

modelstringrequis

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

Exemple:"YOUR_MODEL_ID"

messagesobject[]requis

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

messages[].rolestringrequis

Exemple:"user"

messages[].contentstringrequis

Exemple:"Hello"

streambooleandéfaut: false

Whether to request a streaming response.

Réponse

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.