Configure AI services

Last updated: June 2026

Account Admins and Organization Admins can connect their own AI provider keys to Katalon True Platform through the AI Services configuration page. Each key covers three capability tiers: Mini, Standard, and Frontier. Katalon routes AI requests to the right tier automatically, so you do not need to configure a provider for each AI-powered feature.

Supported providers include OpenAI, Azure OpenAI, AWS Bedrock, OpenAI Compatible, and Gemini.

Requirements

• You must be an Account Admin or System Admin.

Enable or disable AI features

Katalon enables AI features by default.

1. Go to Account Settings > System > Configurations > AI Services.
2. Toggle the Enable AI Features switch.

Choose how Katalon uses AI keys

On the AI Services page, select how Katalon routes AI feature requests.

• Allow AI keys at User level: Allows users to provide their own AI keys in supported products, such as Katalon Studio.
• Use default Katalon AI Key: Uses the default key provided by Katalon for AI-powered features.
• Use your organization's AI Key: Routes AI feature requests through the AI keys configured for your account or organizations.

When you provide your own AI keys, all AI feature requests route exclusively through your configured provider. Katalon's providers are not used as a fallback.

note

If a configured key runs out of quota or becomes unavailable, the AI feature returns an error instead of routing to Katalon's provider. To avoid unavailable tiers, make sure your keys cover Mini, Standard, and Frontier.

Configure account-level AI keys

Account AI keys are the default fallback for AI requests across your account. Any organization without its own configured key uses the account key.

1. In Account AI Key Settings, click + Add AI Key for Account.

2. In AI Key Name, enter a name for the key.
3. In Provider, select a provider: OpenAI, Azure OpenAI, AWS Bedrock, or OpenAI Compatible.
4. In API Key, enter the provider key.
5. Optional: In Organization, enter the organization value required by your provider.
6. Click Validate Key.

note

Validating a key confirms that the provider accepts the credentials. It does not verify model availability. Check your provider console for model-level access.

8. In Model per Capability Tier, choose the model for each tier:
   • Mini: Fast, lower-cost models for high-volume tasks.
   • Standard: Balanced models for everyday AI features.
   • Frontier: Best-available models for complex reasoning.

You can select Auto pick to use the recommended model for the selected provider and tier.

9. When you're done, click Add.

After you add an account key, it appears in the Account AI Key Settings table. The table shows the provider, masked key, and configured model for each capability tier. If a tier does not have a selected model, the table displays Not Configured.

Configure organization-specific AI keys

Organization-specific AI keys apply to a selected organization. You can also choose whether the organization can fall back to parent organization or account keys when a tier is not covered.

1. In Organization-Specific AI Key, click + Add AI Key.
2. In Organization, select an organization.
3. Toggle Allow fallback to parent keys when a tier is uncovered.

When this option is on, if the organization's keys do not cover a tier, Katalon escalates the request to parent organization or account keys.

5. Click + Add AI Key.
6. Enter the key name, provider, API key, optional organization value, and model per capability tier.
7. Click Validate Key.
8. Click Add.

After you add an organization-specific key, it appears in the organization's AI Keys table.

On the main AI Services page, the Organization-Specific AI Key table shows each organization's fallback setting:

• Allow: The organization can use parent organization or account keys when its own keys do not cover a tier.
• Strict: The organization must use its own configured keys.

Restrict AI access to organizations with their own keys

Use the Restrict AI access to organizations with their own configured key only option to prevent organizations without their own AI key from using account-level keys.

Under Organization-Specific AI Key, toggle Restrict AI access to organizations with their own configured key only.

When this option is enabled, organizations must use their own configured keys for AI requests. Organizations without configured keys cannot fall back to account-level keys.

Manage AI keys

1. Go to Account Settings > System > Configurations > AI Services.
2. To edit a key, click the Edit icon in the key row.
3. To delete a key, click the Delete icon in the key row.

TrueTest compatibility

Your organization’s AI Services configuration determines which Katalon features, including TrueTest, are available:

AI Services settings	TrueTest behavior
AI features disabled	Tracking pauses. You can still access existing maps, flows, and test cases, run gap analysis, and generate test cases for existing flows. You cannot track new data or generate new journey maps.
AI features enabled, supported provider (Katalon Default, OpenAI, or Azure OpenAI)	TrueTest operates normally.
AI features enabled, unsupported provider	TrueTest displays a warning. Tracking data remains accessible but new tracking is unavailable.