Clave de API de DeepSeek: qué pegar dónde y una primera llamada

Una clave de API de DeepSeek es una cadena secreta que le indica a la API quién envía la solicitud. Sin embargo, una herramienta nunca necesita la clave por sí sola: necesita tres valores juntos — la clave, la URL base y el id del modelo. Configura esos tres y la primera llamada funciona.

Probablemente buscaste esto porque algún formulario te pide "tu clave de API de DeepSeek": un script, un plugin de editor, un nodo de n8n. Bien. Veamos qué quiere cada campo y luego enviemos una solicitud real.

¿Qué es realmente una clave de API?#

Piensa en una tarjeta llave de hotel. No dice quién eres con palabras; simplemente abre tu puerta y la recepción carga el consumo a tu habitación. Una clave de API hace lo mismo: el servidor la ve en la solicitud, sabe a qué cuenta cobrar y deja pasar la llamada. Pierde la tarjeta y cualquiera puede entrar y cargar a tu habitación — por eso la clave se mantiene fuera del código y fuera de los chats. (La historia completa está en Qué es una clave de API y cómo almacenarla de forma segura.)

La documentación propia de la API de DeepSeek (consultada el 4 de noviembre de 2026) muestra el mismo hábito: la clave va en una variable de entorno, DEEPSEEK_API_KEY, antes de ejecutar cualquier ejemplo, y la API sigue el formato de OpenAI — el SDK de OpenAI funciona una vez que cambias api_key y base_url. Ese es todo el truco, y es por eso que una clave nunca viaja sola.

Un detalle que confunde a la gente: una clave pertenece al servicio que la emitió. Una clave de CheapTokens va con la dirección de CheapTokens, y el id del modelo es el que CheapTokens lista. Mezcla una clave de un lugar con la dirección de otro y obtendrás un error de autorización, no una respuesta.

Pon la clave en una variable de entorno#

Crea una clave en tu cuenta de CheapTokens (los pasos están en la documentación) y mantén el saldo recargado para que la solicitud tenga de dónde cobrar. Luego guarda la clave en una variable en lugar de pegarla en un archivo.

macOS o Linux:

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

Windows PowerShell (solo la ventana actual):

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

La parte paste-your-key-here es un marcador de posición; pon tu clave real ahí en tu propia terminal y en ningún otro lugar. Por qué esto es mejor que una clave codificada directamente, y qué hacer si una se filtra, está en Almacenar una clave de API de forma segura: variable de entorno, .gitignore, corrección de filtraciones.

La primera solicitud#

Digamos que solo quieres ver que funciona: pídele al modelo que explique una clave de API en una frase. La misma solicitud, dos formas — elige la pestaña que uses.

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)

La versión de Python necesita pip install openai una vez. Mira qué cambió en comparación con un script escrito para el SDK de OpenAI: api_key, base_url y model — los mismos tres valores. Todo lo demás queda como estaba.

Qué deberías ver#

La respuesta es JSON. El texto de la respuesta está en choices[0].message.content; eso es lo que imprime primero el script de Python. Justo al lado hay un bloque usage con prompt_tokens, completion_tokens y total_tokens — cuántos tokens entraron, cuántos salieron y la suma. A partir de estos dos números se calcula un costo, y por eso vale la pena echarles un vistazo incluso en una primera llamada (Tokens de entrada vs salida explica la división).

Para hacerte una idea de la escala: una llamada como esta es diminuta. Toma 30 tokens de entrada y 200 de salida — el límite max_tokens del ejemplo, así que la llamada más cara que esta solicitud puede hacer. Cuesta $0.00002. Mil de ellas se ven así, con OpenRouter al lado como referencia:

El modelo detrás de ese id es DeepSeek-V4-Flash: una ventana de contexto de 380K tokens y hasta 32,768 tokens en una sola respuesta. El precio es el mismo a cualquier hora, sin recargo en horas punta, y un solo saldo cubre todos los modelos. En total — entrada y salida juntas — sale más barato que OpenRouter, que es exactamente lo que muestra la tabla anterior. Más sobre el modelo: DeepSeek en CheapTokens, precios actuales en la página de precios.

Cuando no funciona#

Casi todos los fallos en la primera llamada se deben a que uno de los tres valores está mal. Relaciona el síntoma con el culpable:

El recorrido completo de estos errores está en Error 401 o 404 de API: clave, URL base o id de modelo incorrectos. Y si no estás seguro de qué id usar, pregúntale a la propia API: Listar modelos con GET /v1/models.

Dónde van los mismos tres valores después#

La ventaja de aprenderlos una vez es que son portables. Casi cualquier herramienta que hable con una API compatible con OpenAI pide estos mismos valores de alguna forma: la clave, la dirección y el modelo. En un script (LangChain, LiteLLM) son argumentos; en una app o un nodo sin código son campos o ajustes. También puedes probarlos sin escribir código en Postman. Para streaming y respuestas largas con este modelo, continúa con el inicio rápido de DeepSeek-V4-Flash.