Análisis y valores recopilados al 8 de julio de 2025.
El cobro de las APIs de modelos de lenguaje se basa en "tokens". Un token no es una letra ni una palabra, sino un fragmento de texto. Para tener una idea, en español, 100 tokens equivalen aproximadamente a 60-70 palabras.
Para estandarizar esta guía, usaremos la siguiente estimación práctica:
Estimación Base: 1 página tamaño carta con texto promedio (~600 palabras) equivale a procesar aproximadamente 800 tokens.
Esto significa que cuando veas precios "por 1 millón de tokens", puedes pensar en ello como el costo de procesar un volumen de texto equivalente a unas 1,250 páginas (1,000,000 tokens / 800 tokens por página).
El costo se divide en dos categorías:
A continuación, se comparan los precios de los modelos más relevantes, expresados en dólares (USD).
| Proveedor | Modelo | Precio por 1M tokens / ~1,250 págs. (Entrada) | Precio por 1M tokens / ~1,250 págs. (Salida) | Costo Estimado por Página (Entrada) |
|---|---|---|---|---|
| Gemini 1.5 Pro | $3.50 | $10.50 | ~$0.0028 | |
| Gemini 1.5 Flash | $0.35 | $1.05 | ~$0.0003 | |
| OpenAI | GPT-4o | $5.00 | $15.00 | ~$0.0040 |
| OpenAI | GPT-3.5 Turbo | $0.50 | $1.50 | ~$0.0004 |
| Anthropic | Claude 3.5 Sonnet | $3.00 | $15.00 | ~$0.0024 |
| Anthropic | Claude 3 Opus | $15.00 | $75.00 | ~$0.0120 |
| Anthropic | Claude 3 Haiku | $0.25 | $1.25 | ~$0.0002 |
| DeepSeek | DeepSeek-V2 | $0.14 | $0.28 | ~$0.0001 |
| Alibaba Cloud | Qwen2-72B-Instruct | $0.80 | $1.60 | ~$0.0006 |
El precio no lo es todo. La elección ideal depende de un balance entre capacidad, velocidad, estabilidad y costo.
No hay un único ganador, la mejor API depende de tu caso de uso específico:
Análisis basado en el contenido del archivo cursosla_cursos_7_07_2025.sql.
Este informe cuantifica el volumen de todo el contenido textual asociado al curso "Administracion de Condominios" (ID=1). El objetivo es estimar la cantidad de tokens que este contenido representa y calcular el costo aproximado que tendría su generación utilizando una API de Inteligencia Artificial de alto rendimiento como Gemini 1.5 Pro.
A continuación se detalla el análisis del texto extraído de las tablas de la base de datos para el curso con ID=1:
| Fuente de Datos | Conteo de Caracteres | Tokens Estimados |
|---|---|---|
| Datos Principales del Curso (tabla: cursos_sence) | 7,595 | 1,899 |
| Contenido de los 13 Temas (tabla: temas_curso) | 63,018 | 15,755 |
| Contenido de los 34 Subtemas (tabla: subtemas_curso) | 1,180 | 295 |
| TOTAL | 71,793 | 17,949 |
El análisis completo del contenido textual del curso arroja los siguientes resultados para generar la totalidad de la información textual del curso ID=1:
Este informe re-evalúa el contenido textual del curso "Administracion de Condominios" (ID=1), distinguiendo entre el texto realmente presente en la base de datos y un volumen de texto estimado para campos vacíos, según la nueva instrucción.
descripcion o contenido están vacíos, se asume un relleno de 936 caracteres para cada campo. Este valor se contabiliza por separado como "Estimado".Texto extraído directamente de la base de datos:
| Fuente | Caracteres Reales | Tokens Reales (Aprox.) |
|---|---|---|
| Datos Principales del Curso (tabla: cursos_sence) | 7,595 | 1,899 |
| Contenido de los 13 Temas (tabla: temas_curso) | 63,018 | 15,755 |
| Contenido de los 34 Subtemas (solo texto existente) | 1,180 | 295 |
Cálculo basado en los campos vacíos de los subtemas, asumiendo 936 caracteres por campo:
| Campo Asumido | Nº de Campos Vacíos | Total Caracteres Estimados | Total Tokens Estimados |
|---|---|---|---|
| subtemas_curso.descripcion | 33 | 30,888 | 7,722 |
| subtemas_curso.contenido | 33 | 30,888 | 7,722 |
El análisis combinado de datos reales y estimados arroja los siguientes resultados para generar la totalidad de la información textual del curso ID=1:
Bienvenido. Esta es una guía completa para desarrolladores y operadores que deseen entender, implementar y utilizar agentes de IA construidos con la API de Google Gemini. Analizaremos el flujo de trabajo, la construcción de agentes, la gestión de errores y las mejores prácticas, usando tu agente de creación de cursos (`chat_ver_ia.php`) como nuestro caso de estudio principal.
Esta sección detalla el proceso técnico para conectar una aplicación a la API de Gemini, desde la configuración inicial hasta el manejo de la respuesta.
Antes de empezar, necesitas una API Key para autenticar tus peticiones. El método más directo es a través de Google AI Studio.
Paso 1: Accede a Google AI Studio
Ve al sitio web oficial de Google AI Studio. Necesitarás una cuenta de Google para continuar.
Paso 2: Inicia el proceso para obtener la clave
Una vez en la página, busca y haz clic en el botón "Get API key" (Obtener clave de API). Generalmente se encuentra en la parte superior o en un menú lateral.
Paso 3: Crea tu clave de API en un Proyecto de Cloud
Se abrirá una ventana. Aquí, haz clic en "Create API key" (Crear clave de API). El sistema te pedirá que selecciones un Proyecto de Google Cloud para asociar la clave. Puedes elegir un proyecto existente o crear uno nuevo directamente desde este diálogo.
¡MUY IMPORTANTE! 🚨
Trata tu API Key como si fuera una contraseña. No la compartas públicamente, no la incluyas en el código del lado del cliente (HTML/JavaScript) y no la subas a repositorios de código públicos como GitHub.
Tu agente en `chat_ver_ia.php` sigue un flujo de trabajo robusto que es un excelente modelo a seguir:
POST y valida los datos de entrada.Esta sección es para quienes usan la aplicación final (por ejemplo, los creadores de cursos).
Tanto desarrolladores como usuarios pueden encontrarse con errores. Aquí está cómo identificarlos y qué hacer.
| Código / Mensaje de Error | Causa Probable | Solución (Para Desarrolladores) | Solución (Para Usuarios) |
|---|---|---|---|
| Error (Código: 400) | Petición Incorrecta. El JSON enviado está mal formado o el prompt está vacío. | Revisa el constructor del payload ($payload). Asegúrate de que la estructura sea correcta. |
Error de programación. Informa al equipo de desarrollo. |
| Error (Código: 401 / 403) | Error de Autenticación. La API Key es incorrecta, inválida, o no tiene permisos. | Verifica que la API Key sea correcta y esté activa en tu consola de Google. | El sistema no puede conectarse de forma segura. Contacta al soporte técnico. |
| Error (Código: 429) | Límite de Peticiones Excedido. Demasiadas llamadas a la API en poco tiempo. | Implementa reintentos con espera (exponential backoff). Revisa tus cuotas en Google Cloud. | Has usado la función muy rápidamente. Espera uno o dos minutos antes de volver a intentarlo. |
| Error (Código: 500 / 503) | Error del Servidor. Problema temporal en los servidores de Google AI. | Tu código es correcto al informar al usuario. Puedes añadir un reintento automático. | El servicio está ocupado. Como dice el mensaje, espera un minuto e intenta de nuevo. |
| "Bloqueada por políticas de seguridad." | El prompt o la respuesta esperada activaron los filtros de seguridad de la API. | Revisa el prompt que se está generando. Puedes ajustar los "Safety Settings" en la llamada a la API. | Intenta reformular tu petición con un lenguaje más neutral. |
Aquí tienes una lista de enlaces oficiales que te serán de gran utilidad para profundizar en el uso de la API de Gemini y resolver problemas.
La API de Gemini es una herramienta increíblemente poderosa. Al combinar una sólida implementación de backend, un entendimiento claro de cómo dar buenas instrucciones y una gestión de errores robusta, puedes crear asistentes de IA que realmente potencian la productividad y la calidad del trabajo de tus usuarios.