pw ai providers create

Create an AI provider

Synopsis

The pw ai providers create command creates a new AI provider from an enabled platform catalog entry. The platform defines the provider type, endpoint, and transport policy.

For API-key providers (openai, anthropic, grok, groq, together, fireworks, mistral, deepseek, or an approved custom integration), --api-key is required. For azure-foundry providers, --region, --network, and a billing target are required. For bedrock providers, --region, --cloud-account, and a billing target are required; credentials come from the cloud account rather than a network.

The billing target is --resource-group on platforms with the Resource Groups preview enabled, or --group otherwise. When both are given, the resource group takes precedence.

pw ai providers create [flags]

Examples

  pw ai providers create --name my-grok --provider grok --api-key xai-xxx
  
  # Provision an Azure AI Foundry provider billing a resource group
  pw ai providers create --name my-azure --provider azure-foundry --region eastus --resource-group my-resource-group --network my-network
  
  # Connect Bedrock in an AWS cloud account, billing a group
  pw ai providers create --name my-bedrock --provider bedrock --region us-east-1 --group my-group --cloud-account my-aws-account

Options

      --api-key string          API key (required for API-key providers)
      --cloud-account string    Cloud account supplying credentials (required for bedrock)
      --group string            Billing group (azure-foundry and bedrock; superseded by --resource-group)
  -h, --help                    help for create
      --model string            Initial model deployment (azure-foundry)
      --name string             Provider name (required)
      --network string          Network (required for azure-foundry)
      --provider string         Catalog entry ID (required, e.g. openai, anthropic, grok, azure-foundry)
      --region string           Region (required for azure-foundry and bedrock)
      --resource-group string   Resource group the provider bills against (azure-foundry and bedrock; required on platforms with the Resource Groups preview enabled)

Options inherited from parent commands

      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging

pw ai providers create