Documentación de BibGenieModelos personalizados
Agregue y administre modelos personalizados, incluidos OpenAI, Anthropic, OpenRouter, Ollama, LM Studio y API compatibles.
Los modelos personalizados le permiten utilizar su propia clave API, proveedor externo, modelo local o servicio de modelo institucional. Una vez configurado, BibGenie envía solicitudes directamente desde el complemento Zotero local al proveedor que elija.
Agregar un modelo
Abra BibGenie y vaya a Configuración del modelo.
Haga clic en Agregar modelo en la sección modelos personalizados.
Seleccione o ingrese un ID de proveedor. BibGenie carga proveedores comunes desde un catálogo de modelos y completa automáticamente el Nombre del proveedor, el Tipo de proveedor y la URL base cuando es posible.
Seleccione o ingrese un ID de modelo. Si el modelo existe en el catálogo, BibGenie completa automáticamente el nombre del modelo, la familia, los tipos de modelo, la ventana de contexto, los tokens Max y la descripción.
Ingrese su clave API. Para servicios locales como Ollama, normalmente no se requiere una clave API.
Haga clic en Probar para verificar la conexión. Una prueba exitosa muestra Conectado. Si la prueba falla, BibGenie muestra el mensaje de error del proveedor para que pueda corregir la configuración.
Revise los campos autocompletados y ajuste los tipos de modelo, la ventana de contexto o los tokens Max si es necesario.
Haga clic en Agregar modelo. El modelo se guarda, se habilita y pasa a estar disponible en el selector de modelos de chat.
Comportamiento de autocompletar
Agregar un modelo personalizado no es del todo manual. BibGenie carga información de proveedor y modelo del catálogo models.dev cuando esté disponible:
- La identificación del proveedor admite la búsqueda de proveedores comunes y el ingreso manual de un proveedor personalizado.
- Al seleccionar un proveedor, se pueden completar automáticamente el nombre del proveedor, el tipo de proveedor y la URL base.
- El ID del modelo lo filtra el proveedor seleccionado y admite tanto modelos de catálogo como ID de modelos personalizados.
- Al seleccionar un modelo de catálogo, se pueden completar automáticamente el nombre del modelo, la familia, los tipos de modelo, la ventana de contexto, los tokens Max, la descripción y los metadatos de precios.
- Si no se puede cargar el catálogo de modelos, BibGenie utiliza una lista de proveedores alternativos incorporada y aún puede agregar modelos manualmente.
Prefiera entradas del catálogo cuando estén disponibles
Si su proveedor y modelo aparecen en los menús desplegables de búsqueda, selecciónelos en lugar de escribir todo manualmente. Esto reduce los errores en el tipo de proveedor, la URL base, las capacidades del modelo y los límites de contexto.
Campos
| Campo | Requerido | Descripción |
|---|---|---|
| ID del proveedor | Requerido | Identificador de proveedor único, como openai, anthropic o openrouter; Se admiten ID personalizados |
| Nombre del proveedor | Requerido | Nombre para mostrar del proveedor; generalmente se completa automáticamente desde el catálogo |
| ID del modelo | Requerido | ID de modelo real utilizado por la API del proveedor, como gpt-4.1 o claude-sonnet-4-5 |
| Nombre del modelo | Requerido | Nombre para mostrar que se muestra en BibGenie; generalmente se completa automáticamente desde el catálogo |
| Clave API | Opcional | La clave API de su proveedor; Los proveedores locales como Ollama generalmente no requieren uno. |
| URL base | Opcional | punto final API; a menudo se completa automáticamente para los proveedores de catálogos, pero los servicios locales o compatibles pueden requerir confirmación manual |
| Tipo de proveedor | Requerido | Tipo de integración API, como OpenAI, Anthropic, Ollama o OpenAI Compatible |
| Familia | Opcional | Familia de modelos, como qwen, gpt o claude; a menudo se completa automáticamente |
| Tipos de modelos | Requerido | Capacidades como texto, visión, razonamiento, llamada a funciones o Web Search |
| Ventana de contexto | Opcional | Ventana de contexto del modelo; a menudo se completa automáticamente para los modelos de catálogo |
| Max Fichas | Opcional | Tokens de salida máximos; a menudo se completa automáticamente para los modelos de catálogo |
| Descripción | Opcional | Descripción del modelo; a menudo se completa automáticamente |
Guía de tipos de proveedores
| Tipo de proveedor | Usar cuando |
|---|---|
| OpenAI | Utiliza la API oficial OpenAI |
| Anthropic | Utiliza la API Anthropic Claude |
| xAI | usa la API de Grok xAI |
| DeepSeek | Utiliza la API oficial DeepSeek |
| usa la API Gemini | |
| Groq | usa la API Groq |
| Moonshot AI | usa modelos Kimi / Moonshot |
| OpenRouter | usa la API OpenRouter |
| Alibaba | Generalmente a través de OpenAI Compatible |
| Z.AI / Zhipu AI | Generalmente a través de OpenAI Compatible |
| Ollama | Utiliza un servicio local Ollama |
| OpenAICompatible | Utiliza LM Studio, un proxy API o un punto final institucional compatible |
URL base
Muchos proveedores oficiales tienen una URL base predeterminada. Generalmente necesita editar la URL base solo cuando:
- usa OpenAICompatible.
- Utiliza un proxy API.
- Utiliza un servicio de modelo local.
- Su proveedor requiere un punto final personalizado.
Ejemplos:
https://api.openai.com/v1
https://openrouter.ai/api/v1
http://localhost:11434
http://localhost:1234/v1Vigile la ruta /v1
Muchas API compatibles requieren una URL base que termine en /v1. La falta de la ruta de la versión puede causar errores de NetworkError, 404 o modelo no encontrado.
Ollama Ejemplo
Asegúrese de que Ollama esté instalado y ejecutándose.
Ejecute ollama list en una terminal para confirmar que hay un modelo local disponible.
Si Ollama aún no se está ejecutando, inícielo con ollama serve. Debería ver un resultado que confirme que está escuchando en 127.0.0.1:11434.
Agregue un modelo en BibGenie y elija Ollama como Tipo de proveedor.
Utilice http://localhost:11434 como URL base.
Utilice el nombre del modelo mostrado por ollama list, como llama3.1:8b, como ID del modelo.
LM Studio Ejemplo
LM Studio generalmente se configura a través de OpenAI Compatible:
Inicie el servidor API local en LM Studio.
Agregue un modelo en BibGenie y elija OpenAI Compatible como Tipo de proveedor.
Ingrese la dirección API LM Studio como URL base, generalmente similar a http://localhost:1234/v1.
Ingrese la ID del modelo actualmente cargado en LM Studio como ID del modelo.
Tipos de modelos
Seleccione capacidades según lo que realmente admite el modelo:
- Texto: chat de texto; generalmente requerido.
- Visión: entrada de imagen, captura de pantalla y figura.
- Razonamiento: útil para tareas de razonamiento complejas.
- Llamadas a funciones: afecta a los flujos de trabajo de búsqueda, lectura y gestión de bibliotecas.
- Web Search: habilitar solo si el proveedor y el modelo lo admiten.
La configuración de capacidad incorrecta puede causar ModelNotSupported o fallas en la llamada de herramientas.