Tu primera solicitud a la API con CheapTokens

Esta guía te lleva desde una cuenta nueva hasta una solicitud en funcionamiento. Necesitas una dirección de correo electrónico, un saldo pequeño y una terminal. La API es compatible con OpenAI, así que si ya has llamado a OpenAI antes, solo cambian dos cosas: la URL base y la clave.

Lo que necesitas#

• Una cuenta. El registro es por correo electrónico — sin contraseña, te enviamos un enlace de inicio de sesión.
• Un saldo. No hay suscripción: recargas un saldo en USD y cada solicitud se cobra por token a la tarifa fija del modelo.
• Una clave de API desde tu panel.

Paso 1. Crea una cuenta y recarga#

Abre la página de registro, introduce tu correo electrónico y sigue el enlace del mensaje. En el panel pulsa Recargar y elige cómo pagar:

• Cripto — desde $5; se aplica una comisión de depósito del 5%.
• Tarjeta — a través de un socio, que cobra su propia comisión.

Paso 2. Copia tu clave de API#

En cuanto tu saldo sea mayor que cero —tras una recarga o un bono de referido—, el panel crea tu clave de API y la muestra una sola vez. Cópiala de inmediato y mantenla fuera de tu código, por ejemplo en una variable de entorno:

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

Si la clave se filtra, pulsa Rotar: obtienes una nueva clave y la antigua deja de funcionar.

Paso 3. Elige un modelo#

Las solicitudes necesitan el ID completo del modelo — con el prefijo antes de la barra, exactamente como lo lista la API. El catálogo en el momento de escribir esto (octubre de 2026):

El catálogo puede cambiar, así que la fuente de verdad es la propia API. Esta solicitud no necesita clave:

curl https://api.cheaptokens.dev/v1/models

Paso 4. Envía la solicitud#

curl#

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": "Say hello in three languages"}]
  }'

Una respuesta exitosa vuelve en el formato estándar de Chat Completions. Un ejemplo abreviado — tu texto, IDs y números serán diferentes, y la respuesta puede llevar campos de servicio adicionales:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• El texto está en choices[0].message.content.
• El uso de tokens está en usage: prompt_tokens — entrada, completion_tokens — salida. Estos dos números son por lo que se cobra la solicitud.

Python#

Instala el SDK oficial con pip install openai y apúntalo a nuestra URL base:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Instala el SDK con npm install openai:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Clientes estilo Anthropic#

Los clientes creados para la API de Anthropic Messages usan la dirección raíz sin /v1 — https://api.cheaptokens.dev — y envían la clave en la cabecera x-api-key. Los SDK de Anthropic añaden la ruta y la cabecera por sí mismos; tú solo configuras la URL base y la clave.

Si algo sale mal#

• 401 Invalid API key — la clave está mal escrita o se rotó. Comprueba que la pegaste completa; el panel muestra una clave solo una vez, así que si se pierde, pulsa Rotar para obtener una nueva.
• 402 — el saldo se agotó, o la solicitud salió sin la cabecera Authorization.
• 400 Model "…" not found — usa el ID completo del modelo de /v1/models, incluido el prefijo antes de la barra.
• 404 — comprueba la dirección: los clientes estilo OpenAI necesitan /v1 al final de la URL base.

Más casos y soluciones: Errores de conexión comunes y cómo solucionarlos.

Cuánto cuesta#

Cada solicitud se cobra por tokens de entrada y salida por separado, a la tarifa del modelo por millón de tokens. Precios actuales — los mismos datos que en la página de precios:

Siguiente paso: conecta un agente de programación, por ejemplo Cline, o aprende a estimar cuánto costará un agente de IA.

¿Recomiendas CheapTokens a otros desarrolladores? Con el programa de referidos recibes un porcentaje de sus recargas.