API-key providers
Use an API key with a provider in Pi's bundled catalog.
Loading documentation…
Most Pi providers use auth-type: api-key. Store the provider key as a GitHub
Actions secret and pass it through auth-token. The Action supplies it only to
the selected provider; it does not create a local Pi credential file.
OpenRouter model IDs include the upstream provider name.
For Cloudflare Workers AI, use the cloudflare-workers-ai provider. Set the
Cloudflare account ID as a workflow, job, or Action-step environment variable;
the API token itself remains in auth-token.
To route a model through Cloudflare AI Gateway, use
provider: cloudflare-ai-gateway, set CLOUDFLARE_ACCOUNT_ID and
CLOUDFLARE_GATEWAY_ID, and choose a model available through the gateway, for
example claude-sonnet-4-5. Configure unified billing or stored BYOK in the
Cloudflare dashboard before running the audit.
Groq exposes fast hosted models through the groq provider. Store a Groq API
key as GROQ_API_KEY.
Use the mistral provider with a Mistral API key. A Devstral model is a useful
choice for a code-review workflow.
Use xai for Grok models with an xAI API key. Subscription OAuth credentials
are not available in a non-interactive GitHub Actions run, so use an API key.
Use the deepseek provider with a DeepSeek API key. Select a model exposed by
the bundled Pi catalog.
The bundled Pi catalog also includes API-key providers such as Cerebras, NVIDIA
NIM, Together AI, Fireworks, Hugging Face, and more. Use the provider
identifier and model ID from the Pi catalog, then pass its key as auth-token.
Some cloud gateways need extra provider-specific environment values. Set those at workflow or job level from GitHub Secrets or Variables. Refer to Pi's provider documentation for the complete catalog and provider-specific requirements.
Heyo asks Pi to inspect a bounded repository snapshot. Choose a capable model from the provider catalog; low-capability or unsupported models may fail to complete the structured audit.