Guia de uso
Troque o Claude Code pelo DeepSeek gratuito: configure agora e comece a usar direto em 24 de novembro
Três formas de conectar: Claude Code, Python e curl; valide a configuração gratuitamente agora
Nesta página
A Black Friday 2026 da HiAPI começa em 24 de novembro às 16:00 (horário de Pequim) e vai até 1º de dezembro às 15:59. Contas que já fizeram recarga recebem 10 milhões de tokens DeepSeek V4.1 Flash grátis por dia. Basta definir 5 variáveis de ambiente e o Claude Code passa a rodar nesse modelo gratuito. Você já pode configurar agora e validar antes; quando chegar 24 de novembro às 16:00, é só começar a usar. As configurações para Python e curl também estão abaixo.
Só é preciso acertar uma coisa: as requisições gratuitas precisam incluir o cabeçalho da promoção. Sem ele, a cobrança é pelo preço normal (US$ 0,44 por milhão de tokens de entrada e US$ 1,32 de saída).
O que preparar: uma Key e um cabeçalho
| API Key | Crie uma |
| Modelo | deepseek-v4.1-flash |
| Base URL | https://api.hiapi.ai/v1 (formato OpenAI); para o Claude Code, use https://api.hiapi.ai (formato Anthropic) |
| Cabeçalho | X-HiAPI-Promotion: deepseek-v41-flash-bf2026 |
export HIAPI_API_KEY="sk-your-key"
Claude Code
Aponte o Claude Code para a HiAPI, defina tanto o modelo principal quanto o modelo pequeno em segundo plano como DeepSeek e adicione o cabeçalho:
export ANTHROPIC_BASE_URL="https://api.hiapi.ai"
export ANTHROPIC_AUTH_TOKEN="$HIAPI_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_CUSTOM_HEADERS="X-HiAPI-Promotion: deepseek-v41-flash-bf2026"
claude
ANTHROPIC_DEFAULT_HAIKU_MODEL precisa ser definido: o Claude Code usa o modelo pequeno para tarefas em segundo plano, como títulos e resumos, e essas chamadas também devem usar o modelo gratuito. Recomenda-se definir essas variáveis em uma janela de terminal separada (ou em um script), para não afetar sua configuração normal do Claude Code. Para instruções completas de como conectar o Claude Code à HiAPI, consulte o guia do Claude Code.
Python (SDK da OpenAI)
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["HIAPI_API_KEY"],
base_url="https://api.hiapi.ai/v1",
default_headers={"X-HiAPI-Promotion": "deepseek-v41-flash-bf2026"},
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "写一个保持顺序的列表去重 Python 函数"}],
)
print(resp.choices[0].message.content)
default_headers adiciona o cabeçalho a todas as requisições enviadas por esse client; o restante do código não precisa ser alterado.
curl
curl https://api.hiapi.ai/v1/chat/completions \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-H "X-HiAPI-Promotion: deepseek-v41-flash-bf2026" \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"解释这个正则:^(?=.*\\d).{8,}$"}]}'
Valide agora: antes da promoção retorna 403, sem cobrança
Se você enviar a requisição acima antes de 24 de novembro às 16:00, ela retornará 403 com o código de erro promotion_not_active, e não haverá cobrança nessa chamada. Ver esse retorno significa que o cabeçalho chegou à HiAPI e a configuração está correta; basta esperar a promoção começar. Se vier uma resposta normal diretamente, significa que o cabeçalho não foi enviado e essa chamada foi cobrada pelo preço normal; verifique a grafia e se a ferramenta que você usa realmente envia cabeçalhos personalizados.
Depois que a promoção começar, envie a primeira requisição e consulte o registro de uso no console da HiAPI: essa requisição ao DeepSeek deve aparecer como US$ 0.
Outras ferramentas também podem ser usadas assim, desde que permitam definir uma Base URL compatível com OpenAI, o nome do modelo e cabeçalhos personalizados. As que não conseguem enviar cabeçalhos personalizados terão as requisições cobradas pelo preço normal.
Restrições
- A conta precisa ter feito ao menos uma recarga bem-sucedida (qualquer valor). Se você nunca recarregou, faça uma recarga pequena antes do dia 24.
- São 10 milhões de tokens por conta por dia, com redefinição à meia-noite do horário do Pacífico (16:00 no horário de Pequim); de 24 de novembro às 16:00 até 1º de dezembro às 15:59 (horário de Pequim).
- Somente o
deepseek-v4.1-flashé gratuito; outros modelos, como o DeepSeek V4 Pro, continuam sendo cobrados normalmente. - Os tokens gratuitos não geram custo, portanto não entram no cálculo de cashback de consumo.
- Contas corporativas não participam.
O que rodar com ele a partir do dia 24
- Deixe o Agent limpar o backlog: testes que ninguém escreveu, refatorações que ficaram pendentes, documentação de algum módulo. Uma rodada de um agente de programação em um repositório de porte médio usa cerca de 200 mil tokens; com 10 milhões por dia, dá para fazer dezenas de rodadas.
- Avalie com dados reais: troque o V4.1 Flash no seu fluxo atual e compare as saídas com alguns milhares de entradas reais; durante essa semana de promoção, não há custo.
- Leitura de contexto longo: com contexto de 1 milhão de tokens, dá para colocar um repositório de código inteiro ou uma pilha de contratos de uma vez.
Também vai gerar imagens e vídeos na mesma semana? Recargas ganham até 10% extras e o consumo de imagem/vídeo/áudio tem até 20% de cashback: veja as contas aqui.
Artigos relacionados
Ver todos os artigos →-
Guia de uso
Guia de integração do Gemini Omni 1.2 Flash: modos de entrada, parâmetros e cobrança por especificação
Caminho mínimo de integração do modelo público gemini-omni-1.2-flash: modos de entrada, restrições de parâmetros, requisições copiáveis e cobrança por resolução
-
Guia de uso
Na Black Friday, quanto recarregar compensa mais: $100 rende 18% a mais, $500 rende 30% a mais
Quatro faixas de orçamento, de $50 a $500, convertidas em segundos de vídeo e quantidade de imagens
-
Guia de uso
Antes da Black Friday, garanta já sua DeepSeek API Key e mais 4 coisas
Obtenha a Key, teste, organize as tarefas, defina o valor da recarga e lembre-se do horário de início