Sua primeira requisição à API com CheapTokens

Este guia leva você de uma conta nova a uma requisição funcionando. Você precisa de um endereço de e-mail, um pequeno saldo e um terminal. A API é compatível com a OpenAI, então se você já chamou a OpenAI antes, apenas duas coisas mudam: a URL base e a chave.

O que você precisa#

• Uma conta. O cadastro é por e-mail — sem senha, enviamos um link de acesso.
• Um saldo. Não há assinatura: você recarrega um saldo em USD e cada requisição é cobrada por token à tarifa fixa do modelo.
• Uma chave de API do seu painel.

Passo 1. Crie uma conta e recarregue#

Abra a página de cadastro, insira seu e-mail e siga o link da mensagem. No painel, pressione Recarregar e escolha como pagar:

• Cripto — a partir de $5; aplica-se uma taxa de depósito de 5%.
• Cartão — por meio de um parceiro, que cobra sua própria taxa.

Passo 2. Copie sua chave de API#

Assim que seu saldo ficar acima de zero — após uma recarga ou um bônus de indicação —, o painel cria sua chave de API e a exibe uma única vez. Copie-a imediatamente e mantenha-a fora do seu código, por exemplo em uma variável de ambiente:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Se a chave vazar, pressione Rotacionar: você recebe uma nova chave e a antiga deixa de funcionar.

Passo 3. Escolha um modelo#

As requisições precisam do ID completo do modelo — com o prefixo antes da barra, exatamente como a API o lista. O catálogo no momento da escrita (outubro de 2026):

O catálogo pode mudar, então a fonte da verdade é a própria API. Esta requisição não precisa de chave:

curl https://api.cheaptokens.dev/v1/models

Passo 4. Envie a requisição#

curl#

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hello in three languages"}]
  }'

Uma resposta bem-sucedida volta no formato padrão de Chat Completions. Um exemplo resumido — seu texto, IDs e números serão diferentes, e a resposta pode trazer campos de serviço extras:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• O texto está em choices[0].message.content.
• O uso de tokens está em usage: prompt_tokens — entrada, completion_tokens — saída. Esses dois números são o que a requisição cobra.

Python#

Instale o SDK oficial com pip install openai e aponte-o para nossa URL base:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Instale o SDK com npm install openai:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Clientes no estilo Anthropic#

Clientes feitos para a API Anthropic Messages usam o endereço raiz sem /v1 — https://api.cheaptokens.dev — e enviam a chave no cabeçalho x-api-key. Os SDKs da Anthropic adicionam o caminho e o cabeçalho por conta própria; você só define a URL base e a chave.

Se algo der errado#

• 401 Invalid API key — a chave foi digitada incorretamente ou foi rotacionada. Verifique se você a colou por completo; o painel mostra uma chave apenas uma vez, então se ela for perdida, pressione Rotacionar para obter uma nova.
• 402 — o saldo acabou, ou a requisição foi enviada sem o cabeçalho Authorization.
• 400 Model "…" not found — use o ID completo do modelo de /v1/models, incluindo o prefixo antes da barra.
• 404 — verifique o endereço: clientes no estilo OpenAI precisam de /v1 no final da URL base.

Mais casos e correções: Erros comuns de conexão e como corrigi-los.

Quanto custa#

Cada requisição é cobrada por tokens de entrada e saída separadamente, à tarifa do modelo por milhão de tokens. Preços atuais — os mesmos dados da página de preços:

Próximo passo: conecte um agente de programação, por exemplo o Cline, ou aprenda a estimar quanto um agente de IA vai custar.

Recomenda o CheapTokens a outros desenvolvedores? Com o programa de indicação você recebe uma porcentagem das recargas deles.