How do I add Leiolai to Raycast AI?

Raycast’s custom AI-provider feature lets you add Leiolai through a YAML provider configuration. Use the Leiolai /v1 base URL, a Private-only Leiolai API key, and leiolai-1 model ID, then select the custom model in Raycast AI. The custom-provider feature requires Raycast Pro.

Where do I find Raycast’s custom-provider configuration?

To configure Leiolai in Raycast, open Settings, AI, Models & Providers, Custom Providers, then Reveal Providers Config. Copy providers.template.yaml to providers.yaml in the same folder, ~/.config/raycast/ai.

Which fields identify Leiolai?

Set the Raycast provider id to leiolai, name to Leiolai, and base_url to https://api.leiolai.com/v1. Add a model with id: leiolai-1 and name: Leiolai 1.

Where does the API key go?

Put your Leiolai API key in the api_keys.leiolai entry. Keep the real key only in your private configuration file, and leave the credential out of any shared YAML or screenshot. Use a Private-only key for confidential work.

Create and protect an API key

Do I need to restart Raycast after editing the file?

Raycast watches the provider file. Save the YAML and check the AI model selector for Leiolai. If the model does not appear, check indentation, field names, provider ID, and the file location.

Is Raycast Pro required for this setup?

Yes. Raycast Custom Providers requires Raycast Pro. Leiolai API usage is billed separately at the selected input and output token rates.

Estimate Leiolai API usage

Do provider capability flags enable every AI feature?

The minimal Leiolai provider entry configures chat. Raycast offers optional flags for vision and AI Extensions; add those only for features you have exercised with your Leiolai connection.

Understand supported image requests

What is a useful first AI command to test?

Use a small rewrite or explanation with non-sensitive sample text. Confirm that the selected model is Leiolai and the request succeeds. Then choose the model for the Raycast AI commands or conversations you intend to use.

What should I check after an error?

For a Leiolai error in Raycast, check the model ID, /v1 URL, key permission, and returned error code. If the client sends an unsupported optional field, compare the request with the documented API contract.

Troubleshoot the response