Chave de API DeepSeek: o que colar onde, e uma primeira chamada

Uma chave de API DeepSeek é uma string secreta que informa à API quem está enviando a requisição. Porém, uma ferramenta nunca precisa apenas da chave: ela precisa de três valores juntos — a chave, a URL base e o id do modelo. Defina esses três e a primeira chamada funciona.

Você provavelmente pesquisou isso porque algum formulário está pedindo "sua chave de API DeepSeek": um script, um plugin de editor, um nó do n8n. Tudo bem. Vamos ver o que cada campo quer e, em seguida, enviar uma requisição real.

O que é uma chave de API, de verdade?#

Pense em um cartão-chave de hotel. Ele não diz quem você é em palavras; ele apenas abre sua porta e a recepção cobra do seu quarto. Uma chave de API faz o mesmo trabalho: o servidor a vê na requisição, sabe qual conta cobrar e libera a chamada. Perca o cartão e qualquer um pode entrar e cobrar do seu quarto — por isso a chave fica fora do código e fora das conversas. (A história completa está em O que é uma chave de API e como armazená-la com segurança.)

A documentação da própria API DeepSeek (verificada em 4 de novembro de 2026) mostra o mesmo hábito: a chave vai para uma variável de ambiente, DEEPSEEK_API_KEY, antes de você executar qualquer exemplo, e a API segue o formato OpenAI — o SDK da OpenAI funciona assim que você altera api_key e base_url. É esse o truque inteiro, e é por isso que uma chave nunca viaja sozinha.

Um detalhe que confunde as pessoas: uma chave pertence ao serviço que a emitiu. Uma chave CheapTokens vai com o endereço da CheapTokens, e o id do modelo é o que a CheapTokens lista. Misture uma chave de um lugar com o endereço de outro e você recebe um erro de autorização, não uma resposta.

Coloque a chave em uma variável de ambiente#

Crie uma chave na sua conta CheapTokens (os passos estão na documentação) e mantenha o saldo abastecido para que a requisição tenha de onde consumir. Depois, guarde a chave em uma variável em vez de colá-la em um arquivo.

macOS ou Linux:

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

Windows PowerShell (somente na janela atual):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

A parte paste-your-key-here é um placeholder; coloque sua chave real ali no seu próprio terminal e em nenhum outro lugar. Por que isso é melhor que uma chave fixa no código, e o que fazer se uma vazar, está em Armazene uma chave de API com segurança: variável de ambiente, .gitignore, correção de vazamento.

A primeira requisição#

Digamos que você só queira ver funcionando: peça ao modelo para explicar uma chave de API em uma frase. Mesma requisição, duas formas — escolha a aba que você usa.

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": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

A versão em Python precisa de pip install openai uma vez. Veja o que mudou em relação a um script escrito para o SDK da OpenAI: api_key, base_url e model — os mesmos três valores. Todo o resto permanece como estava.

O que você deve ver#

A resposta é JSON. O texto da resposta fica em choices[0].message.content; é isso que o script Python imprime primeiro. Logo ao lado há um bloco usage com prompt_tokens, completion_tokens e total_tokens — quantos tokens entraram, quantos saíram e a soma. Um custo é calculado a partir desses dois números, e é por isso que vale a pena dar uma olhada neles mesmo em uma primeira chamada (Tokens de entrada vs saída explica a divisão).

Para ter uma noção de escala: uma chamada como esta é minúscula. Considere 30 tokens de entrada e 200 de saída — o teto max_tokens do exemplo, ou seja, a chamada mais cara que esta requisição pode fazer. Ela custa $0.00002. Mil delas ficam assim, com a OpenRouter ao lado para referência:

O modelo por trás desse id é o DeepSeek-V4-Flash: uma janela de contexto de 380K tokens e até 32.768 tokens em uma única resposta. O preço é o mesmo em qualquer horário, sem sobretaxa de horário de pico, e um único saldo cobre todos os modelos. No total — entrada e saída juntas — sai mais barato que a OpenRouter, que é exatamente o que a tabela acima mostra. Mais sobre o modelo: DeepSeek na CheapTokens, preços atuais na página de preços.

Quando não funciona#

Quase toda falha na primeira chamada é um dos três valores estando errado. Relacione o sintoma ao culpado:

O passo a passo completo desses erros está em Erro 401 ou 404 da API: chave, URL base ou id do modelo errado. E se você não tiver certeza de qual id usar, pergunte à própria API: Liste modelos com GET /v1/models.

Para onde os mesmos três valores vão em seguida#

O ponto de aprendê-los uma vez é que eles são portáveis. Quase qualquer ferramenta que fale com uma API compatível com OpenAI pede esses mesmos valores de alguma forma: a chave, o endereço e o modelo. Em um script (LangChain, LiteLLM) eles são argumentos; em um app ou nó no-code eles são campos ou configurações. Você também pode testá-los sem escrever código no Postman. Para streaming e respostas longas com este modelo, continue com o quickstart do DeepSeek-V4-Flash.