API OpenAI Chat Completions

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"}]
  }'

import requests

url = "https://bettertoken.ai/v1/chat/completions"

payload = {
    "model": "YOUR_MODEL_ID",
    "messages": [
        {
            "role": "user",
            "content": "Hello"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: 'YOUR_MODEL_ID', messages: [{role: 'user', content: 'Hello'}]})
};

fetch('https://bettertoken.ai/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bettertoken.ai/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'YOUR_MODEL_ID',
    'messages' => [
        [
                'role' => 'user',
                'content' => 'Hello'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bettertoken.ai/v1/chat/completions"

	payload := strings.NewReader("{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1/chat/completions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.ai/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

POST

chat

completions

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"}]
  }'

import requests

url = "https://bettertoken.ai/v1/chat/completions"

payload = {
    "model": "YOUR_MODEL_ID",
    "messages": [
        {
            "role": "user",
            "content": "Hello"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: 'YOUR_MODEL_ID', messages: [{role: 'user', content: 'Hello'}]})
};

fetch('https://bettertoken.ai/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bettertoken.ai/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'YOUR_MODEL_ID',
    'messages' => [
        [
                'role' => 'user',
                'content' => 'Hello'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bettertoken.ai/v1/chat/completions"

	payload := strings.NewReader("{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1/chat/completions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.ai/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"YOUR_MODEL_ID\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

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
Python
JavaScript

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

python -m pip install openai

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 :

Saisissez YOUR_API_KEY sous Authorization.
Remplacez model par YOUR_MODEL_ID.
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`.

Configuration avancée

Fournisseurs compatibles

Fournisseur	État
Claude	Non compatible
GPT	Configuration manuelle
Kimi	Configuration manuelle
GLM	Configuration manuelle

Les états concernent la méthode de configuration de BetterToken décrite sur cette page.

Signification des méthodes de configuration

Configuration manuelle : saisissez l’API Key, la Base URL et le Model.
Non compatible : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.

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.

Autorisations

Authorization

string

header

requis

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

Corps

application/json

model

string

requis

A model ID currently available from a GPT provider. Check the model plaza for the latest options.

Exemple:

"YOUR_MODEL_ID"

messages

object[]

requis

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

stream

boolean

défaut:false

Whether to request a streaming response.

Réponse

The Chat Completions result from the selected model.

​Paramètres principaux

​Prérequis

​Installation

​Configuration manuelle

​curl

​Python SDK

​JavaScript SDK

​Vérifier la connexion

​Changer de modèle

​Erreurs fréquentes

​Configuration avancée

​Fournisseurs compatibles

​Détails techniques

Autorisations

Corps

Réponse

Paramètres principaux

Prérequis

Installation

Configuration manuelle

curl

Python SDK

JavaScript SDK

Vérifier la connexion

Changer de modèle

Erreurs fréquentes

Configuration avancée

Fournisseurs compatibles

Détails techniques