ima: modelos personalizados, API Key, URL base y errores
Configura una API Key, una URL base y el ID exacto de modelo en ima. Comprueba la respuesta, resuelve errores y distingue el modelo de chat del acceso a la API de la base de conocimiento.
Esta guía conecta ima con una API externa de modelos de chat. Usa una versión con la opción de añadir modelos personalizados; los menús de escritorio y móvil pueden variar. La API Key y la URL base deben ser del mismo proveedor. Copia el ID exacto de su lista actual; los modelos de capturas antiguas son ejemplos. No introduzcas la URL completa de /chat/completions ni repitas /v1. Empieza con los límites predeterminados y una pregunta breve. Guardar la configuración no confirma que la llamada API funcione.
ima: modelos personalizados, API Key, URL base y errores
Paso 1: abre el selector de modelos
En la parte inferior de la interfaz de conversación de ima copilot, busca el botón «DS Rápido» (marcado con un recuadro rojo en la imagen 1) y púlsalo para desplegar el menú de selección de modelos.
La imagen muestra la interfaz de la aplicación ima en un teléfono móvil…
Paso 2: entra en «Añadir modelo personalizado»
En el menú de modelos, busca el botón «Añadir modelo personalizado» y púlsalo para abrir la página de configuración del modelo personalizado.
La imagen muestra la interfaz para añadir un modelo personalizado en un…
Paso 3: selecciona el proveedor del modelo (puedes elegir «Personalizado»)
En la página «Añadir modelo personalizado», pulsa la lista desplegable «Proveedor del modelo» (como se muestra en la imagen 4). Puedes elegir un proveedor predefinido, como DeepSeek, Kimi o Zhipu. Si necesitas conectarte a un modelo de un tercero o autohospedado, selecciona «+ Personalizado» («Personalizado» está seleccionado de forma predeterminada, por lo que puedes omitir este paso).
Esta imagen muestra la interfaz para seleccionar el proveedor al añadir…
Paso 4: introduce la información principal del modelo
En la página de configuración debes rellenar 3 datos clave (marcados con un recuadro rojo en la imagen 5):
- Dirección de la API: introduce la dirección de la API del modelo (por ejemplo,
https://api.llm-token.cn/v1, como se muestra en el ejemplo; sustitúyela por la dirección real que quieras integrar). - API Key: introduce la clave de la API del modelo (con un formato similar a
sk-xxxxxx...; debes obtenerla del proveedor del servicio del modelo). - Nombre del modelo: introduce el nombre del modelo (por ejemplo,
gpt-5.5oclaude-sonnet-4-6; debe coincidir con el nombre admitido por la API).
Puedes mantener la opción «Usar valores predeterminados» en la configuración avanzada (longitud de entrada/salida), sin necesidad de modificarla.
Esta es la interfaz de configuración para añadir un modelo personalizado…
Paso 5: guarda el modelo personalizado
Después de rellenar los campos, pulsa el botón «Guardar» de la esquina superior derecha (señalado por la mano en la imagen 5). El modelo personalizado se añadirá automáticamente a la lista «Modelos personalizados» (en la imagen 6, el nuevo modelo claude-opus-4-8 se ha añadido correctamente y ya se puede seleccionar).
Uso posterior: cambia de modelo personalizado
Vuelve al menú de selección de modelos (el botón «DS Rápido» del paso 1). En la lista «Modelos personalizados» podrás ver el modelo que has añadido (como en la imagen 6); púlsalo para cambiar y empezar a utilizarlo~
La imagen muestra el menú de selección de modelos en un teléfono móvil.…
Errores al solicitar un modelo personalizado
| Síntoma | Primera comprobación |
|---|---|
| Error de autenticación o 401 | Clave completa, válida y emitida por el proveedor de esa URL. |
| Modelo no encontrado o acceso denegado | ID exacto de la lista actual y permisos de la clave. |
| 404 o interfaz no encontrada | URL base, ruta completa de solicitud o duplicación de /v1/v1. |
| Se guarda, pero falla al enviar | Selección de la nueva configuración, saldo, estado del servicio y red. |
| Funcionan preguntas breves, pero no textos largos | Límites de entrada/salida, presupuesto de contexto y límites del proveedor. |
Al contactar con soporte, indica hora de solicitud, ID de modelo, error completo e ID de solicitud si existe. Oculta la API Key.
Modelos de chat y API de la base de conocimiento de ima
Esta configuración permite que ima llame a un modelo de chat externo. Para que un agente externo lea o escriba en una base ima, revisa por separado las interfaces oficiales, la autenticación y los permisos. Guardar un modelo de chat no configura ese acceso.
Confirmar IDs de modelo y precios
Copia el ID exacto del catálogo actual del proveedor. Revisa por separado las tarifas de entrada, salida y caché; no deduzcas modelos disponibles ni precios actuales de capturas antiguas.
Modelos y facturación actuales
La entrada, la salida y la entrada en caché pueden tener tarifas distintas. Para imágenes, vídeo o modelos cobrados por solicitud, comprueba la unidad de facturación. Consulta los ID y tarifas actuales en la página de precios; los cargos efectivos constan en los registros de facturación.
Tutorial de configuración de Cursor
Para versiones de Cursor con campos personalizados para OpenAI Key y Base URL.
Tutorial de configuración web para modelos de generación de imágenes
Pensado para principiantes que prefieren evitar los parámetros de la API y configurar todo directamente desde la versión web.