Comprende primero los términos comunes de la IA y los proveedores de IA
Cuando te encuentres con Key, Base URL, nombre del modelo, multiplicadores y códigos de error, consulta esta guía primero para comprender los términos antes de continuar con la integración y la resolución de problemas.
Términos básicos de IA
| Término | Explicación sencilla | ¿A qué deben prestar atención los principiantes? |
|---|---|---|
| Modelo | Las capacidades de IA que realmente se encargan de responder preguntas, escribir código y generar imágenes o videos. | El nombre del modelo debe copiarse exactamente del panel del proveedor; no cambies las mayúsculas, guiones ni números de versión por tu cuenta. |
| Modelo grande (Large Model) | Término general para modelos que pueden manejar tareas como lenguaje natural, código, imágenes, etc. | Más caro no significa necesariamente más adecuado para ti; diferentes modelos pueden ser aptos para redacción, programación, imágenes o videos. |
| Multimodal | El mismo modelo puede procesar diferentes entradas, como texto, imágenes, audio o video. | Que la herramienta admita entrada multimodal no significa que tu proveedor y el modelo actual también lo admitan. |
| Prompt / Instrucción | La solicitud que envías a la IA, por ejemplo: "Ayúdame a resumir este contenido". | Cuanto más específico sea el prompt, más fácil será obtener resultados útiles. |
| Prompt del sistema (System Prompt) | Reglas con mayor prioridad que las preguntas ordinarias, a menudo utilizadas para definir el rol, estilo y límites de seguridad. | Los prompts del sistema en herramientas de código influyen en cómo lee archivos y modifica el código. |
| Ventana de contexto (Context Window) | La cantidad de contenido que el modelo puede recordar y procesar a la vez. | Un contexto más grande no significa necesariamente que sea más inteligente, pero resulta más adecuado para procesar documentos extensos, proyectos grandes y conversaciones continuas de varios turnos. |
| Compresión automática / Resumen automático | Cuando la conversación o el contenido del archivo están a punto de superar el límite de contexto, algunas herramientas sintetizan el contenido anterior en un resumen más breve y luego continúan enviándolo al modelo. | La compresión automática permite continuar la conversación, pero el resumen puede omitir detalles; al solucionar problemas, modificar código o revisar configuraciones, no asumas que el modelo todavía recuerda todo el texto original. |
| Token | La unidad básica para la facturación del modelo y el cálculo de longitud; puede entenderse a grandes rasgos como fragmentos pequeños en los que se divide el texto. | Tanto la entrada como la salida consumen tokens; los documentos y conversaciones extensos aumentarán significativamente los costos. |
| Temperatura (Temperature) | Parámetro que controla la aleatoriedad de la respuesta. | Si buscas estabilidad y reproducibilidad, redúcelo; si buscas creatividad divergente, puedes aumentarlo adecuadamente. |
Relacionado con proveedores de IA
| Término | Explicación sencilla | ¿A qué deben prestar atención los principiantes? |
|---|---|---|
| Proveedor de IA (AI provider) | Reenvía la solicitud de tu herramienta a una o varias plataformas de servicios de modelos. | No es el modelo en sí; la clave está en qué modelos admite, su estabilidad, su precio y su historial de riesgos. |
| Proveedor (Provider) | Plataforma que ofrece interfaces de IA, modelos, facturación y gestión administrativa, que puede ser oficial o un proveedor intermediario de IA. | Las direcciones de API, keys, nombres de modelos y métodos de facturación de diferentes proveedores pueden ser totalmente distintos. |
| Canales oficiales | Servicios proporcionados directamente por los creadores del modelo, como las plataformas oficiales de OpenAI, Anthropic, Google, etc. | La estabilidad y las reglas son más claras, pero puede haber barreras de pago, región, precio y cuotas. |
| Espejo / Proxy | Reenvía la solicitud a la capa intermedia del servicio de destino. | Presta especial atención a la privacidad, la estabilidad y si se guarda el contenido de las solicitudes al ver estos términos. |
| New API / Paneles derivados | Muchos proveedores de IA configuran o desarrollan su panel de administración basándose en paneles de código abierto. | El nombre del menú puede llamarse Token, Canal, Grupo, Multiplicador de modelo, y no necesariamente coincide con el de la plataforma oficial. |
| Canal (Channel) | La línea en el backend que se conecta a un determinado servicio de modelo upstream. | Cuando el canal presenta anomalías, la Key puede ser correcta, pero la solicitud seguirá fallando. |
| Grupos de modelos (Model Grouping) | Asigna diferentes modelos o diferentes permisos a diferentes grupos. | Cuando tu Key no pertenece al grupo correspondiente, el modelo no estará disponible o mostrará 'model not found'. |
| Mapeo de modelos (Model Mapping) | El proveedor asigna un nombre visible al modelo upstream real. | El nombre mostrado en la página puede diferir del nombre real del modelo; al configurar, sigue los requisitos del backend. |
Campos de configuración
| Ajuste | Explicación sencilla | Cómo completarlo |
|---|---|---|
| API | La aplicación llama a la API del modelo. La herramienta no abre un chat web, sino que envía la pregunta al proveedor a través de la API. | Solo se requiere si la herramienta admite explícitamente la configuración de API. |
| API Key / Key / Secret | Una cadena que utiliza la herramienta para demostrar: "Soy esta cuenta". | Copia el contenido completo desde el backend del proveedor, no tomes capturas de pantalla públicas y no copies espacios adicionales. |
| Token | La denominación que muchos proveedores de IA dan a la Key en su backend. | Ver token, Token, API Key o secret suele referirse a lo mismo: credenciales de acceso. |
| Base URL / Dirección de la API | La dirección de interfaz proporcionada por el proveedor para que la herramienta solicite el modelo. | Es el enlace de la API; a veces parece la página principal de un sitio web, a veces debe terminar en /v1; sigue el ejemplo del backend. |
| Endpoint | Otro nombre para la dirección de la interfaz. | Si ves Endpoint en la documentación del proveedor, normalmente debes buscar la dirección de la API o Base URL. |
| Provider | Elemento de configuración del proveedor en la herramienta. | Puede entenderse como: "qué proveedor, qué Key y qué dirección de API quiero usar". |
| Model / Model ID / Model Name | Indica al proveedor a qué API de modelo debe llamar. | Copia exactamente según la lista de modelos del backend; agrégalo manualmente solo si falla la obtención de la lista de modelos. |
| Compatible con OpenAI | El formato de API del proveedor imita la API de OpenAI, y muchas herramientas permiten simplemente configurarlo como OpenAI Provider. | Ser compatible con OpenAI no significa admitir todas las interfaces de Claude, Gemini, imágenes y videos. |
Facturación y límites
| Término | Explicación sencilla | ¿A qué deben prestar atención los principiantes? |
|---|---|---|
| Saldo (Balance) | El importe o los puntos que aún puedes utilizar en la cuenta del proveedor. | Un saldo insuficiente puede provocar que la solicitud falle; no se trata necesariamente de un error de configuración. |
| Multiplicador de tarifa (Pricing multiplier) | Un coeficiente de facturación común en proveedores de IA, utilizado para indicar a qué múltiplo del precio base se cobra un determinado modelo. | Cuanto más potente sea el modelo, mayor sea el contexto y más complejas sean las tareas de imagen y video, mayor podrá ser el multiplicador. |
| Precio de entrada (Input price) | El costo generado por el contenido que envías al modelo. | Los documentos extensos, el código largo y el historial de chat amplio aumentan los costos de entrada. |
| Precio de salida (Output Price) | El costo derivado del contenido generado como respuesta por el modelo. | Cuando se le pide al modelo que escriba contenido muy extenso, el costo de salida también aumentará. |
| Concurrencia | Cuántas solicitudes se pueden iniciar al mismo tiempo. | Cuando la concurrencia es demasiado baja, abrir múltiples herramientas o compartir la cuenta entre varias personas provocará colas o fallos. |
| RPM / TPM | Límite de solicitudes por minuto (RPM) / tokens por minuto (TPM). | Cuando se notifica un límite de tasa (rate limit), suele significar que las solicitudes son demasiado rápidas o que el contenido es demasiado extenso. |
| Longitud de contexto (Context length) | ¿Cuánto contenido puede admitir como máximo una sola solicitud? | Cuando se supera el límite, la herramienta puede truncar el contenido, devolver directamente un error o comprimir/resumir automáticamente la conversación histórica antes de continuar. |
| Caché (Cache) | Los proveedores o modelos reutilizan contenido ya procesado para reducir costos o acelerar la respuesta. | El almacenamiento en caché no siempre se aplica automáticamente ni es necesariamente gratuito; depende de las reglas del proveedor y del modelo. |
| Precio de caché | Término general para los costos asociados a la caché; algunos sistemas de backend lo desglosan en diferentes precios, como creación, aciertos (hits), lecturas, etc. | Al ver el precio de caché, confirma primero si se refiere a escritura en caché, lectura de caché o si el backend combina varios conceptos para mostrarlo. |
| Precio de creación de caché / Precio de escritura de caché | El costo en el que se incurre al escribir por primera vez un fragmento de contenido reutilizable en la caché. | Al usar prompts del sistema extensos, documentos largos o contexto fijo por primera vez, se puede generar este tipo de tarifa. |
| Precio por acierto de caché / Precio de lectura de caché | El costo generado cuando las solicitudes posteriores reutilizan contenido ya almacenado en caché. | Suele ser inferior al precio de entrada estándar, pero aún puede tener costo; no asumas que un acierto de caché es siempre gratuito. |
| Acierto de caché (Cache hit) | Una parte del contenido de esta solicitud fue identificada por el proveedor como idéntica a una anterior y la caché se reutilizó directamente. | Solo se producirá un acierto de caché si se cumplen las reglas de almacenamiento en caché del proveedor, como tener el mismo prefijo, contenido suficientemente largo y reutilizarse dentro del periodo de validez. |
| Tiempo de expiración de caché | El intervalo de tiempo durante el cual la caché puede ser reutilizada. | Hacer una solicitud tras la expiración puede generar cargos como entrada normal o volver a aplicar tarifas de creación de caché. |
Términos y códigos de error comunes
| Error | Significado habitual | Comprobación prioritaria |
|---|---|---|
| 401 / Unauthorized | Autenticación fallida. | Comprobar si la Key está completa, vencida o si se copiaron espacios adicionales. |
| 403 / Forbidden | La cuenta o la Key no tienen permisos. | Permisos del modelo, permisos de grupo, restricciones regionales, estado del saldo. |
| 404 / model not found | El modelo no existe o la Key actual no tiene acceso a este modelo. | Verificar si el nombre del modelo fue copiado del backend y si la Key está asignada al grupo de modelos correspondiente. |
| 429 / rate limit | Las solicitudes son demasiado frecuentes o se ha alcanzado el límite de cuota. | Concurrencia, RPM, TPM, límites del proveedor; inténtalo de nuevo más tarde. |
| timeout / timeout | La solicitud no respondió a tiempo. | Base URL, red, estado del proveedor, si el modelo está en cola. |
| invalid api key | El formato o los permisos de la Key son incorrectos. | Vuelve a copiar la Key, asegurándote de no confundir el nombre/nota de la clave con la Key en sí. |
| invalid base url | La dirección de la interfaz es incorrecta. | Confirma que sea la dirección de la API y no la del panel de control; ¿requiere /v1? Lo que indique el backend tiene prioridad. |
| insufficient quota | Crédito o saldo insuficiente. | Saldo de la cuenta, multiplicador del modelo, si la recarga se ha acreditado. |
Cuando no entiendas el mensaje de error, no cambies varios ajustes al mismo tiempo. Revisa en este orden: Key, Base URL, nombre del modelo, saldo, permisos del modelo y estado del proveedor.