Cómo usar CometAPI en Raycast — una guía práctica

Las funciones de IA de Raycast ahora te permiten conectar cualquier proveedor compatible con OpenAI mediante un proveedor personalizado providers.yaml. CometAPI es una API de pasarela que expone cientos de modelos detrás de una interfaz REST al estilo OpenAI—por lo que puedes apuntar Raycast a https://api.cometapi.com/v1, añadir tu clave de CometAPI y usar modelos de CometAPI dentro de Raycast AI (chat, comandos, extensiones).

¿Qué es Raycast?

Raycast es un lanzador de productividad para macOS que integra comandos, scripts y —cada vez más— IA directamente en tu sistema operativo. Su subsistema de IA ofrece chat, comandos de IA, selección de modelos, extensiones (herramientas que permiten a los LLM realizar acciones) y la posibilidad de usar modelos locales (a través de Ollama) o Bring Your Own Key / Proveedores personalizados para conectar proveedores de modelos remotos. Raycast muestra un selector de modelos, ajustes para IA y una plantilla providers.yaml que los usuarios avanzados pueden personalizar para añadir backends compatibles con OpenAI.

Raycast ha estado desplegando BYOK (Bring Your Own Key) y Proveedores Personalizados en 2025, lo que permite a los usuarios ejecutar Raycast AI con sus propias claves de API y endpoints personalizados (habilitando una gestión de costes más flexible y opciones de proveedores privados). Este cambio es la base técnica que hace viable la integración de CometAPI desde las preferencias de Raycast del usuario final.

¿Cómo expone Raycast la IA a los usuarios?

• Quick AI: indicaciones instantáneas desde el lanzador.
• AI Chat: sesiones conversacionales con archivos adjuntos/contexto.
• Comandos/Extensiones de IA: comandos o herramientas creados por desarrolladores que usan LLMs.
  (Puedes gestionar modelos, claves BYOK y proveedores personalizados desde Ajustes → IA).

¿Qué es CometAPI?

CometAPI es una plataforma de agregación de APIs que expone cientos de modelos diferentes (texto, imagen, audio, video, embeddings) a través de una única interfaz REST al estilo OpenAI. En lugar de escribir y mantener código cliente específico para OpenAI, Anthropic, Google, Midjourney, Runway, etc., llamas al endpoint de CometAPI y eliges el modelo que quieres mediante una cadena de modelo. Esa simplificación es potente para la experimentación, el enrutamiento por coste/conmutación por error y la centralización de la facturación y la observabilidad.

Capacidades clave

• Completado de texto/chat y asistentes (APIs de chat al estilo OpenAI).
• Generación y edición de imágenes.
• Embeddings para búsqueda semántica/RAG (retrieval-augmented generation).
• Audio (TTS y STT cuando lo proporcionan los modelos subyacentes).
• Generación de video para backends especializados (Sora, Veo, etc.).
  CometAPI también proporciona fragmentos de SDK y formatos de solicitud al estilo OpenAI, por lo que portar código existente es sencillo.

¿Por qué es significativo ahora mismo?: el mercado se está desplazando hacia APIs de pasarela (endpoints únicos convenientes, opciones más baratas y elección de modelos). CometAPI es uno de los actores comerciales en ese espacio, así que combinarlo con el soporte de proveedores personalizados de Raycast te da acceso inmediato a un amplio catálogo de modelos desde tu flujo de trabajo en macOS.

¿Por qué integrar CometAPI con Raycast?

Respuesta corta: para ejecutar cualquier modelo expuesto por CometAPI directamente desde tu flujo de Raycast AI —Quick AI, AI Chat o comandos de IA personalizados— sin cambiar de herramienta.

Beneficios:

• Usa modelos más baratos/rápidos o especializados para diferentes tareas (resúmenes, código, embeddings, generación de imágenes) sin salir de Raycast.
• Facturación y limitación centralizadas a través de CometAPI mientras controlas la selección de modelos desde Raycast.
• Cambios mínimos de código: Raycast soporta proveedores personalizados compatibles con OpenAI y BYOK, así que CometAPI suele integrarse cambiando base_url y la clave de API.

(Estas capacidades son posibles porque Raycast soporta proveedores personalizados y BYOK, y CometAPI expone endpoints compatibles con OpenAI en https://api.cometapi.com/v1. )

¿Cuáles son buenos casos de uso para esta integración?

1. Asistente para desarrolladores: explicación de código, sugerencias de refactorización, generación de tests unitarios y resúmenes de PR — invócalo desde Raycast y recibe respuestas en línea.
2. Notas y resúmenes: selecciona texto, ejecuta un comando de Raycast para resumir o extraer tareas usando un modelo de resumen de CometAPI.
3. Redacción de documentación: genera documentación de funciones o fragmentos de README mediante comandos de IA de Raycast y mantén las iteraciones en local.
4. Generación multimedia/imágenes: si CometAPI expone endpoints de imagen, puedes usar extensiones de Raycast que llamen a endpoints de imagen (p. ej., la extensión "Generate Image from Prompt") — útil para maquetas rápidas.
5. Embeddings + búsqueda semántica: usa embeddings de CometAPI para impulsar flujos de búsqueda local — Raycast puede ser el front-end que consulta tu índice de embeddings mediante un pequeño script local o una función en la nube.

¿Qué entorno y condiciones deben prepararse?

Antes de empezar, asegúrate de tener lo siguiente listo:

Sistema y Raycast

• macOS (Raycast es nativo de macOS).
• Raycast instalado. Prefiere una versión reciente que soporte Proveedores Personalizados / BYOK (Raycast añadió BYOK en la v1.100.0 y sigue desplegando Proveedores Personalizados). Si tu Raycast es antiguo, actualízalo.

Cuentas y claves

• Cuenta de CometAPI y una clave de API de CometAPI válida (la usarás en los ajustes de Raycast o variables de entorno). Consulta el panel/documentación de CometAPI.

Herramientas opcionales para desarrolladores (para pruebas o desarrollo local)

• Terminal (para cURL).
• Python / Node / SDKs de OpenAI si quieres probar el acceso a CometAPI directamente antes de conectarlo a Raycast. CometAPI soporta el uso directo a través de SDKs estándar sobrescribiendo base_url.

Permisos y red

• Asegúrate de que Raycast y las políticas de red de tu macOS permiten llamadas HTTPS a api.cometapi.com.
• Si estás en un entorno corporativo con proxy/cortafuegos, verifica que api.cometapi.com sea accesible.

Archivos y ubicaciones locales

La configuración de proveedores de IA de Raycast reside en un providers.yaml dentro del directorio de configuración de Raycast (la app puede mostrar una plantilla de proveedores que puedes copiar). Editarás o crearás providers.yaml para definir proveedores personalizados.

¿Cómo integro Raycast con CometAPI?

La idea principal: registrar CometAPI como un proveedor personalizado compatible con OpenAI en Raycast, apuntar Raycast a https://api.cometapi.com/v1 y añadir tu token de Comet a las API personalizadas de Raycast.

Paso 1: Obtén tu clave de CometAPI

1. Regístrate en CometAPI y abre la consola / panel.
2. Crea un token de API. Copia este token en un lugar seguro (o consérvalo para el siguiente paso).

Paso 2: Abre los ajustes de IA de Raycast y habilita proveedores personalizados

1. En Raycast: Preferences → AI.
2. Busca “Custom Providers” (o “Custom OpenAI-compatible APIs”) y haz clic en Reveal Providers Config. Raycast abrirá Finder en el directorio de configuración y proporcionará un archivo de plantilla (normalmente providers.template.yaml) para copiar y renombrar como providers.yaml.

Paso 3: Añade un proveedor de CometAPI a providers.yaml

Crea o edita el archivo providers.yaml. El esquema exacto que espera Raycast puede variar según la versión, pero las plantillas de la comunidad y el manual de Raycast muestran la estructura común: una lista de entradas de proveedor con id, name, base_url y un bloque opcional models. Abajo hay un ejemplo seguro y funcional para registrar CometAPI como un OpenAI-co

Notas importantes

• Sustituye YOUR_COMETAPI_KEY por una referencia segura — ya sea pegando el token (para uso personal) o, mejor: guardándolo en el Llavero de macOS / campos seguros de Raycast si se admite.
• base_url es la línea importante: apúntala a https://api.cometapi.com/v1. Raycast usará esa base URL para llamadas compatibles con OpenAI.
• No necesitas listar previamente todos los modelos — Raycast puede obtener listas de modelos desde un endpoint GET /v1/models al estilo OpenAI si tu proveedor lo expone. Si CometAPI expone una lista de modelos, Raycast puede actualizarla y mostrar los modelos disponibles.

Paso 4: Actualiza modelos y prueba

• De vuelta en Raycast, puede que necesites reiniciar la app o usar un comando “Refresh Models” (según la versión) para que Raycast obtenga los modelos del nuevo proveedor y rellene el selector de modelos. Recomiendo actualizar o reiniciar si los modelos no aparecen.
• Usa un prompt sencillo en Quick AI para seleccionar el modelo de CometAPI desde el selector de modelos y ejecutar una prueba.

Mejores prácticas al usar CometAPI dentro de Raycast

Mejores prácticas de seguridad: Nunca hardcodees tokens en un providers.yaml compartido. Prefiere los campos seguros de Raycast o el Llavero de macOS, o inyecta claves localmente usando variables de entorno si usas un proxy local. Lee la política de privacidad de CometAPI y Raycast si manejas datos sensibles.

Fiabilidad y rendimiento: Prueba la latencia de los modelos que piensas usar — las APIs de pasarela pueden tener enrutamiento variable. Para flujos interactivos (resúmenes automáticos, consultas rápidas) prefiere modelos más pequeños y rápidos. Para tareas de razonamiento más profundas elige modelos con mayor contexto.

Control de costes: Usa la selección de modelos de forma agresiva: elige modelos ligeros para tareas cortas y modelos de alta capacidad para razonamiento intensivo. Haz seguimiento del uso en el panel de CometAPI y configura alertas de presupuesto. Considera prompts programáticos para reducir el uso de tokens (p. ej., mensajes del sistema más cortos, gestión eficiente del contexto).

Ingeniería de prompts y UX: Al crear Comandos de IA en Raycast (duplica un comando integrado y ajusta el prompt), mantén prompts deterministas para comandos utilitarios (resumen, triaje, búsqueda) y más abiertos para flujos de ideación. Se recomienda copiar comandos integrados y personalizar los prompts.

¿Cómo solucionar problemas comunes?

Los modelos no aparecen en Raycast: Asegúrate de que providers.yaml de Raycast esté en la carpeta exacta mostrada por Reveal Providers Config. Usa la plantilla como base y reinicia Raycast. Un reinicio o “Refresh Models” ayuda.

401 / token inválido: Confirma que tu token de CometAPI es válido y no ha expirado. Prueba el curl anterior. Verifica que usaste un token Bearer y que el encabezado Authorization es correcto.

Errores de modelo o formas de respuesta incompatibles: CometAPI busca ser compatible con OpenAI, pero existen algunos edge cases (IDs de modelos, comportamientos de streaming). Si Raycast espera un formato de streaming concreto y CometAPI emite una forma ligeramente distinta, prueba primero una llamada sin streaming y contacta al soporte de CometAPI si es necesario.

Conclusión

CometAPI te da acceso unificado y multi-vendor a muchos modelos (texto, imagen, audio, video) y permite a los equipos centralizar la facturación y el enrutamiento. Raycast te proporciona un lugar inmediato y centrado en el teclado para llamar a esos modelos en el contexto de tus flujos de trabajo de escritorio. Juntos hacen que la experimentación con modelos y la automatización de escritorio sean fluidas: puedes intercambiar modelos por coste o calidad, mantener tus claves en local y usar los mismos patrones al estilo OpenAI que ya tienes en scripts y apps.

Si quieres probar ahora mismo, explora las capacidades de models's(Gemini 3 Pro Preview API etc) de CometAPI en el Playground y consulta la guía de la API para instrucciones detalladas. Antes de acceder, asegúrate de haber iniciado sesión en CometAPI y obtenido la clave de API. CometAPI ofrece un precio muy inferior al oficial para ayudarte a integrar.

¿Listo para empezar?→ usa CometAPI en Raycast hoy !

Si quieres conocer más consejos, guías y noticias sobre IA, síguenos en VK, X y Discord!