API Chat Completions de OpenAI

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

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

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

python -m pip install openai

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:

Introduce YOUR_API_KEY en Authorization.
Sustituye model por YOUR_MODEL_ID.
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.

Autorizaciones

Authorization

string

header

requerido

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

Cuerpo

application/json

model

string

requerido

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

Ejemplo:

"YOUR_MODEL_ID"

messages

object[]

requerido

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

stream

boolean

predeterminado:false

Whether to request a streaming response.

Respuesta

The Chat Completions result from the selected model.

​Ajustes principales

​Requisitos previos

​Instalación

​Configuración manual

​curl

​Python SDK

​JavaScript SDK

​Verificar la conexión

​Cambiar de modelo

​Errores frecuentes

​Detalles técnicos

Autorizaciones

Cuerpo

Respuesta

Ajustes principales

Requisitos previos

Instalación

Configuración manual

curl

Python SDK

JavaScript SDK

Verificar la conexión

Cambiar de modelo

Errores frecuentes

Detalles técnicos