API OpenAI Chat Completions

Chame Chat Completions compatível com OpenAI usando POST https://bettertoken.ai/v1/chat/completions. A maioria das ferramentas externas recebe a Base URL https://bettertoken.ai/v1 e adiciona /chat/completions automaticamente.

Configurações principais

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

Pré-requisitos

• Crie uma BetterToken API Key
• Copie um ID de modelo da model plaza ou da caixa Setup da chave
• Prepare um terminal com curl ou Python 3 / Node.js

Instalação

curl

curl não precisa de SDK. Confirme que curl --version funciona no terminal.

Python

python -m pip install openai

JavaScript

npm install openai

Configuração manual

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

SDK Python

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)

SDK JavaScript

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

Verificar a conexão

No Playground à direita:

1. Informe YOUR_API_KEY em Authorization.
2. Substitua model por YOUR_MODEL_ID.
3. Edite messages e envie a solicitação.

O Playground já usa a URL completa https://bettertoken.ai/v1/chat/completions.

Uma resposta 200 com saída do modelo em choices[0].message.content confirma a conexão.

Trocar de modelo

Substitua YOUR_MODEL_ID pelo ID completo da model plaza ou da caixa Setup. Não encurte o ID com base no nome exibido.

Erros comuns

Erro	Correção
401	Confirme Authorization: Bearer YOUR_API_KEY e copie novamente a BetterToken API Key.
404	Chamadas HTTP diretas usam https://bettertoken.ai/v1/chat/completions; base_url de SDK usa https://bettertoken.ai/v1.
Modelo não encontrado	Use o ID completo da model plaza ou da caixa Setup.
Solicitação inválida	Confirme que messages é um array e que cada item tem role e content.

Detalhes técnicos

Base URL e URL completa da solicitação

Ferramentas que exigem uma URL completa, como GitHub Copilot e TRAE, usam https://bettertoken.ai/v1/chat/completions. Ferramentas que adicionam o caminho sozinhas, como Cursor, Cline, OpenCode, n8n e Dify, usam apenas https://bettertoken.ai/v1.

POST/v1/chat/completionsExperimentar

Autorizações

Authorizationstringheaderobrigatório

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

Corpo application/json

modelstringobrigatório

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

Exemplo:"YOUR_MODEL_ID"

messagesobject[]obrigatório

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

messages[].rolestringobrigatório

Exemplo:"user"

messages[].contentstringobrigatório

Exemplo:"Hello"

streambooleanpadrão: false

Whether to request a streaming response.

Resposta

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.