v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB
Providers

Create a key for a provider

Creates a new API key for the specified provider. The key id is auto-generated if omitted. enabled defaults to true if omitted. value is required and must not be empty. Keys cannot be created on keyless providers.

post/api/providers/{provider}/keys

Path parameters

providerstring required

Provider name

Request body

idstring

Unique identifier for the key

namestring

Name of the key

modelsstring[]

List of models this key can access (whitelist)

blacklisted_modelsstring[]

List of models this key cannot access (blacklist)

weightnumber

Weight for load balancing

aliasesobject

Model alias mappings - maps a user-facing model name to a provider-specific identifier (deployment name, inference profile ID, fine-tuned model ID, etc.)

enabledboolean

Whether the key is active (defaults to true)

use_for_batch_apiboolean

Whether this key can be used for batch API operations

config_hashstring

Hash of config.json version, used for change detection

statusstring

Status of key (e.g., success, list_models_failed)

descriptionstring

Error or status description for the key

Response

Key created successfully

idstring

Unique identifier for the key

namestring

Name of the key

modelsstring[]

List of models this key can access (whitelist)

blacklisted_modelsstring[]

List of models this key cannot access (blacklist)

weightnumber

Weight for load balancing

aliasesobject

Model alias mappings - maps a user-facing model name to a provider-specific identifier (deployment name, inference profile ID, fine-tuned model ID, etc.)

enabledboolean

Whether the key is active (defaults to true)

use_for_batch_apiboolean

Whether this key can be used for batch API operations

config_hashstring

Hash of config.json version, used for change detection

statusstring

Status of key (e.g., success, list_models_failed)

descriptionstring

Error or status description for the key