Pon modelos del catálogo en Raycast AI con un providers.yaml.

Respuesta rápida: activa Custom Providers, edita un archivo.

La ruta de Raycast para endpoints compatibles con OpenAI es la función Custom Providers, dirigida a usuarios avanzados y desactivada por defecto. Actívala al final de la sección de IA en Raycast Settings, usa Reveal Providers Config para abrir la carpeta de configuración, y copia el providers.template.yaml distribuido a providers.yaml. El archivo vive en ~/.config/raycast/ai/providers.yaml. Cada entrada de proveedor toma un id, un nombre visible, un base_url, y un bloque api_keys; cada modelo que quieras en el selector se declara explícitamente con su id, un nombre visible, y su ventana de contexto, más un bloque abilities que describe qué puede pedirle Raycast. La forma del base_url sigue la misma convención que los ejemplos integrados de modelo local, que apuntan a una raíz /v1, así que el valor de APIsRouter es https://api.apisrouter.com/v1. El archivo guarda credenciales, así que trátalo como cualquier archivo de secretos.

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

Dos funciones de Raycast que suenan parecido, y no lo son.

Raycast documenta dos formas de traer tu propio acceso de IA, y buscar una hace aparecer confiablemente la otra, así que la distinción vale la pena expresarla con claridad. Bring Your Own Keys, la página BYOK del manual de Raycast, conecta tu clave personal de Anthropic, Google u OpenAI (OpenRouter en iOS) a Raycast AI. Es la función más simple, documentada como funcional sin suscripción Pro, pero no es un endpoint personalizado: las peticiones se enrutan a través de los servidores de Raycast para unificación de API, y el manual es explícito en que solo son accesibles los modelos ya disponibles en Raycast AI. Una clave de gateway no encaja ahí, porque BYOK nunca pide una URL. Custom Providers es la función que configura esta página: tu propio base_url, tu propia clave, tus propios modelos declarados, peticiones yendo donde tú apuntes. Es la ruta para un gateway multi-proveedor, para servidores locales, y para cualquier modelo que la lista integrada de Raycast no lleve. El costo es la explicitud, Raycast no obtiene la lista de modelos del endpoint por ti (esa conveniencia es una solicitud de función pendiente), así que el selector muestra exactamente lo que declara tu YAML, ni más ni menos.

Declarar modelos con honestidad: ids, contexto, habilidades.

Como no hay autodetección, el YAML es un contrato, y cada campo en él hace trabajo real. El id del modelo debe coincidir exactamente con el listado /v1/models del gateway; es lo que viaja en la petición. El name es solo la etiqueta que muestra Raycast. El valor context le dice a Raycast cuánto historial de conversación puede empaquetar en una petición, así que subestimarlo desperdicia capacidad y sobreestimarlo produce peticiones que el modelo rechaza; usa la ventana documentada para el id que estás declarando. El bloque abilities es el que la gente se equivoca. Declara en qué puede confiar Raycast: control de temperatura, entrada de visión, mensajes de sistema, uso de herramientas, esfuerzo de razonamiento. Declarar una habilidad que al modelo le falta produce fallos confusos en tiempo de ejecución dentro de las funciones de Raycast en lugar de errores limpios, y omitir una que el modelo sí tiene desactiva silenciosamente el comportamiento correspondiente de Raycast. Empieza mínimo, temperature más tools para los modelos que usarás con extensiones de IA, y añade habilidades a medida que las confirmes contra la documentación del modelo. Existe una extensión de Raycast mantenida por la comunidad específicamente para gestionar este archivo desde una interfaz, con copias de seguridad automáticas antes de cada cambio, vale la pena conocerla si el YAML a mano no es tu preferencia. De cualquier forma, Raycast lee el archivo desde disco, así que después de editar, dale un momento a los ajustes de IA o alterna la función para asegurarte de que el selector refleje el archivo actual.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

Elegir modelos para un launcher.

Como cada modelo declarado factura a través de la misma clave, el bucle de comparación es un cambio en el selector: corre los mismos comandos rápidos en dos ids durante un día, luego lee el gasto por modelo en la consola y conserva el que se ganó su lugar.

• La IA del launcher es trabajo en ráfagas: resume esto, reescribe aquello, explica la selección. claude-haiku-4-5-20251001 y gemini-3.5-flash responden antes de que termine la animación de la ventana, que es la sensación que esperan los usuarios de Raycast.
• Las sesiones de AI Chat y la redacción larga se ganan claude-sonnet-4-6 o gpt-5.5; decláralos junto al nivel rápido y cambia por tarea en el selector.
• Las extensiones de IA que llaman herramientas necesitan un modelo con uso de herramientas confiable, y el bloque abilities declarado para coincidir; claude-sonnet-4-6 es la primera opción segura ahí.
• deepseek-v4-flash es la opción de volumen para usuarios que cablean IA en cada campo de texto que tocan; las pequeñas completions constantes se acumulan, y el nivel rápido mantiene el hábito invisible en el saldo.
• Declara pocos modelos deliberadamente en lugar de muchos especulativamente: cada entrada es una fila del selector que hay que pasar de largo, y el YAML es fácil de extender el día que necesites otro id.

Pago por uso · por debajo del precio oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de fallo específicos de Raycast.

Configurar BYOK cuando querías Custom Providers es el error de nivel superior, y no es culpa tuya: las funciones comparten un espacio de búsqueda. Si el flujo en el que estás pide una clave de proveedor pero nunca una URL, estás en BYOK, y el gateway no pertenece ahí. Retrocede a Settings, AI, y el interruptor Custom Providers al final. Que el archivo sea ignorado suele significar que el interruptor de la función está apagado, el archivo todavía se llama providers.template.yaml, o el YAML tiene un error de sintaxis, en cuyo caso Raycast no tiene nada válido que cargar y el selector simplemente no muestra modelos personalizados. Valida el YAML antes de sospechar de algo más profundo. Un modelo que falla en algunas funciones de Raycast pero no en otras es un desajuste de abilities: las extensiones de IA que usan herramientas fallan mientras el chat simple funciona cuando tools se declaró en un modelo que carece de ello, o nunca se declaró en uno que sí lo tiene. Las peticiones rechazadas por tamaño apuntan a un valor de context sobreestimado. Y ten en cuenta el límite de plataforma con honestidad: Custom Providers se configura en el Mac, en un archivo de config local. Si parte de tu uso de Raycast está en otro lado, revisa el manual para ver qué admite la función ahí antes de asumir paridad.

Quién enruta Raycast AI a través de un gateway.

• Usuarios avanzados que viven en el launcher y quieren comandos rápidos de IA en ids rápidos del catálogo sin que una suscripción decida qué modelos pueden tocar.
• Personas que ya enrutan su editor y herramientas de terminal a través de un gateway y quieren el launcher en la misma clave, un solo log de uso a través de cada superficie.
• Usuarios que quieren modelos que la lista integrada de Raycast no lleva, ids de DeepSeek y GLM incluidos, declarados una vez en YAML y disponibles en todas partes de la app.
• Constructores de extensiones de IA que necesitan un modelo capaz de herramientas específico detrás de su extensión, fijado por id en lugar de sujeto a una lista alojada.
• Desarrolladores sin acceso a la facturación de un proveedor concreto. El acceso mediante recarga sin necesidad de tarjeta elimina la dependencia de registrarse en cada proveedor.

Verifica el endpoint y depura el primer comando.

Ejecuta primero el curl de modelos y copia los ids de su salida al YAML; escribir ids de memoria es la causa principal de errores de model-not-found aquí, porque el archivo es la única fuente de modelos que tiene Raycast. Luego activa el interruptor, confirma que el selector muestra tus nombres declarados, y ejecuta un comando rápido de IA en el modelo rápido. Un selector vacío es el interruptor, el nombre del archivo, o la sintaxis del YAML. Un error de autenticación es el bloque api_keys. Un error de no encontrado es un desajuste de id contra el listado que acabas de curl. Un comando que funciona en el chat pero falla en una extensión de IA es la declaración de abilities en ese modelo. Una vez que los comandos fluyen, la consola de APIsRouter muestra el modelo por petición, el recuento de tokens y el gasto. La IA del launcher son cientos de peticiones pequeñas en lugar de unas pocas grandes, y el log de uso es donde ese patrón se convierte en un número, por modelo, por día, en la misma página que cualquier otra herramienta que enrutes a través del gateway.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Preguntas frecuentes