Coloque modelos do catálogo no Raycast AI com um providers.yaml.

Resposta rápida: habilite Custom Providers, edite um arquivo.

O caminho do Raycast para endpoints compatíveis com OpenAI é a funcionalidade Custom Providers, voltada para usuários avançados e desabilitada por padrão. Habilite-a na parte de baixo da seção AI nas Configurações do Raycast, use Reveal Providers Config para abrir a pasta de config, e copie o providers.template.yaml distribuído para providers.yaml. O arquivo vive em ~/.config/raycast/ai/providers.yaml. Cada entrada de provider recebe um id, um nome de exibição, um base_url, e um bloco api_keys; cada modelo que você quiser no seletor é declarado explicitamente com seu id, um nome de exibição, e sua janela de contexto, mais um bloco abilities descrevendo o que o Raycast pode pedir dele. O formato de base_url segue a mesma convenção que os exemplos embutidos de modelo local, que apontam para uma raiz /v1, então o valor da APIsRouter é https://api.apisrouter.com/v1. O arquivo contém credenciais, então trate-o como qualquer arquivo de segredos.

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

Duas funcionalidades do Raycast que soam parecidas, e não são.

O Raycast documenta duas formas de trazer seu próprio acesso de IA, e buscar por uma confiavelmente traz a outra à tona, então a distinção vale a pena declarar claramente. Bring Your Own Keys, a página BYOK no manual do Raycast, conecta sua chave pessoal Anthropic, Google, ou OpenAI (OpenRouter no iOS) ao Raycast AI. É a funcionalidade mais simples, documentada como funcionando sem uma assinatura Pro, mas não é um endpoint personalizado: requisições roteiam pelos servidores do Raycast para unificação de API, e o manual é explícito que só modelos já disponíveis no Raycast AI são acessíveis. Uma chave de gateway não se encaixa ali, porque o BYOK nunca pede uma URL. Custom Providers é a funcionalidade que esta página configura: seu próprio base_url, sua própria chave, seus próprios modelos declarados, requisições indo para onde você aponta. É o caminho para um gateway multi-fornecedor, para servidores locais, e para qualquer modelo que a lista embutida do Raycast não carregue. A troca é explicitude: o Raycast não busca a lista de modelos do endpoint para você (essa conveniência é um pedido de funcionalidade em aberto), então o seletor mostra exatamente o que seu YAML declara, nem mais nem menos.

Declarando modelos honestamente: ids, contexto, habilidades.

Como não há autodescoberta, o YAML é um contrato, e cada campo nele faz trabalho de verdade. O id do modelo precisa corresponder à listagem /v1/models do gateway exatamente; é o que viaja na requisição. O name é só o rótulo que o Raycast mostra. O valor de context diz ao Raycast quanto histórico de conversa ele pode empacotar em uma requisição, então subestimá-lo desperdiça capacidade e superestimá-lo produz requisições que o modelo rejeita; use a janela documentada para o id que você está declarando. O bloco abilities é onde as pessoas erram. Ele declara o que o Raycast pode assumir de cada modelo: controle de temperatura, entrada de visão, mensagens de sistema, uso de ferramenta, esforço de raciocínio. Declarar uma habilidade que o modelo não tem produz falhas confusas em tempo de execução dentro das funcionalidades do Raycast em vez de erros limpos, e omitir uma que o modelo tem desabilita silenciosamente o comportamento correspondente do Raycast. Comece minimalista, temperature mais tools para os modelos que você vai usar com extensões de IA, e adicione habilidades conforme você as confirma contra a documentação do modelo. Existe uma extensão do Raycast mantida pela comunidade especificamente para gerenciar esse arquivo por uma UI, com backups automáticos antes de cada mudança, vale a pena conhecer se editar YAML à mão não é sua preferência. De qualquer forma, o Raycast lê o arquivo do disco, então depois de editar, dê um momento às configurações de AI ou alterne a funcionalidade para garantir que o seletor reflita o arquivo atual.

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

Escolhendo modelos para um launcher.

Como todo modelo declarado é cobrado pela mesma chave, o ciclo de comparação é uma troca no seletor: rode os mesmos comandos rápidos em dois ids por um dia, depois leia o gasto por modelo no console e mantenha o que ganhou seu lugar.

• IA de launcher é trabalho em rajada: resuma isto, reescreva aquilo, explique a seleção. claude-haiku-4-5-20251001 e gemini-3.5-flash retornam antes da animação da janela terminar, que é a sensação que usuários do Raycast esperam.
• Sessões de AI Chat e rascunhos longos merecem claude-sonnet-4-6 ou gpt-5.5; declare-os ao lado da camada rápida e troque por tarefa no seletor.
• Extensões de IA que chamam ferramentas precisam de um modelo com uso de ferramenta confiável, e o bloco abilities declarado para corresponder; claude-sonnet-4-6 é a primeira escolha segura ali.
• deepseek-v4-flash é a escolha de volume para usuários que conectam IA a todo campo de texto que tocam; pequenas completions constantes se acumulam, e a camada rápida mantém o hábito invisível no saldo.
• Declare poucos modelos deliberadamente em vez de muitos especulativamente: toda entrada é uma linha do seletor que você rola para passar, e o YAML é fácil de estender no dia em que você precisar de outro id.

Pague pelo uso · abaixo do preço oficial

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

Modos de falha específicos do Raycast.

Configurar BYOK quando você queria Custom Providers é o erro de nível superior, e não é culpa sua: as funcionalidades compartilham um espaço de busca. Se o fluxo em que você está pede uma chave de fornecedor mas nunca uma URL, você está no BYOK, e o gateway não se encaixa ali. Volte para Settings, AI, e o toggle Custom Providers na parte de baixo. O arquivo sendo ignorado geralmente significa que o toggle da funcionalidade está desligado, o arquivo ainda se chama providers.template.yaml, ou o YAML tem um erro de sintaxe, caso em que o Raycast não tem nada válido para carregar e o seletor simplesmente não mostra modelos personalizados. Valide o YAML antes de suspeitar de algo mais profundo. Um modelo que dá erro em algumas funcionalidades do Raycast mas não em outras é uma incompatibilidade de abilities: extensões de IA que usam ferramentas falham enquanto o chat simples funciona quando tools foi declarado em um modelo que não o tem, ou nunca declarado em um que tem. Requisições rejeitadas por tamanho apontam para um valor de context superestimado. E note o limite de plataforma honestamente: Custom Providers é configurado no Mac, em um arquivo de config local. Se parte do seu uso do Raycast é em outro lugar, verifique o manual para o que a funcionalidade suporta ali antes de assumir paridade.

Quem roteia o Raycast AI por um gateway.

• Power users que vivem no launcher e querem comandos rápidos de IA em ids rápidos do catálogo sem uma assinatura decidindo quais modelos eles podem tocar.
• Pessoas que já roteiam suas ferramentas de editor e terminal por um gateway e querem o launcher na mesma chave, um log de uso em toda superfície.
• Usuários que querem modelos que a lista embutida do Raycast não carrega, ids DeepSeek e GLM incluídos, declarados uma vez em YAML e disponíveis em todo lugar no app.
• Desenvolvedores de extensões de IA que precisam de um modelo específico capaz de ferramentas por trás da extensão deles, fixado por id em vez de sujeito a uma lista hospedada.
• Desenvolvedores sem acesso ao faturamento de um determinado fornecedor. O acesso baseado em recarga sem exigência de cartão remove a dependência de cadastro por provedor.

Verifique o endpoint e depure o primeiro comando.

Rode o curl de modelos primeiro e copie ids da saída dele para o YAML; digitar ids de memória é a principal causa de erros model-not-found aqui, porque o arquivo é a única fonte de modelos que o Raycast tem. Depois habilite o toggle, confirme que o seletor mostra seus nomes declarados, e rode um comando rápido de IA no modelo rápido. Um seletor vazio é o toggle, o nome do arquivo, ou a sintaxe do YAML. Um erro de autenticação é o bloco api_keys. Um erro not-found é uma incompatibilidade de id contra a listagem que você acabou de curl. Um comando que funciona no chat mas falha em uma extensão de IA é a declaração de abilities naquele modelo. Assim que os comandos fluem, o console da APIsRouter mostra modelo, contagens de token, e gasto por requisição. IA de launcher são centenas de pequenas requisições em vez de poucas grandes, e o log de uso é onde esse padrão vira um número, por modelo, por dia, na mesma página que toda outra ferramenta que você roteia pelo 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"}]}'

Perguntas frequentes