Primera petición a una API compatible con OpenAI en Postman

Tienes una clave de API y quieres ver qué se envía realmente por la red antes de escribir una línea de código. Postman es ideal justo para eso: rellenas una URL, una clave y un cuerpo JSON, pulsas Send y la respuesta aparece justo debajo. Para CheapTokens la petición es POST https://api.cheaptokens.dev/v1/chat/completions con una clave Authorization: Bearer y un cuerpo JSON que indica el modelo.

Los pasos siguientes siguen la documentación oficial de Postman (v12, la última versión en el sitio de docs, consultada el 31 de octubre de 2026). Si prefieres una terminal, la misma petición está en Tu primera petición a la API con CheapTokens.

Configúralo en cuatro pasos#

Solo necesitas unas pocas cosas: la URL base, tu clave, un id de modelo y un mensaje. Postman guarda las dos primeras en variables, así la clave nunca se pega en la propia petición.

Algunos detalles para cada paso.

Crea la petición. Haz clic en el icono Add de la barra lateral izquierda y elige HTTP. El desplegable de método viene por defecto en GET, así que cámbialo a POST e introduce la URL. Las variables de Postman se escriben {{variable_name}}; la documentación usa {{base_url}} como ejemplo. Define base_url como https://api.cheaptokens.dev/v1 y el campo URL pasa a ser {{base_url}}/chat/completions. Postman guarda las variables como cadenas, lo cual está bien aquí.

Añade la clave. Abre la pestaña Authorization, elige Bearer Token en el desplegable Auth Type y pon {{api_key}} en el campo Token. Postman la envía como la cabecera Authorization en formato Bearer. La documentación recomienda exactamente esto: mantener el token en una variable y referenciarlo por su nombre. Por qué importa ese hábito está en Guardar una clave de API de forma segura.

Escribe el cuerpo. En la pestaña Body elige raw y luego JSON en el desplegable. Para cuerpos raw Postman establece por sí mismo la cabecera Content-Type correspondiente, así que no la añadas tú. Pega esto:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

El id del modelo es el gateway_id completo de la documentación de CheapTokens; un nombre corto como deepseek-flash no se acepta. max_tokens limita la longitud de la respuesta, así que una primera prueba no puede alargarse. Un detalle más de Postman: los comentarios // y /* */ en un cuerpo JSON se eliminan antes de enviar, así que puedes anotar el cuerpo para un compañero.

Pulsa Send y lee la respuesta#

Si todo está bien, el panel de respuesta muestra un objeto JSON en el formato OpenAI Chat Completions. Dos lugares importan:

• choices[0].message.content es el texto de la respuesta.
• usage contiene prompt_tokens (lo que enviaste) y completion_tokens (lo que escribió el modelo). Esto es por lo que se te factura, así que míralo en la primera petición.

Comprueba también choices[0].finish_reason. stop significa que el modelo terminó por sí solo; length significa que la respuesta alcanzó max_tokens y se cortó. Si ves eso, sube el límite o lee ¿Respuesta de IA cortada? Arregla finish_reason "length".

Pruébalo antes de abrir la respuesta:

Cuánto cuesta la primera petición#

Digamos que la petición anterior usa unos 30 tokens de entrada y la respuesta ocupa unos 100 tokens de salida (un ejemplo, no una medición; tu campo usage muestra los números reales). En DeepSeek-V4-Flash eso es $0.00001 al precio actual, y el precio es el mismo a cualquier hora. Los precios por 1M de tokens están en la tabla en vivo de la página de precios.

La misma petición de Postman puede probar otro modelo. Sustituye solo la línea model, por ejemplo por zai-org/GLM-5.3-Flash (contexto de 390K, hasta 8.192 tokens de salida), y pulsa Send de nuevo. Un solo saldo cubre todos los modelos, así que nada más cambia: misma URL, misma clave.

Si no funciona#

Postman muestra el código de estado junto a la respuesta. Estos son los sospechosos habituales:

Merece la pena revisar dos cosas específicas de Postman. Si recibes 401 o la URL parece incorrecta, comprueba que base_url y api_key están definidas en el entorno que has seleccionado. Y si la clave parece correcta pero sigues recibiendo 401, abre de nuevo la pestaña Authorization: el Auth Type debe ser Bearer Token, no No Auth. Más sobre estos códigos: Error 401 o 404 de la API. ¿No sabes qué id usar? Lista los modelos con GET /v1/models los devuelve todos.

Cuando estés conforme, pulsa Save, ponle un nombre a la petición y elige una colección. La próxima vez solo editas el campo content, o la línea model para comparar respuestas. La referencia completa de la API está en la documentación de CheapTokens.