
Introducción: ¿por qué llamar a la API directamente?
Conversar en el sitio web de ChatGPT y llamar a la API directamente son usos de un nivel completamente distinto.
Categoría | Chat web (Antes) | Llamada a la API (After) |
|---|---|---|
Automatización | Ingreso manual cada vez | Conexión con Excel, Slack y CRM |
Costo | Tarifa fija de US$20 al mes (ChatGPT Plus) | Pague solo por lo que usa (por token) |
Personalización | Limitado | Control detallado de temperatura, prompt de sistema y más |
Procesamiento masivo | Copiar y pegar de uno en uno | Procesamiento por lotes de cientos de solicitudes |
💡 Al comprender la API, pasa de ser «quien usa la IA» a **«quien integra la IA en el trabajo»**. Aunque no sepa programar, puede seguir esta guía con una herramienta gratuita llamada Postman.
Si sigue esta guía hasta el final, podrá llamar usted mismo a las API de OpenAI (GPT-4o), Anthropic (Claude) y Google (Gemini). El tiempo estimado es de 40 a 60 minutos.
Step 1. Preparación previa — Instalar Postman
Postman es una herramienta gratuita para probar API sin escribir código. Los desarrolladores la usan a diario, pero también es fácil de usar para quienes no programan.
1-1. Descargar e instalar Postman
En el navegador, ingrese a postman.com/downloads.
Haga clic en el botón naranja "Download the App" en el centro de la pantalla.
Se descargará automáticamente el instalador adecuado para su sistema operativo (Windows/Mac).
Ejecute el archivo descargado para completar la instalación.
Al abrir Postman después de instalarlo, aparecerá la pantalla de registro (Sign Up).
Cree una cuenta gratis con su cuenta de Google o su correo electrónico.
1-2. Revisar la pantalla inicial
Si tras iniciar sesión ve la pestaña «+» en la parte superior, todo está listo.
Al hacer clic en esta pestaña "+", se abre la pantalla para crear una nueva solicitud de API (Request).
El menú desplegable de la izquierda dirá **"GET"**; más adelante lo cambiaremos a **"POST"**.
💡 También existe una versión web de Postman (app.getpostman.com), pero la aplicación de escritorio es más estable. Use la versión web solo si la política de seguridad de su empresa impide la instalación.
Paso 2. Obtener la clave de API de OpenAI y hacer la primera llamada
2-1. Obtener la clave de API
En el navegador, ingrese a platform.openai.com.
Inicie sesión con la misma cuenta de ChatGPT. (Es posible que deba registrarse por separado.)
Después de iniciar sesión, haga clic en el ⚙️ ícono de engranaje (Settings) en la barra lateral izquierda.
En el menú de la izquierda, haga clic en "API keys".
Haga clic en el botón "+ Create new secret key" en la parte superior de la pantalla.
En el campo Name escriba «Mi primera clave» y haga clic en «Create secret key».
Se mostrará una cadena larga que empieza con sk-. Esa es su clave de API.
Asegúrese de presionar el botón «Copy» y pegarla en un bloc de notas.
⚠️ Esta clave se muestra una sola vez. Si cierra la ventana, no podrá verla de nuevo, así que guárdela en un lugar seguro. Si la pierde, deberá generar una nueva.
2-2. Registrar un método de pago (obligatorio)
La API es un servicio de pago, por lo que debe registrar un método de pago para poder hacer llamadas.
En el menú de la izquierda, haga clic en "Billing".
Haga clic en el botón «Add payment method».
Ingrese los datos de su tarjeta de crédito.
En "Initial credit balance" ingrese $5. (Es el monto mínimo de recarga)
Claves de la estructura de precios de OpenAI:
Modelo | Entrada (por 1 millón de tokens) | Salida (por 1 millón de tokens) | Referencia |
|---|---|---|---|
GPT-4o | $2.50 | $10.00 | La más recomendada |
GPT-4o-mini | $0.15 | $0.60 | La mejor relación calidad-precio |
GPT-4.1 | $2.00 | $8.00 | Modelo más reciente |
💡 En coreano, unos 1,500 caracteres equivalen a unos 1,000 tokens. Aunque recargue solo US$5, podrá hacer miles de llamadas con GPT-4o-mini, así que puede empezar sin preocuparse.
2-3. Llamar a la API de OpenAI desde Postman
Abra Postman y haga clic en la pestaña "+" de la parte superior para crear una nueva solicitud.
Cambie el menú desplegable de la izquierda de GET a POST.
En el campo de URL, copie y pegue tal cual la siguiente dirección:
https://api.openai.com/v1/chat/completions
4. Haga clic en la pestaña «Headers» debajo del campo de URL.
5. Agregue las dos líneas siguientes:
KEY | VALUE |
|---|---|
|
|
|
|
Atención: debe haber un espacio entre Bearer y sk-.
Haga clic en la pestaña "Body".
Seleccione el botón de opción «raw».
Cambie el menú desplegable de la derecha de **«Text» a «JSON»**.
Copie y pegue el contenido siguiente tal cual:
json
{
"model": "gpt-4o-mini",
"messages": [
{
"role": "system",
"content": "Eres un asistente especializado en ventas B2B. Responde de forma concisa y práctica."
},
{
"role": "user",
"content": "Redacta un correo que proponga la implementación de una solución de TI. El destinatario es el director financiero (CFO) de una empresa mediana y el punto clave es la reducción de costos."
}
],
"temperature": 0.7,
"max_tokens": 1000
}
10. Haga clic en el botón azul «Send», en la esquina superior derecha.
2-4. Revisar la respuesta
En el área inferior se muestra la respuesta en formato JSON. En el campo "choices" → "content" puede ver el cuerpo del correo generado por la IA. En el campo "usage" puede ver la cantidad de tokens utilizados.
Ejemplo de prompt ① — redactar un correo en frío:
«Redacta un correo que proponga la implementación de una solución de TI. El destinatario es el director financiero (CFO) de una empresa mediana y el punto clave es la reducción de costos. Escríbelo en máximo 300 caracteres y haz que el CTA (llamado a la acción) sea proponer una reunión de 15 minutos.»
Paso 3. Obtener la clave de la API de Anthropic (Claude) y hacer la primera llamada
3-1. Obtener la clave de API
En el navegador, ingrese a console.anthropic.com.
Haga clic en "Sign Up" para crear la cuenta. (Es independiente de su cuenta de claude.ai.)
Complete la verificación del correo electrónico.
Después de iniciar sesión, haga clic en «API Keys» en la barra lateral izquierda.
Haga clic en el botón "Create Key".
En Name escriba "Mi primera clave" y haga clic en "Create Key".
Aparecerá una cadena que empieza por sk-ant-. Cópiela en el bloc de notas.
3-2. Registrar el método de pago
En el menú de la izquierda, haga clic en «Billing» → «Payment Methods».
Registre una tarjeta de crédito y recargue $5 de crédito.
Estructura de precios de Anthropic:
Modelo | Entrada (por 1 millón de tokens) | Salida (por 1 millón de tokens) |
|---|---|---|
Claude Sonnet 4 | $3.00 | $15.00 |
Claude Haiku 3.5 | $0.80 | $4.00 |
3-3. Llamar a la API de Claude desde Postman
En Postman, abra una pestaña nueva («+») y configúrela como POST.
URL:
https://api.anthropic.com/v1/messages
3. En la pestaña "Headers" agregue las siguientes tres líneas:
KEY | VALUE |
|---|---|
|
|
|
|
|
|
A diferencia de OpenAI, usa un encabezado llamado x-api-key y no se antepone Bearer.
Seleccione "Body" → "raw" → "JSON" y pegue lo siguiente:
json
{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"system": "Usted es un coach de ventas B2B con 10 años de experiencia.",
"messages": [
{
"role": "user",
"content": "Escribe un correo de seguimiento después de una reunión con un cliente. En la reunión conversamos sobre la migración a la nube, y el siguiente paso es agendar una demostración técnica."
}
]
}
5. Haga clic en el botón "Send".
Ejemplo de prompt ② — Correo de seguimiento:
«Escribe un correo de seguimiento después de una reunión con un cliente. En la reunión hablamos de la migración a la nube y el siguiente paso es agendar una demostración técnica. Con un tono profesional pero cálido, propón dos fechas concretas.»
3-4. Revisar la respuesta
En el JSON de respuesta, el correo redactado por Claude se encuentra en el campo "text" dentro del arreglo "content".
💡 Claude destaca en el análisis de documentos extensos. Si sube
max_tokensa 4096, podrá recibir respuestas más largas.
Paso 4. Obtener la clave de API de Google Gemini y hacer la primera llamada
4-1. Obtener la clave de API
Google Gemini API es la opción en la que más fácil resulta obtener una clave de las tres.
Acceda desde el navegador a aistudio.google.com/apikey.
Inicie sesión con su cuenta de Google.
Haga clic en el botón "Crear clave de API (Create API Key)".
Si aparece una pantalla para seleccionar un proyecto, elija «Crear clave de API en un proyecto nuevo».
Se generará una cadena que empieza con AIza. Cópiela y guárdela en un bloc de notas.
Estructura de precios de Google Gemini:
Modelo | Entrada (por 1 millón de tokens) | Salida (por 1 millón de tokens) | Nivel gratuito |
|---|---|---|---|
Gemini 2.0 Flash | $0.10 | $0.40 | 15 solicitudes por minuto gratis |
Gemini 2.5 Pro | $1.25~$2.50 | $10.00~$15.00 | 5 solicitudes por minuto gratis |
💡 Los modelos Gemini Flash tienen un nivel gratuito, por lo que puede probarlos sin registrar un método de pago. Para fines de aprendizaje, es la opción más cómoda.
4-2. Cómo llamar a la API de Gemini desde Postman
En Postman, abra una pestaña nueva («+») y configúrela como POST.
URL (reemplace la parte
YOUR_API_KEYpor su propia clave):
https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY
Google tiene la particularidad de enviar la clave de API como parámetro de la URL.
Pestaña "Headers":
KEY | VALUE |
|---|---|
|
|
Seleccione "Body" → "raw" → "JSON" y luego:
json
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Crea una tabla comparativa de competidores de un producto B2B SaaS. La categoría es herramientas de gestión de proyectos y debes comparar Asana, Monday.com y Jira. Incluye precios, funciones principales, ventajas y desventajas."
}
]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 2048
}
}
5. Haga clic en "Send".
Ejemplo de prompt ③ — Análisis de competidores:
"Crea una tabla comparativa de competidores para un producto B2B SaaS. La categoría es herramientas de gestión de proyectos; compara Asana, Monday.com y Jira. Organiza en una tabla Markdown el precio, las funciones principales, las ventajas y desventajas, y el tamaño de equipo ideal para cada herramienta."
4-3. Verificar la respuesta
Puede ver la respuesta generada en la ruta "candidates" → "content" → "parts" → "text".
Paso 5. Comparación de las tres API
Criterio de comparación | OpenAI | Anthropic | |
|---|---|---|---|
Formato de la clave |
|
|
|
Método de autenticación | Header: | Header: | Parámetro de URL: |
Estructura del Body | Arreglo | Arreglo | Arreglo |
Nivel gratuito | Ninguno (recarga mínima de US$5) | Limitado; créditos gratis solo en ciertos casos | Gemini Flash gratis |
Modelo económico | GPT-4o-mini | Claude Haiku 3.5 | Gemini 2.0 Flash |
Fortalezas | Versatilidad, ecosistema | Análisis de textos extensos, seguridad | Velocidad, nivel gratuito y multimodalidad |
Step 6. Consejos prácticos — Patrones de prompts para usar de inmediato en el trabajo
6-1. Ajustar el parámetro temperature
temperature: 0.1–0.3 → informes estandarizados, resúmenes de datos (resultados consistentes)
temperature: 0.5~0.7 → correos y documentos de trabajo generales (resultados equilibrados)
temperature: 0.8–1.0 → lluvia de ideas y textos publicitarios creativos (resultados más variados)
💡 Para correos de ventas B2B, un temperature de 0.5 a 0.7 suena más natural. Si es demasiado bajo, el texto resulta rígido; si es demasiado alto, puede alejarse del contexto de negocios.
6-2. Uso del prompt de sistema (Antes/Después)
Antes — sin prompt de sistema:
«Escribe un correo de ventas» → genera un correo genérico y vago
After — configuración del prompt de sistema:
Sistema: «Usted es un experto en ventas B2B SaaS con 10 años de experiencia. Aplique la metodología de venta SPIN y redacte siempre incluyendo cifras concretas y ROI.»
Usuario: «Escribe un correo para proponer la adopción de una solución de seguridad en la nube»
→ Genera un correo de ventas estructurado, con cifras de ROI
6-3. Reglas prácticas para controlar costos
En la etapa de pruebas, use siempre modelos ligeros como mini, flash o haiku. Cambie a un modelo superior solo cuando el prompt esté definido.
Revise el consumo diario en el panel de OpenAI (platform.openai.com → Usage).
Si fija el **límite de uso mensual (Usage Limits)** en US$10, evitará cobros inesperados.
Se configura en Settings → Limits → "Set a monthly budget"
Paso 7. Errores comunes y cómo resolverlos
Error 401: Unauthorized
Causa: la clave de API se ingresó de forma incorrecta
Solución: compruebe que haya un espacio después de
Bearery que al copiar la clave no se hayan incluido espacios al inicio o al final.
Error 429: Rate Limit Exceeded
Causa: se enviaron demasiadas solicitudes en poco tiempo
Solución: espere de 30 segundos a 1 minuto y vuelva a intentarlo. El nivel gratuito tiene límites más estrictos.
Error 400: Bad Request
Causa: error de formato JSON (coma faltante, comillas incorrectas, etc.)
Solución: pegue el contenido del Body en jsonlint.com para validar la sintaxis.
Error 403: Insufficient Balance
Causa: saldo de crédito insuficiente
Solución: recargue crédito adicional en la página de Billing.
💡 Si ocurre un error, lea el campo
"error"→"message"en la pestaña "Body" del área de respuesta, en la parte inferior de Postman. En la mayoría de los casos la causa aparece indicada con claridad en inglés.
Paso 8. Siguiente etapa: ampliar con automatización, sin programar
Si la llamada a la API fue exitosa, ahora puede conectarla con la automatización de tareas reales.
Herramientas | Nivel | Ejemplo de uso |
|---|---|---|
Zapier / Make | ⭐ Fácil | Recepción de correo → resumen con IA → notificación en Slack |
Google Apps Script | ⭐⭐ Intermedio | Datos de Google Sheets → análisis con IA → informe automático |
Power Automate | ⭐⭐ Intermedio | Mensaje de Teams → traducción con IA → respuesta automática |
n8n | ⭐⭐⭐ Intermedio | Leads del CRM → puntuación con IA → envío automático de correos |
Cifras de aplicación real en el trabajo (Before → After)
Tiempo para redactar un correo de ventas: de 25 minutos en promedio a 3 (una reducción de cerca del 88 %)
Informe de resumen de reuniones con clientes: de 40 minutos de redacción manual a 10 de edición tras la llamada a la API (cerca de 75 % menos)
Material de análisis de competidores: de media jornada de investigación → borrador en 5 minutos + 30 minutos de verificación de datos (aprox. 70 % menos de tiempo)
Lista de verificación final
Confirme que completó todos los puntos siguientes:
Postman instalado y cuenta creada
Clave de API de OpenAI obtenida y crédito recargado
Llamada a la API de OpenAI exitosa (GPT-4o-mini)
Clave de API de Anthropic obtenida
Llamada a la API de Claude exitosa
Clave de API de Google Gemini obtenida
Llamada a la API de Gemini exitosa
Comprender las diferencias de autenticación entre las tres API
Prueba de ajuste de temperature completada
Límite mensual de uso configurado
💡 Guarde las solicitudes de Postman usadas en esta guía como una Collection. Haga clic en el botón «Save» de la barra lateral izquierda de Postman y cree una carpeta llamada «Pruebas de API de IA»; así podrá recuperarlas cuando quiera. Será su propio laboratorio de API de IA.