Primera petición a CheapTokens con HTTPie: clave en env, = y :=

Quieres saber que la clave funciona y que el id del modelo es correcto, y quieres saberlo en una sola línea. El comando http de HTTPie lo consigue con muchas menos comillas que curl: tú escribes los campos y él construye el JSON. Aquí está la petición completa, y el resto del artículo explica cada pieza.

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

http --body -A bearer -a "$CHEAPTOKENS_API_KEY" \
  POST https://api.cheaptokens.dev/v1/chat/completions \
  model=deepseek-ai/DeepSeek-V4-Flash-0731 \
  max_tokens:=200 \
  'messages:=[{"role":"user","content":"In one sentence, what is a token?"}]'

La API es compatible con OpenAI, así que la URL base es https://api.cheaptokens.dev/v1 y las peticiones de chat van a /chat/completions bajo ella. El id del modelo es el completo, deepseek-ai/DeepSeek-V4-Flash-0731 (el nombre corto de las tablas de precios no se acepta). Si no has guardado una clave antes, primero guarda una clave de API de forma segura: escribir la línea export deja la clave en el historial de tu shell, así que un archivo de perfil o un gestor de secretos es un mejor hogar para ella.

Qué hacen realmente = y :=#

Esta es la única parte de HTTPie que tienes que aprender. La documentación JSON de HTTPie (versión 3.2.4, del 1 de noviembre de 2024, leída el 9 de noviembre de 2026) dice que = establece un campo de cadena y := establece un valor JSON en bruto: un número, un booleano, un array o un objeto. Los campos dados de esta forma se envían como cuerpo JSON por defecto, así que no añades tú mismo una cabecera Content-Type.

En nuestra petición eso da tres formas distintas:

• model=deepseek-ai/DeepSeek-V4-Flash-0731 es una cadena, así que =.
• max_tokens:=200 es un número, así que :=. Con = enviarías la cadena "200".
• messages:=[…] es un array de objetos, así que := de nuevo, y el valor va entre comillas simples para que el shell deje intactas las comillas dobles internas.

La documentación también dice que un cuerpo desde stdin no se puede combinar con campos de la línea de comandos, así que elige un estilo. Para una primera prueba, los campos son más cortos y fáciles de editar.

Dónde está la respuesta#

La respuesta sigue el formato de chat-completions de OpenAI. Buscas tres cosas, y están en lugares distintos:

{
  "choices": [
    {
      "message": { "role": "assistant", "content": "…the answer text…" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": …, "completion_tokens": …, "total_tokens": … }
}

El texto de la respuesta es choices[0].message.content. finish_reason está a su lado en la misma choice, y usage está en el nivel superior. usage muestra cuántos tokens enviaste (prompt_tokens) y cuántos escribió el modelo (completion_tokens), lo cual es útil para estimar el coste de una petición.

Si solo quieres el texto, pasa el cuerpo por una tubería a jq:

http --body -A bearer -a "$CHEAPTOKENS_API_KEY" \
  POST https://api.cheaptokens.dev/v1/chat/completions \
  model=deepseek-ai/DeepSeek-V4-Flash-0731 \
  max_tokens:=200 \
  'messages:=[{"role":"user","content":"In one sentence, what is a token?"}]' \
  | jq -r '.choices[0].message.content'

Cambia el modelo: modifica un campo#

El modelo es una sola cadena, así que probar otro es una edición de una palabra. Ambos ids de abajo están disponibles en CheapTokens con un solo saldo; DeepSeek-V4-Flash te da un contexto de 380K y hasta 32.768 tokens de salida por respuesta, GLM-5.3-Flash un contexto de 390K y hasta 8.192.

http --body -A bearer -a "$CHEAPTOKENS_API_KEY" \
  POST https://api.cheaptokens.dev/v1/chat/completions \
  model=deepseek-ai/DeepSeek-V4-Flash-0731 \
  max_tokens:=200 \
  'messages:=[{"role":"user","content":"Name three uses of a token limit."}]'

http --body -A bearer -a "$CHEAPTOKENS_API_KEY" \
  POST https://api.cheaptokens.dev/v1/chat/completions \
  model=zai-org/GLM-5.3-Flash \
  max_tokens:=200 \
  'messages:=[{"role":"user","content":"Name three uses of a token limit."}]'

¿No sabes qué id usar? Lista los modelos con GET /v1/models y copia la cadena exacta.

Cuánto cuesta una petición de prueba#

Una pregunta corta como esta es barata. Digamos que la pregunta son unos 100 tokens y la respuesta unos 150: esa petición cuesta $0.000017. Mil de ellas se ven así, con entrada y salida contadas juntas:

En total, con entrada y salida contadas juntas, DeepSeek-V4-Flash sale más barato que OpenRouter, y el precio es una tarifa fija sin horas punta. Las tarifas actuales de cada modelo están en la página de precios.

Si no funciona#

• Escribiste messages=[…] con un = simple. El array se envía como una cadena, no como una lista de mensajes. Usa := y comillas simples alrededor de todo el valor.
• El JSON dentro de := no es válido. Cada clave y cadena necesita comillas dobles, y las comillas externas deben ser simples. Si editas el texto del mensaje, mantén las comillas equilibradas.
• La clave está vacía. echo ${#CHEAPTOKENS_API_KEY} imprime la longitud sin mostrar la clave; 0 significa que la variable no está definida en esta terminal.
• El id del modelo es el nombre corto. Usa el deepseek-ai/DeepSeek-V4-Flash-0731 completo. Para respuestas 401 y 404, consulta clave, URL base o id de modelo incorrectos.
• Recurriste a --session. La documentación de autenticación de HTTPie dice que los archivos de sesión guardan las credenciales en texto plano, así que mantén la clave en el entorno y deja --session fuera de este comando.

Comprueba tu versión con http --version si algún flag se comporta de forma distinta a lo anterior. ¿Prefieres Python? La misma petición sin SDK está en primera petición en Python con requests. Para la referencia completa de la API, consulta la documentación de CheapTokens.