OpenAI Chat Completions API

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

Call OpenAI-compatible Chat Completions with POST https://www.bettertoken.ai/v1/chat/completions. Most external tools take the Base URL https://www.bettertoken.ai/v1 and append /chat/completions themselves.

Key settings

Field	Value
API Key	BetterToken API Key
Full request URL	`https://www.bettertoken.ai/v1/chat/completions`
Model	`YOUR_MODEL_ID`

Prerequisites

Create a BetterToken API Key
Copy a Model ID from the model plaza or the key Setup dialog
Prepare a terminal with curl, or Python 3 / Node.js

Install

curl
Python
JavaScript

curl needs no SDK. Confirm that curl --version works in your terminal.

python -m pip install openai

npm install openai

Manual setup

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

Verify the connection

In the Playground on the right:

Enter YOUR_API_KEY under Authorization.
Replace model with YOUR_MODEL_ID.
Edit messages and send the request.

The Playground already uses the complete URL https://www.bettertoken.ai/v1/chat/completions. A 200 response with model output in choices[0].message.content confirms the connection.

Switch models

Replace YOUR_MODEL_ID with the complete Model ID from the model plaza or Setup dialog. Do not shorten the Model ID based on its display name.

Common errors

Error	Fix
`401`	Confirm `Authorization: Bearer YOUR_API_KEY`, then copy the BetterToken API Key again.
`404`	Direct HTTP calls use `https://www.bettertoken.ai/v1/chat/completions`; SDK `base_url` uses `https://www.bettertoken.ai/v1`.
Model not found	Use the complete Model ID from the model plaza or Setup dialog.
Invalid request	Confirm that `messages` is an array and every item has `role` and `content`.

Advanced setup

Supported providers

Provider	Status
Claude	Not supported
GPT	Manual setup
Kimi	Manual setup
GLM	Manual setup

Statuses apply to the BetterToken setup documented on this page.

What the setup methods mean

Manual setup: enter the API Key, Base URL, and Model.
Not supported: no verified direct setup is currently available.

Technical details

Base URL and full request URL

Tools that require a complete request URL, such as GitHub Copilot and TRAE, use https://www.bettertoken.ai/v1/chat/completions. Tools that append the path themselves, such as Cursor, Cline, OpenCode, n8n, and Dify, use only https://www.bettertoken.ai/v1.

Authorizations

Authorization

string

header

required

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

Body

application/json

model

string

required

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

Example:

"YOUR_MODEL_ID"

messages

object[]

required

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

Minimum array length: 1

Show child attributes

stream

boolean

default:false

是否请求流式响应。

Response

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

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

​Key settings

​Prerequisites

​Install

​Manual setup

​curl

​Python SDK

​JavaScript SDK

​Verify the connection

​Switch models

​Common errors

​Advanced setup

​Supported providers

​Technical details

Authorizations

Body

Response

Key settings

Prerequisites

Install

Manual setup

curl

Python SDK

JavaScript SDK

Verify the connection

Switch models

Common errors

Advanced setup

Supported providers

Technical details