Primeira requisição a uma API compatível com OpenAI no Postman

Você tem uma chave de API e quer ver o que realmente trafega na rede antes de escrever uma linha de código. O Postman serve exatamente para isso: você preenche uma URL, uma chave e um corpo JSON, clica em Send e a resposta aparece logo abaixo. Para o CheapTokens, a requisição é POST https://api.cheaptokens.dev/v1/chat/completions com uma chave Authorization: Bearer e um corpo JSON que nomeia o modelo.

Os passos abaixo seguem a documentação do próprio Postman (v12, a versão mais recente no site de docs, verificada em 31 de outubro de 2026). Se você prefere um terminal, a mesma requisição está em Sua primeira requisição de API com o CheapTokens.

Configure em quatro passos#

Você só precisa de algumas coisas: a URL base, sua chave, um id de modelo e uma mensagem. O Postman guarda as duas primeiras em variáveis, então a chave nunca é colada na própria requisição.

Alguns detalhes para cada passo.

Crie a requisição. Clique no ícone Add na barra lateral esquerda e escolha HTTP. O dropdown de método vem como GET por padrão, então troque para POST e informe a URL. As variáveis do Postman são escritas {{variable_name}}; a documentação usa {{base_url}} como exemplo. Defina base_url como https://api.cheaptokens.dev/v1 e o campo de URL passa a ser {{base_url}}/chat/completions. O Postman armazena variáveis como strings, o que serve aqui.

Adicione a chave. Abra a aba Authorization, escolha Bearer Token no dropdown Auth Type e coloque {{api_key}} no campo Token. O Postman envia isso como o cabeçalho Authorization no formato Bearer. A documentação recomenda exatamente isso: mantenha o token em uma variável e refira-se a ele pelo nome. Por que esse hábito importa está em Armazene uma chave de API com segurança.

Escreva o corpo. Na aba Body, escolha raw e depois JSON no dropdown. Para corpos raw, o Postman define o Content-Type correspondente sozinho, então você não adiciona esse cabeçalho. Cole isto:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

O id do modelo é o gateway_id completo da documentação do CheapTokens; um nome curto como deepseek-flash não é aceito. max_tokens limita o tamanho da resposta, então um primeiro teste não pode se estender. Mais um detalhe do Postman: comentários // e /* */ em um corpo JSON são removidos antes do envio, então você pode anotar o corpo para um colega.

Clique em Send e leia a resposta#

Se tudo estiver certo, o painel de resposta mostra um objeto JSON no formato OpenAI Chat Completions. Dois lugares importam:

• choices[0].message.content é o texto da resposta.
• usage contém prompt_tokens (o que você enviou) e completion_tokens (o que o modelo escreveu). É por isso que você é cobrado, então olhe nisso já na primeira requisição.

Verifique também choices[0].finish_reason. stop significa que o modelo terminou sozinho; length significa que a resposta atingiu max_tokens e foi cortada. Se você vir isso, aumente o limite ou leia Resposta da IA cortada? Corrija finish_reason "length".

Teste antes de abrir a resposta:

Quanto custa a primeira requisição#

Digamos que a requisição acima use cerca de 30 tokens de entrada e a resposta ocupe cerca de 100 tokens de saída (um exemplo, não uma medição; seu campo usage mostra os números reais). No DeepSeek-V4-Flash isso é $0.00001 pelo preço atual, e o preço é o mesmo em qualquer horário. Os preços por 1M de tokens estão na tabela ao vivo em a página de preços.

A mesma requisição do Postman pode testar outro modelo. Substitua apenas a linha model, por exemplo por zai-org/GLM-5.3-Flash (contexto de 390K, até 8.192 tokens de saída), e clique em Send de novo. Um saldo cobre todos os modelos, então nada mais muda: mesma URL, mesma chave.

Se não funcionar#

O Postman mostra o código de status ao lado da resposta. Estes são os suspeitos de sempre:

Duas coisas específicas do Postman valem a checagem. Se você receber 401 ou a URL parecer errada, verifique se base_url e api_key estão definidas no ambiente que você selecionou. E se a chave parecer certa mas você ainda receber 401, abra a aba Authorization de novo: o Auth Type deve ser Bearer Token, não No Auth. Mais sobre esses códigos: Erro 401 ou 404 da API. Não sabe qual id usar? Liste modelos com GET /v1/models retorna todos eles.

Quando estiver satisfeito, clique em Save, dê um nome à requisição e escolha uma coleção. Na próxima vez você só edita o campo content, ou a linha model para comparar respostas. A referência completa da API está em a documentação do CheapTokens.