Integra en dos líneas: base URL y API key.

Base URL

https://tokenapi.biz/v1

Todos los endpoints:

curl https://tokenapi.biz/v1/chat/completions \
  -H "Authorization: Bearer $TOKENAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tokenapi-pro",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://tokenapi.biz/v1",
  apiKey: process.env.TOKENAPI_KEY,
});

const res = await client.chat.completions.create({
  model: "tokenapi-pro",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(res.choices[0].message.content);

import os
from openai import OpenAI

client = OpenAI(base_url="https://tokenapi.biz/v1", api_key=os.environ["TOKENAPI_KEY"])

res = client.chat.completions.create(
    model="tokenapi-pro",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(res.choices[0].message.content)

Envía tu key como token Bearer.

Authorization: Bearer sk-tk-…

También se acepta la cabecera x-api-key al estilo Anthropic. Las keys empiezan por sk-tk-, se muestran una sola vez al crearlas y pueden limitarse individualmente (solicitudes por minuto, tope de gasto, modelos permitidos, caducidad). Guarda las keys en el servidor; nunca las incluyas en código de navegador o móvil. Para obtener una key, escribe a hello@tokenapi.biz.

IDs de modelo estables.

Usa el id de GET /v1/models como parámetro model. Un ID de modelo es un producto estable: podemos mejorar o cambiar el backend que lo sirve para mantener la calidad y la disponibilidad, sin ningún cambio por tu parte. Las respuestas siempre indican el ID que llamaste.

{
  "object": "list",
  "data": [
    {
      "id": "tokenapi-pro",
      "object": "model",
      "owned_by": "tokenapi",
      "display_name": "TokenAPI Pro",
      "capabilities": ["streaming", "tools", "json_output"],
      "context_length": 131072,
      "pricing": {
        "currency": "USD",
        "prompt": "0.0000015",
        "completion": "0.000006",
        "input_per_million": 1.5,
        "output_per_million": 6
      }
    }
  ]
}

pricing.prompt / pricing.completion son USD por token (cadenas); input_per_million / output_per_million son USD por millón de tokens.

Chat Completions

La solicitud y la respuesta siguen el formato de OpenAI: messages con texto e imágenes, tools / tool_choice, response_format, temperature, top_p, stop, max_tokens o max_completion_tokens. Cada respuesta incluye la cabecera x-request-id; indícala al contactar con soporte.

Si omites max_tokens, se aplica la longitud máxima de salida del modelo.

Server-sent events

Indica stream: true. Los fragmentos llegan como líneas data: y el stream termina con data: [DONE]. Añade stream_options.include_usage para recibir el uso de tokens en un último fragmento.

const stream = await client.chat.completions.create({
  model: "tokenapi-pro",
  messages: [{ role: "user", content: "Write a haiku." }],
  stream: true,
  stream_options: { include_usage: true }, // final chunk carries usage
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Responses API

Admite input como cadena o array, instructions, herramientas de función, text.format (JSON Schema) y la secuencia completa de eventos de streaming (response.output_text.delta, response.completed, …).

const res = await client.responses.create({
  model: "tokenapi-pro",
  instructions: "Answer in one sentence.",
  input: "What is a token?",
});
console.log(res.output_text);

Anthropic Messages

Para código escrito con el SDK de Anthropic. Admite system, bloques de texto e imagen, tools con tool_use / tool_result y eventos de streaming. Los errores usan el formato de Anthropic.

import Anthropic from "@anthropic-ai/sdk";

const anthropic = new Anthropic({
  baseURL: "https://tokenapi.biz",   // SDK appends /v1/messages
  apiKey: process.env.TOKENAPI_KEY,
});

const msg = await anthropic.messages.create({
  model: "tokenapi-pro",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});

Objetos de error al estilo OpenAI

{
  "error": {
    "message": "The model 'nope' does not exist or is disabled.",
    "type": "invalid_request_error",
    "code": "model_not_found",
    "param": null
  }
}

Los fallos del proveedor se reintentan automáticamente en otra ruta antes de devolverte un error. Un 502 significa que fallaron todas las rutas y no se te cobró.

Prepago, por token, sin saldo negativo.

• Los precios son por modelo, en USD por millón de tokens de entrada y de salida (ver Modelos).
• Antes de ejecutar una solicitud se reserva de tu saldo su coste máximo posible (prompt más max_tokens). Si el saldo no alcanza, recibes un 402 y no se envía nada al proveedor.
• Al terminar la solicitud se te cobran los tokens reales y el resto de la reserva se libera al instante.
• Las solicitudes que fallan antes de que el modelo empiece a responder (cualquier respuesta de error 4xx/5xx) no se cobran. Si un stream se cancela o se corta a mitad, solo se cobran los tokens ya generados.
• Los límites de tasa son por API key, en solicitudes por minuto; si los superas recibes un 429 con Retry-After.