Como podemos ajudar?
Pesquise respostas, guias de configuração e documentação — ou escreva-nos.
Use as setas para cima e para baixo para percorrer os resultados e Enter para abrir um.
Estado do serviço A verificar o estado dos modelos… Modelos e estado
Primeiros passos
Do cadastro à sua primeira requisição.
Como obtenho uma chave de API?
Cadastre-se — novas contas recebem 1.3M+ tokens grátis. Sua chave de API aparece no painel assim que sua conta tiver saldo. Copie-a imediatamente: ela é exibida apenas uma vez.
Qual URL base devo usar?
SDKs e ferramentas compatíveis com OpenAI usam https://api.cheaptokens.dev/v1. Clientes compatíveis com Anthropic, incluindo o Claude Code, usam o endereço raiz https://api.cheaptokens.dev e adicionam o caminho por conta própria. Se seu cliente adiciona /v1 sozinho, forneça também o endereço raiz.
Como faço minha primeira requisição?
Coloque sua chave na variável de ambiente CHEAPTOKENS_API_KEY e execute a requisição abaixo. O guia de início rápido monta o mesmo trecho para Python, Node e o SDK da Anthropic, com o modelo de sua escolha.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' Como conecto o Cursor, Cline, Claude Code ou outra ferramenta?
Qualquer ferramenta compatível com a API da OpenAI ou da Anthropic funciona: defina a URL base, cole sua chave e adicione o ID do modelo. Cada guia mostra onde ficam essas configurações na ferramenta.
Qual modelo devo escolher?
Todos os modelos funcionam com a mesma chave e o mesmo endereço — para trocar, altere o ID do modelo. Cada card na página de modelos lista a janela de contexto, a saída máxima e o preço.
- GLM-5.3-Flash Para código complexo e raciocínio
- DeepSeek-V4-Flash Para tarefas do dia a dia com economia
- MiniMax-M2.7 Para agentes e automação de fluxos
Ainda tem uma dúvida? Pergunte-nos
Ligar uma ferramenta
Escolha a sua ferramenta ou SDK para ver apenas as definições necessárias. A chave nos exemplos é um marcador de posição — cole a sua própria chave na ferramenta.
Cursor Compatível com OpenAI
Cursor — em Cursor Settings → Models, cole sua chave em OpenAI API Key, ative Override OpenAI Base URL e adicione o ID do modelo como um modelo personalizado. De acordo com a documentação do Cursor, chaves próprias funcionam apenas com modelos de chat; o preenchimento Tab continua usando os modelos do Cursor.
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
# Cursor Settings → Models → API Keys
OpenAI API Key: YOUR_CHEAPTOKENS_KEY
Override OpenAI Base URL: https://api.cheaptokens.dev/v1
# Models list → add this ID as a custom model:
Model: zai-org/GLM-5.3-Flash Cline Compatível com OpenAI
Cline — escolha um provedor compatível com OpenAI, defina a URL base e a chave.
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
# Cline → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash Onde encontrar essas configurações
Claude Code Compatível com Anthropic
Claude Code — exporte as variáveis abaixo (o endereço não tem /v1) e execute claude.
- URL base
-
https://api.cheaptokens.dev - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comox-api-key: <key>;Authorization: Bearer <key>também funciona. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço raiz sem /v1: o cliente adiciona /v1/messages por conta própria.
# Claude Code → cheaptokens (Anthropic-compatible)
export ANTHROPIC_BASE_URL="https://api.cheaptokens.dev"
export ANTHROPIC_API_KEY="YOUR_CHEAPTOKENS_KEY"
export ANTHROPIC_MODEL="zai-org/GLM-5.3-Flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="zai-org/GLM-5.3-Flash" OpenClaw Compatível com OpenAI ou Anthropic
OpenClaw — adicione a entrada do provedor abaixo em ~/.openclaw/openclaw.json. Em uma instalação nova, openclaw onboard com a opção Custom provider escreve a mesma entrada.
- URL base · Compatível com OpenAI
-
https://api.cheaptokens.dev/v1 - URL base · Compatível com Anthropic
-
https://api.cheaptokens.dev - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>.Enviada comox-api-key: <key>;Authorization: Bearer <key>também funciona. - ID do modelo
-
zai-org/GLM-5.3-Flash
Para requisições no estilo OpenAI use o endereço com /v1; para requisições no estilo Anthropic — o endereço raiz.
// ~/.openclaw/openclaw.json — add cheaptokens as a provider
{
models: {
providers: {
cheaptokens: {
baseUrl: "https://api.cheaptokens.dev/v1",
apiKey: "YOUR_CHEAPTOKENS_KEY",
api: "openai-completions",
models: [{ id: "zai-org/GLM-5.3-Flash", name: "GLM-5.3-Flash" }],
},
},
},
agents: {
defaults: { model: { primary: "cheaptokens/zai-org/GLM-5.3-Flash" } },
},
}
// Anthropic-style requests instead? In the provider entry use:
// api: "anthropic-messages", baseUrl: "https://api.cheaptokens.dev" Aider Compatível com OpenAI
Aider — passe --openai-api-base e --openai-api-key (ou variáveis de ambiente).
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
export OPENAI_API_BASE="https://api.cheaptokens.dev/v1"
export OPENAI_API_KEY="YOUR_CHEAPTOKENS_KEY"
aider --model openai/zai-org/GLM-5.3-Flash Kilo Code Compatível com OpenAI
Kilo Code — escolha o provedor compatível com OpenAI, defina a URL base, a chave e o ID do modelo.
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
# Kilo Code → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash Python · OpenAI Compatível com OpenAI
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
from openai import OpenAI
client = OpenAI(
base_url="https://api.cheaptokens.dev/v1",
api_key="YOUR_CHEAPTOKENS_KEY",
)
resp = client.chat.completions.create(
model="zai-org/GLM-5.3-Flash",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content) Node · OpenAI Compatível com OpenAI
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
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: "zai-org/GLM-5.3-Flash",
messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content); Python · Anthropic Compatível com Anthropic
- URL base
-
https://api.cheaptokens.dev - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comox-api-key: <key>;Authorization: Bearer <key>também funciona. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço raiz sem /v1: o cliente adiciona /v1/messages por conta própria.
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.cheaptokens.dev",
api_key="YOUR_CHEAPTOKENS_KEY",
)
msg = client.messages.create(
model="zai-org/GLM-5.3-Flash",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text) curl Compatível com OpenAI
- URL base
-
https://api.cheaptokens.dev/v1 - Chave de API
-
YOUR_CHEAPTOKENS_KEYEnviada comoAuthorization: Bearer <key>. - ID do modelo
-
zai-org/GLM-5.3-Flash
Use o endereço com /v1: o SDK ou a ferramenta acrescenta /chat/completions automaticamente.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' Referência rápida: endereços, cabeçalho da chave, IDs de modelo, limite
- URL base compatível com OpenAI
https://api.cheaptokens.dev/v1- URL base compatível com Anthropic
https://api.cheaptokens.dev- Cabeçalho da chave de API
Authorization: Bearer <key>Clientes Anthropic: x-api-key- IDs dos modelos
zai-org/GLM-5.3-Flashdeepseek-ai/DeepSeek-V4-Flash-0731MiniMaxAI/MiniMax-M2.7
- Limite de requisições
- 120 requisições por minuto por chave
Saldo e pagamentos
Pague conforme o uso a partir de um saldo em USD.
Como funciona o pagamento?
Não há assinatura. Você recarrega um saldo em USD, e cada requisição é cobrada pela tarifa fixa do modelo por milhão de tokens de entrada e saída. Um único saldo cobre todos os modelos.
Como faço para recarregar?
No painel, pressione Recarregar e escolha o valor em USD. Pague com cripto (sem KYC) ou com cartão por meio de um parceiro — os fundos são creditados automaticamente no seu saldo.
Meu pagamento ainda está em processamento
Uma recarga em cripto é creditada automaticamente assim que a rede confirma a transação — quanto tempo isso leva depende da moeda. Se você paga com cartão por meio de um parceiro, o saldo é recarregado de 5 a 30 minutos após o pagamento.
- Verifique
- O status na página de pagamento: o valor total foi pago, na moeda e na rede que a página mostra.
- Corrija
- Aguarde — não há nada para reenviar. Você pode fechar a página de pagamento: a recarga é creditada sem ela.
- Confirme que funciona
- O saldo no painel aumenta com a recarga; após sua primeira recarga, a chave de API também aparece lá.
- Ainda falhando? Envie-nos
- Se a página de pagamento mostrar o pagamento como concluído mas o saldo não tiver mudado em 30 minutos — veja a próxima resposta.
Paguei, mas meu saldo não mudou
Os pagamentos são associados à sua conta automaticamente. Se a notificação de um pagamento em cripto foi perdida, uma verificação regular identifica o pagamento em minutos.
- Verifique
- A página de pagamento ou sua carteira: o pagamento está concluído. Uma fatura em cripto deve receber o valor total — um pagamento que chegou a menos é verificado manualmente. Se você paga com cartão por meio de um parceiro, o parceiro deve enviar USDT na rede TRC20 (Tron) para o seu endereço de recebimento: outras moedas e redes não são creditadas.
- Corrija
- Aguarde 30 minutos após a conclusão do pagamento. Se o saldo ainda não tiver mudado, escreva para nós — não pague novamente.
- Confirme que funciona
- O painel mostra a recarga no seu saldo.
- Ainda falhando? Envie-nos
- O método de pagamento, o valor, quando você pagou e o ID do pagamento ou hash da transação da página de pagamento ou da sua carteira.
A recarga falhou com um erro
Na maioria das vezes, o valor está abaixo do mínimo — $5 com cripto, $10 com cartão por meio de um parceiro — ou o serviço de pagamento não respondeu por um momento.
- Verifique
- O valor e o texto exato do erro na janela de recarga.
- Corrija
- Recarregue o painel e tente novamente em alguns minutos. Se o pagamento por cartão através de um parceiro falhar, a janela de recarregamento oferece um segundo parceiro.
- Confirme que funciona
- A página de pagamento abre com o seu valor; após o pagamento o saldo aumenta.
- Ainda falhando? Envie-nos
- O método de pagamento, o valor, a hora e o texto exato do erro — uma captura de ecrã ajuda.
Meu saldo expira?
Não. O saldo não utilizado não expira, então você pode recarregar uma vez e gastá-lo no seu próprio ritmo.
O que acontece quando meu saldo acaba?
As requisições retornam 402 e sua chave é pausada. Recarregue, e a mesma chave volta a funcionar — você não precisa de uma nova.
Onde posso ver meus gastos?
No painel: seu saldo, quanto você já gastou e o uso por modelo e por dia.
Por que os preços são mais baixos?
Executamos modelos de pesos abertos em infraestrutura econômica e publicamos tarifas fixas em USD por milhão de tokens de entrada e saída para cada modelo — sem assinaturas ou planos.
Ainda tem uma dúvida? Pergunte-nos
API e erros
O que um código de status significa e como corrigi-lo.
401 Chave de API inválida
A API não reconhece a chave: está mal escrita, pertence a outro serviço ou foi substituída — após Rotacionar a chave antiga deixa de funcionar.
- Verifique
- A chave na sua ferramenta é a atual, sem espaços, aspas ou quebras de linha, e o cabeçalho é exatamente
Authorization: Bearer <key>(clientes Anthropic:x-api-key). - Corrija
- Cole a chave atual novamente. Perdeu? Pressione Rotacionar no painel e atualize a chave em todos os lugares onde a usa.
- Confirme que funciona
- Envie uma requisição curta: uma resposta em vez de 401 significa que a chave funciona.
- Ainda falhando? Envie-nos
- O horário da requisição, a ferramenta ou SDK e o texto do erro — nunca a chave em si.
402 Pedido recusado: sem saldo ou sem chave
O pedido foi recusado antes de chegar ao modelo, por uma de duas razões. O texto do erro distingue-as: Total limit exceeded — o saldo está esgotado ou é demasiado baixo para este pedido; no active billing account — o pedido não inclui nenhuma chave de API.
- Verifique
- Seu saldo no painel, e que a requisição envia a chave como
Authorization: Bearer <key>— “Bearer” com B maiúsculo e um espaço antes da chave — ou comox-api-key. Umbearerminúsculo ou uma chave sem “Bearer” conta como sem chave. - Corrija
- Saldo esgotado: pressione Recarregar no painel — a mesma chave volta a funcionar assim que a recarga for creditada. Sem chave: adicione-a à sua ferramenta ou variável de ambiente e reinicie a ferramenta ou o terminal.
- Confirme que funciona
- No painel a chave aparece como Ativa, e uma requisição curta retorna uma resposta.
- Ainda falhando? Envie-nos
- Se o saldo for positivo e a chave for enviada mas o 402 persistir: o horário da requisição, o modelo e o texto completo do erro.
429 Muitas requisições
Os pedidos chegam mais depressa do que o permitido. O limite é de 120 pedidos por minuto por chave de API, contados em janelas de um minuto. Um 429 também pode significar que o serviço ou um modelo está temporariamente ocupado.
- Verifique
- O texto do erro:
Rate limit exceeded— sua chave atingiu o limite por minuto;at capacity,waiting for an available upstream slotouoverloaded— o serviço ou o modelo está ocupado. - Corrija
- Aguarde o número de segundos do cabeçalho
Retry-Aftere repita — os SDKs oficiais da OpenAI e da Anthropic repetem um 429 por conta própria, duas vezes por padrão. Para agentes, limite quantas requisições rodam em paralelo; se um modelo continuar ocupado, troque o campomodel. - Confirme que funciona
- As requisições voltam a retornar respostas, e em um ritmo constante abaixo do limite os 429 param.
- Ainda falhando? Envie-nos
- Se o 429 aparecer com uma taxa de requisições baixa: o horário, o modelo, quantas requisições você envia por minuto e o texto do erro.
404 · 400 Endereço errado ou modelo não encontrado
Um 404 significa que o endereço está errado. Um 400 que indica “not found” significa que a API não conhece o ID do modelo.
- Verifique
- Clientes no estilo OpenAI precisam do endereço com
/v1: verifique se ele não está faltando, ou duplicado porque o cliente adiciona/v1por conta própria. O ID do modelo deve estar completo, com o prefixo antes da barra, por exemplozai-org/GLM-5.3-Flash. - Corrija
- Copie o endereço e o ID do modelo das configurações para sua ferramenta nesta página, ou pegue o ID em
GET /v1/models. - Confirme que funciona
- Uma requisição curta retorna uma resposta, e
GET /v1/modelslista o mesmo ID. - Ainda falhando? Envie-nos
- O endereço completo que você chama, o ID do modelo e o texto do erro.
503 Modelo temporariamente indisponível
O modelo não pode aceitar pedidos neste momento. O estado do serviço no topo desta página e os cartões dos modelos mostram o mesmo estado.
- Verifique
- O status do serviço acima: este modelo está marcado como temporariamente indisponível?
- Corrija
- Repita a requisição em um minuto, com pausas crescentes — um 503 não tem cabeçalho
Retry-After; os SDKs oficiais tentam novamente duas vezes por conta própria. Ou troque o campomodelpara outro modelo — a chave e o endereço permanecem os mesmos. - Confirme que funciona
- O modelo aparece como disponível novamente, e uma requisição curta retorna uma resposta.
- Ainda falhando? Envie-nos
- Se o status mostrar o modelo como disponível mas o 503 continuar: o horário, o modelo e o texto do erro.
length A resposta para no meio da frase
A resposta atingiu um limite de comprimento: finish_reason é length. Sem max_tokens, uma resposta não transmitida em streaming para no comprimento predefinido do modelo.
- Verifique
- O campo
finish_reasone omax_tokensque você envia — a documentação lista o padrão e a saída máxima para cada modelo. - Corrija
- Defina
max_tokenspara respostas mais longas, até o máximo do modelo, ou transmita a resposta em stream: semmax_tokens, uma resposta em stream pode chegar até o máximo. - Confirme que funciona
- A resposta termina com
finish_reasonstop. - Ainda falhando? Envie-nos
- Se uma resposta terminar com
lengthbem abaixo do seumax_tokens, o stream foi interrompido — repita a requisição e, se continuar acontecendo, envie-nos o horário, o modelo e seumax_tokens.
timeout A resposta demora ou dá timeout
Os modelos de raciocínio pensam antes de responder, por isso o primeiro token pode demorar, e respostas longas demoram minutos. A API espera até 150 segundos para que um modelo comece a responder.
- Verifique
- Se você transmite a resposta em stream e o timeout do seu cliente: ele deve ser maior que 150 segundos.
- Corrija
- Transmita a resposta em stream (
stream: true): os tokens chegam conforme são gerados, e mensagens keep-alive mantêm a conexão aberta. Sem streaming, mantenha o timeout do cliente acima de 150 segundos — os SDKs oficiais da OpenAI e da Anthropic esperam 10 minutos por padrão; no Claude Code éAPI_TIMEOUT_MS, no Aider--timeout, no OpenClawtimeoutSecondsdo provedor. Se uma resposta em stream for interrompida, repita a requisição: a saída de uma resposta interrompida não é cobrada. - Confirme que funciona
- Os primeiros tokens aparecem no stream, ou a resposta completa chega dentro do timeout.
- Ainda falhando? Envie-nos
- O horário, o modelo, se você usa stream, o timeout do seu cliente e onde a resposta parou; o cabeçalho de resposta
x-request-id, se sua ferramenta o exibir.
Ainda tem uma dúvida? Pergunte-nos
Conta e login
Como entrar e manter sua chave segura.
Como faço login?
Digite seu e-mail e enviaremos um link mágico — sem precisar de senha. Você também pode continuar com Google, MetaMask ou GitHub.
O e-mail de login não chegou
Cada link de início de sessão funciona uma vez e durante um período limitado, e apenas o mais recente abre.
- Verifique
- As pastas de spam e promoções, e a ortografia do endereço na página de início de sessão.
- Corrija
- Solicite um novo link na página de início de sessão e abra o e-mail mais recente.
- Confirme que funciona
- O link abre o painel com a sua conta.
- Ainda falhando? Envie-nos
- O endereço com que inicia sessão e quando solicitou o link — o formulário nesta página funciona sem iniciar sessão.
Perdi minha chave de API
O painel mostra a chave apenas uma vez. Pressione Rotacionar para obter uma nova — a chave antiga deixa de funcionar, então atualize-a em todos os lugares onde você a usa.
Ainda tem uma dúvida? Pergunte-nos
Programa de indicações
Ganhe com as recargas das pessoas que você convida.
Como funciona o Programa de indicações?
Compartilhe seu link de indicação. Você recebe 10% de cada recarga de saldo feita por quem se cadastrar com ele — enquanto usarem o CheapTokens.
Onde encontro meu link de indicação?
No painel, na aba Programa de indicações: cadastre-se ou faça login e copie-o lá.
O que as pessoas que eu convido recebem?
1.3M+ tokens grátis no cadastro e mais 52M+ após a primeira recarga de US$ 5 ou mais.
Como uso minhas recompensas?
Cada recompensa fica retida por 7 dias após a recarga e depois fica disponível no seu saldo de indicações. Transfira-o para o seu saldo de API ou retire USDT a partir de US$ 20.
Ainda tem uma dúvida? Pergunte-nos
Não encontrou sua resposta?
Envie-nos uma mensagem — ela vai direto para a equipe e responderemos por e-mail.
Nunca envie sua chave de API — não precisamos dela para ajudar.
Prefere e-mail? Escreva para support@cheaptokens.dev.