Antes de elegir un modelo, piensa qué necesita la tarea: entender una imagen, editar archivos, usar herramientas u organizar texto. El modelo comprende y genera; el Agent conecta esas capacidades con herramientas y un entorno de trabajo. Codex y Claude Code son entornos de ejecución de Agents. El modelo se elige por separado en la interfaz. Consulta los conceptos en Modelos y Agents.
- Modelos de Agent.SpaceUsa planes disponibles o Flex
- Tu API de modelosConecta un proveedor al Workspace
- Developer APIUsa una Model API Key en otro cliente
El diagrama separa las dos direcciones de las claves: tu API de modelos incorpora un servicio externo al Workspace; una Model API Key permite que un cliente externo utilice los modelos de Agent.Space. Nombres parecidos no significan la misma credencial ni la misma factura.
Elige una combinación disponible de Agent y modelo
Selecciona un Agent en una conversación nueva y revisa después el menú de modelos. Que un modelo aparezca en el directorio no significa que funcione con todos los Agents o adjuntos. La entrada de imágenes necesita compatibilidad del modelo, del Agent y del punto de ejecución. Si no existe, la interfaz pide retirar la imagen o cambiar la combinación.
Prueba con una tarea pequeña antes de iniciar una larga:
Lee el archivo de la página web actual y enumera los tres problemas que más dificultan leerla en un móvil. Solo analiza, no edites. Si necesitas herramientas o materiales adicionales, indícalo primero.
Comprueba que la respuesta refleje realmente el archivo y señale los materiales que falten. Para verificar imágenes, adjunta una captura relacionada y pregunta por un detalle comprobable. Un texto fluido por sí solo no demuestra que haya leído el material.
No puedes cambiar libremente el tipo de Agent de una Session existente. Para usar otro, crea una conversación y aporta el objetivo, las rutas y las decisiones confirmadas. Las opciones avanzadas proceden del Agent actual, por lo que es normal que los menús difieran. Consulta Mejorar el resultado para iterar.
Cuota del plan, Flex y quién paga
Abre el mercado de suscripciones para comprobar planes, modelos incluidos, cuota restante y horas de restablecimiento. Un plan puede tener varios períodos limitados a la vez. Que uno conserve cuota no significa que todos estén disponibles. La cuota tampoco equivale a un número fijo de mensajes: el contexto, la salida y el modelo cambian el consumo.
Si el modelo está incluido y hay cuota, se usa primero el plan aplicable. Fuera del plan o cuando no queda suficiente cuota, las llamadas que cumplan las condiciones pueden usar créditos Flex con facturación por uso. Flex muestra saldo, origen y caducidad. Los créditos promocionales y comprados no tienen necesariamente los mismos usos. Un saldo no implica validez permanente ni acceso a todos los servicios.
Las llamadas normales de modelos de un Workspace usan los beneficios disponibles de su propietario. Los miembros deben entenderlo antes de iniciar tareas. Un Agent local usa la sesión y suscripción del ordenador; una API de modelos propia se factura por el proveedor externo. Los Macs dedicados, el acceso API externo y las llamadas a modelos tienen sus propias condiciones. El nombre de un plan no demuestra que todo esté incluido.
Los precios, modelos incluidos y disponibilidad cambian. Consulta el catálogo y la confirmación de pago actuales. Para comparar, anota cuatro cosas: modelos necesarios, tamaño habitual de las tareas, cuánto puedes esperar al restablecimiento y si aceptas continuar con pago por uso. Antes de comprar o cambiar un plan, revisa la fecha efectiva y la renovación. Detener la renovación no es solicitar un reembolso inmediato.
Conecta tu API de modelos al Workspace (BYOK)
Esta ruta sirve al propietario que ya dispone de la dirección API y la clave de un proveedor externo. En los ajustes del Workspace abre «Tus modelos» y pulsa «Conectar API de modelos». Introduce el nombre del servicio, la dirección y la clave correspondiente; después elige modelos y guarda.
Antes de guardar, el sistema prueba cada modelo para comprobar que puede llamar herramientas y continuar tras recibir sus resultados. Si la interfaz o las capacidades no coinciden, se indica el motivo. Solo los modelos que superan la prueba y son adecuados para el Agent actual aparecen como seleccionables, agrupados por proveedor al principio del menú. Si los añades o cambias con el ordenador en la nube en ejecución, sigue el aviso de reinicio para aplicar la configuración.
Verifica dos cosas: los resultados de las pruebas y una tarea pequeña en una conversación nueva usando el modelo de ese proveedor. Los miembros pueden usar los modelos, pero no leer la clave. Se guarda cifrada y no se entrega a miembros ni Agents. Las llamadas van al proveedor introducido, que factura al propietario, sin consumir cuota del plan ni créditos de Agent.Space.
La dirección y la clave deben pertenecer al mismo servicio. Una contraseña de acceso o una cuenta de suscripción local no es una API key. No pegues claves en conversaciones, páginas públicas o archivos del proyecto. Si falta un modelo, revisa la compatibilidad y el aviso de reinicio. Guardar repetidamente no arregla una API que no admite llamadas a herramientas.
Conecta clientes externos con Model API Key
«Model API Key», en «Más» de la barra lateral, abre la página Developer API. Permite llamar a Agent.Space desde clientes externos. Es distinta del formulario BYOK anterior y no es una clave universal para leer y escribir archivos del Workspace.
La página comprueba la elegibilidad. Un plan o una suscripción de créditos vigentes, o créditos comprados sin caducar, pueden cumplir los requisitos. Solo los créditos promocionales no desbloquean la API. Tener acceso a la API y disponer de saldo y modelo para una petición concreta son comprobaciones distintas. Las conversaciones normales de Workspace siguen pudiendo usar créditos promocionales cuando corresponda.
En la guía de conexión elige cliente y modelo disponible, crea una clave con un nombre claro y copia la configuración completa al cliente. Por ejemplo, usa personal-laptop y una clave distinta para otra herramienta, para reconocer su uso y revocarlas por separado. Utiliza la dirección, el protocolo y el identificador de modelo de la guía, sin mezclar campos parecidos de otros servicios.
Puedes fijar un límite de gasto y su período de restablecimiento, modelos permitidos y fecha de caducidad. Se aplican a las nuevas peticiones. No seleccionar modelos permite todos; dejar la fecha vacía elimina la caducidad. Las operaciones sensibles, como ver o regenerar la clave, pueden pedir nueva autenticación. Si se filtra, revócala o regénérala de inmediato y actualiza el cliente.
Tras una petición pequeña, vuelve a la página API y revisa el historial y el uso de esa clave. Una respuesta del cliente y un registro correspondiente aquí confirman que utilizó el servicio previsto. De lo contrario, el cliente podría seguir usando su configuración anterior.
Investiga el uso según la ruta
Si no puedes elegir un modelo, comprueba compatibilidad del Agent, beneficios y estado del modelo. Si una tarea se detiene por cuota, revisa todos los períodos y el saldo Flex válido. Si la API rechaza una llamada, comprueba además elegibilidad, caducidad, modelos permitidos y límite de gasto. Para BYOK revisa clave, dirección y facturación del proveedor externo; para tareas locales, la sesión y suscripción del ordenador.
Al pedir ayuda, registra hora, modelo, Agent, ruta de uso y texto del error. No incluyas claves completas. Explicar dónde se ejecuta, a qué servicio llama y quién paga suele resolver el problema antes que cambiar de modelo repetidamente.