Guía de uso
Cambia Claude Code a DeepSeek gratis: configúralo ahora y el 24 de noviembre arranca directamente
Tres formas de conexión con Claude Code, Python y curl; puedes verificar la configuración gratis ahora mismo
En esta página
El Black Friday 2026 de HiAPI comienza el 24 de noviembre a las 16:00 (hora de Pekín) y termina el 1 de diciembre a las 15:59. Durante ese periodo, las cuentas que hayan recargado dispondrán cada día de 10 millones de tokens de DeepSeek V4.1 Flash gratis. Configura 5 variables de entorno y Claude Code funcionará con este modelo gratuito. Puedes configurarlo ya y verificar la configuración de antemano; en cuanto lleguen las 16:00 del día 24, arranca directamente. La configuración para Python y curl también está más abajo.
Solo hay que hacer bien una cosa: las solicitudes gratuitas deben incluir la cabecera de la promoción. Sin ella, se factura al precio normal ($0.44 por millón de tokens de entrada y $1.32 por millón de tokens de salida).
Lo que necesitas: una Key y una cabecera
| API Key | Crea una |
| Modelo | deepseek-v4.1-flash |
| Base URL | https://api.hiapi.ai/v1 (formato OpenAI); para Claude Code usa https://api.hiapi.ai (formato Anthropic) |
| Cabecera | X-HiAPI-Promotion: deepseek-v41-flash-bf2026 |
export HIAPI_API_KEY="sk-your-key"
Claude Code
Apunta Claude Code a HiAPI, configura tanto el modelo principal como el modelo pequeño en segundo plano con DeepSeek y añade la cabecera:
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 es obligatorio configurarlo: Claude Code usa un modelo pequeño para tareas en segundo plano como títulos y resúmenes, y esas llamadas también deberían usar el modelo gratuito. Se recomienda definir estas variables en una ventana de terminal (o script) aparte, para no afectar a tu configuración habitual de Claude Code. Encontrarás las instrucciones completas para conectar HiAPI con Claude Code en la guía de Claude Code.
Python (SDK de 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 añade la cabecera a cada solicitud que envíe este cliente; no hace falta cambiar el resto del código.
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,}$"}]}'
Puedes verificarlo ahora: antes de la promoción devuelve 403 y no se cobra
Si envías la solicitud anterior antes de las 16:00 del día 24, recibirás un 403 con el código de error promotion_not_active, y esta vez no se te cobrará nada. Verlo significa que la cabecera ya ha llegado a HiAPI y que la configuración es correcta; solo queda esperar a que empiece la promoción. Si en cambio recibes una respuesta normal, significa que la cabecera no se envió y esta solicitud se facturó al precio normal; revisa la ortografía y comprueba si la herramienta que usas envía realmente cabeceras personalizadas.
Cuando empiece la promoción, tras enviar la primera solicitud, consulta el registro de uso en la consola de HiAPI: esta solicitud de DeepSeek debería mostrar $0.
Otras herramientas también pueden usarlo así, siempre que permitan configurar una Base URL compatible con OpenAI, el nombre del modelo y cabeceras personalizadas; las que no puedan enviar cabeceras personalizadas se facturarán al precio normal.
Limitaciones
- La cuenta debe haber realizado al menos una recarga correcta (sin importar el importe). Si nunca has recargado, haz una recarga pequeña antes del día 24.
- 10 millones de tokens por cuenta y día, con reinicio a medianoche hora del Pacífico (16:00 hora de Pekín); del 24 de noviembre a las 16:00 al 1 de diciembre a las 15:59 (hora de Pekín).
- Solo
deepseek-v4.1-flashes gratuito; otros modelos como DeepSeek V4 Pro se facturan con normalidad. - Los tokens gratuitos no cuestan dinero, por lo que no cuentan para la devolución por consumo.
- Las cuentas empresariales no participan.
Qué ejecutar con él a partir del día 24
- Deja que el Agent se ponga al día con lo atrasado: tests que nadie escribe, refactorizaciones que se han ido posponiendo, la documentación de algún módulo. Una ronda de un Agent de programación en un repositorio mediano consume unos 200 000 tokens; con 10 millones al día tienes para decenas de rondas.
- Evalúa con datos reales: incorpora V4.1 Flash a tu flujo actual y compara salidas con miles de entradas reales; durante esta semana de promoción no gastarás nada.
- Lectura de contexto largo: con un contexto de 1 millón de tokens, puedes meter un repositorio de código entero o un montón de contratos de una vez.
¿También quieres generar imágenes y vídeos esa misma semana? Recarga y obtén hasta un 10 % extra, y hasta un 20 % de devolución en consumo de imagen/vídeo/audio: aquí tienes los cálculos.
Artículos relacionados
Ver todos los artículos →-
Guía de uso
Guía de integración de Gemini Omni 1.2 Flash: modos de entrada, parámetros y facturación por especificación
Ruta de integración mínima del modelo público gemini-omni-1.2-flash: modos de entrada, restricciones de parámetros, solicitudes copiables y facturación por resolución
-
Guía de uso
Cuánto conviene recargar en el Black Friday: con $100 obtienes un 18% extra, con $500 un 30% extra
Cuatro presupuestos de $50 a $500, convertidos en cuántos segundos de vídeo y cuántas imágenes
-
Guía de uso
Antes del Black Friday, consigue tu API Key de DeepSeek y otras 4 cosas
Consigue la Key, haz una prueba, organiza tareas, decide cuánto recargar y recuerda la hora de inicio