Skip to main content
A provider connection tells Aixy where to send a model request and which upstream account should pay for it. Applications keep their Aixy project key when you replace a provider credential. Use Providers to connect accounts, inspect connection checks, and manage credentials.

Connect a provider

  1. Select a project in the sidebar, or All projects for an organization connection.
  2. Open Providers → Add provider and select a provider.
  3. Follow the Setup guide beside the form for your provider’s credentials, permissions, and connection fields.
  4. Select Test connection and review each stage, then save the connection.
  5. Open Models, select an allowed conversational model, and make a short request in Playground.
For Cloudflare decision models such as Jev, verify with a decision request or a configured task-aware route after connecting. The dashboard’s Setup guide explains the Cloudflare account fields and required access. Decision models use their native evaluation format and may not support conversational requests in Playground. Owners and Org admins manage shared connections and project overrides. Project admins manage connections in their assigned projects. Members use the resulting models without receiving the provider credential. The provider picker lists built-in integrations and compatible endpoints. Select the connection that matches your account; region, model entitlement, enabled cloud APIs, and quotas still belong to that provider account. Connection checks give stage-specific guidance for those requirements.

Share a connection or override it

An organization connection supplies the default for all projects. A project connection for the same provider overrides that default, including its endpoint, credential, and cost configuration. This lets development and production use different provider accounts or regions. An expired or failing project override remains selected. Replace it to repair the project connection, or remove it explicitly to restore organization inheritance. See How Aixy fits together for the other scope rules.

Connect an OpenAI-compatible endpoint

Use Custom endpoint for a service exposing an OpenAI-compatible API. Its provider ID becomes part of every model ID: a model named coding-model on a connection called acme becomes acme/coding-model in Aixy. Keep the full upstream model ID, including any internal slashes. Aixy uses the saved endpoint for discovery and inference. The endpoint must be publicly reachable over HTTPS; the dashboard’s Setup guide explains the connection fields. Use Client protocols to choose the format for application requests.

Interpret connection checks

A check reports configuration, authentication, and catalog evidence independently. It sends no prompt. A successful catalog response can come from a public catalog, so verify inference with a Playground request before adopting a connection. Saving valid configuration and testing network access are separate actions. The Model prices stage reports whether the provider publishes a price API that Aixy reads directly, and whether it answered for this connection’s region. Passed shows how many models the API prices and how many of the discovered models it covers. Failed means Aixy knows of that API but could not read it, and keeps the last stored prices. Unknown means Aixy has no verified price API for the provider or region; it does not say that none exists. Prices for those models can come from an aggregator catalog or a Price Book rate. This stage never changes the overall result, because it queries a public API and says nothing about your credentials. When a credential changes, run a fresh check. Uploaded temporary AWS credentials must be replaced before expiry; an IAM role lets Aixy renew the temporary session. Vertex service-account connections let Aixy obtain and renew access tokens using the saved credential. For spend reporting and streaming usage settings, continue to Pricing and cost attribution. Provider credentials are separate from application API keys.