Integre em duas linhas: base URL e API key.

Base URL

https://tokenapi.biz/v1

Todos os 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)

Envie sua key como token Bearer.

Authorization: Bearer sk-tk-…

O cabeçalho x-api-key no estilo Anthropic também é aceito. As keys começam com sk-tk-, são exibidas uma única vez na criação e podem ser limitadas individualmente (requisições por minuto, teto de gasto, modelos permitidos, expiração). Guarde as keys no servidor; nunca as coloque em código de navegador ou mobile. Para obter uma key, escreva para hello@tokenapi.biz.

IDs de modelo estáveis.

Use o id retornado por GET /v1/models como parâmetro model. Um ID de modelo é um produto estável: podemos atualizar ou trocar o backend que o serve para manter a qualidade e a disponibilidade, sem nenhuma mudança do seu lado. As respostas sempre informam o ID chamado.

{
  "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 são USD por token (strings); input_per_million / output_per_million são USD por milhão de tokens.

Chat Completions

Requisição e resposta seguem o formato da OpenAI: messages com texto e imagens, tools / tool_choice, response_format, temperature, top_p, stop, max_tokens ou max_completion_tokens. Toda resposta traz o cabeçalho x-request-id; informe-o ao falar com o suporte.

Se você omitir max_tokens, vale o tamanho máximo de saída do modelo.

Server-sent events

Defina stream: true. Os trechos chegam como linhas data: e o stream termina com data: [DONE]. Adicione stream_options.include_usage para receber o uso de tokens num último trecho.

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

Aceita input como string ou array, instructions, ferramentas de função, text.format (JSON Schema) e a sequência 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 com o SDK da Anthropic. Aceita system, blocos de texto e imagem, tools com tool_use / tool_result e eventos de streaming. Os erros seguem o formato da 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 erro no estilo OpenAI

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

Falhas do provedor são refeitas automaticamente em outra rota antes de você ver um erro. Um 502 significa que todas as rotas falharam e nada foi cobrado.

Pré-pago, por token, sem saldo negativo.

• Os preços são por modelo, em USD por milhão de tokens de entrada e de saída (veja Modelos).
• Antes de uma requisição rodar, o custo máximo possível (prompt mais max_tokens) é reservado do seu saldo. Se o saldo não cobrir, você recebe um 402 e nada é enviado ao provedor.
• Quando a requisição termina, são cobrados os tokens reais e o restante da reserva é liberado na hora.
• Requisições que falham antes de o modelo começar a responder (qualquer resposta de erro 4xx/5xx) não são cobradas. Se um stream for cancelado ou interrompido no meio, só os tokens já gerados são cobrados.
• Os limites de taxa são por API key, em requisições por minuto; ao excedê-los você recebe um 429 com Retry-After.