API OpenAI Chat Completions

cURL

curl 'https://www.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://www.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://www.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://www.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://www.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://www.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://www.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

{}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

POST

chat

completions

cURL

curl 'https://www.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://www.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://www.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://www.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://www.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://www.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://www.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

{}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

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

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Full request URL	`https://www.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://www.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://www.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://www.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://www.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://www.bettertoken.ai/v1/chat/completions` ; le SDK `base_url` utilise `https://www.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://www.bettertoken.ai/v1/chat/completions. Les outils qui ajoutent eux-mêmes le chemin, comme Cursor, Cline, OpenCode, n8n et Dify, utilisent uniquement https://www.bettertoken.ai/v1.

Autorisations

Authorization

string

header

requis

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

Corps

application/json

model

string

requis

GPT 提供商中可用的模型 ID。请以模型广场当前显示的模型为准。

Exemple:

"YOUR_MODEL_ID"

messages

object[]

requis

对话消息数组。每项应包含 role 和 content。

Minimum array length: 1

Show child attributes

stream

boolean

défaut:false

是否请求流式响应。

Réponse

GPT 提供商模型返回的 Chat Completions API 响应。

OpenAI-compatible Chat Completions API 响应。实际字段会随所选模型和请求参数变化。

​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