API Chat Completions de OpenAI

Llama a Chat Completions compatible con OpenAI mediante POST https://bettertoken.ai/v1/chat/completions. La mayoría de las herramientas externas reciben la Base URL https://bettertoken.ai/v1 y añaden /chat/completions automáticamente.

Ajustes principales

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

Requisitos previos

• Crea una BetterToken API Key
• Copia un ID de modelo desde la model plaza o desde el cuadro Setup de la Key
• Prepara una terminal con curl, o Python 3 / Node.js

Instalación

curl

curl no necesita SDK. Confirma que curl --version funcione en tu terminal.

Python

python -m pip install openai

JavaScript

npm install openai

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

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

Verificar la conexión

En el Playground de la derecha:

1. Introduce YOUR_API_KEY en Authorization.
2. Sustituye model por YOUR_MODEL_ID.
3. Edita messages y envía la solicitud.

El Playground ya usa la URL completa https://bettertoken.ai/v1/chat/completions.

Una respuesta 200 que incluya la salida del modelo en choices[0].message.content confirma la conexión.

Cambiar de modelo

Sustituye YOUR_MODEL_ID por el ID de modelo completo de la model plaza o del cuadro Setup. No acortes el ID según su nombre visible.

Errores frecuentes

Error	Solución
401	Confirma Authorization: Bearer YOUR_API_KEY y vuelve a copiar la BetterToken API Key.
404	Las llamadas HTTP directas usan https://bettertoken.ai/v1/chat/completions; el base_url del SDK usa https://bettertoken.ai/v1.
Modelo no encontrado	Usa el ID de modelo completo de la model plaza o del cuadro Setup.
Solicitud no válida	Confirma que messages sea un array y que cada elemento tenga role y content.

Detalles técnicos

Base URL y URL completa de la solicitud

Las herramientas que requieren una URL de solicitud completa, como GitHub Copilot y TRAE, usan https://bettertoken.ai/v1/chat/completions. Las herramientas que añaden la ruta automáticamente, como Cursor, Cline, OpenCode, n8n y Dify, usan solo https://bettertoken.ai/v1.

POST/v1/chat/completionsPruébalo

Autorizaciones

Authorizationstringheaderrequerido

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

Cuerpo application/json

modelstringrequerido

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

Ejemplo:"YOUR_MODEL_ID"

messagesobject[]requerido

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

messages[].rolestringrequerido

Ejemplo:"user"

messages[].contentstringrequerido

Ejemplo:"Hello"

streambooleanpredeterminado: false

Whether to request a streaming response.

Respuesta

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.