Custom Provider

Ideavo allows you to connect model providers outside of its built-in provider list, including local models, self-hosted endpoints, and custom cloud providers, at no extra cost.

Using a Supported Provider?

Custom Providers are for local models, self-hosted endpoints, custom Base URLs, and provider configurations you control yourself. If you only want to connect a provider that Ideavo already supports with an API key or OAuth, use BYOK instead.

Add a Custom ProviderCopy Anchor Link

Click Add Provider to open the provider setup dialog. The dialog has two modes:

• Form mode for the guided setup experience.
• Raw mode for editing the provider configuration directly as JSON.

Form ModeCopy Anchor Link

Form mode is the recommended setup path for most users. It keeps the configuration structured and helps avoid JSON syntax mistakes.

Supported PackagesCopy Anchor Link

Ideavo supports and tests these SDK packages by default:

Choose the package that matches the API format exposed by your provider. For custom providers that expose an OpenAI-compatible API, @ai-sdk/openai-compatible is usually the right choice.

ModelsCopy Anchor Link

Each custom provider needs at least one model. Click Add in the Models section to open the model details dialog.

• Model ID is the provider-facing value used in API calls. It must be exact.
• Model name is the readable label shown in Ideavo. You can name it whatever helps your team recognize the model.
• Limits are optional context and output token values for the model.
• Reasoning should only be enabled for models that truly support reasoning or effort controls.

For example, a local Ollama model ID might be llama3.2, while the display name could be Llama 3.2 Local.

Raw ModeCopy Anchor Link

Raw mode is built for power users who want full control over the provider configuration. It lets you edit the same configuration directly in JSON, including provider options and model definitions.

Use raw mode when you need to customize advanced settings that are not exposed in the form, or when you already have a provider config you want to paste in directly.

To set model limits in raw mode, add limit.context and limit.output inside the model definition.

{
  "providerId": "local-ollama",
  "npm": "ollama-ai-provider",
  "name": "Local Ollama",
  "options": {
    "baseURL": "http://localhost:11434/api"
  },
  "models": {
    "llama3.2": {
      "name": "Llama 3.2 Local",
      "tools": "true",
      "limit": {
        "context": 128000,
        "output": 8192
      },
      "reasoning": false
    }
  }
}

Manage Existing ProvidersCopy Anchor Link

After you add a custom provider, it appears in the provider panel. From there, you can open the provider again, review its configuration, edit model details, or remove it completely.

View Your ProvidersCopy Anchor Link

Your saved custom providers are listed in the provider panel. This is the main place to confirm which custom or self-hosted providers are currently available in your account.

Edit a ProviderCopy Anchor Link

Click an existing provider to open the edit dialog. You can update most of the configuration, including the provider name, package, API key, Base URL, model list, and model limits.

This is useful when you rotate credentials, move a custom provider to a different port, rename a model, update context/output limits, or add another model exposed by the same provider.

Delete a ProviderCopy Anchor Link

Use Delete when you no longer want Ideavo to use that provider. Deleting a provider removes it from your custom provider list and also removes its models from the model selector.

If you only need to change credentials, Base URL, package, or model names, edit the existing provider instead of deleting and recreating it.

Use a Local ModelCopy Anchor Link

Every custom provider needs at least one model before it can be used for building in Ideavo. Once a provider and model are saved, the model appears in the model selector under that provider's name.

Select the ModelCopy Anchor Link

Open the model selector, expand your custom provider, and choose the model you added. Ideavo will then route future model requests through your provider using the selected model ID.

The label shown in the selector comes from the Model name field, while the actual request uses the Model ID configured for that model.

FAQCopy Anchor Link