Skip to main content
Model aliasing is currently supported on enterprise.blackbox.ai. Use https://enterprise.blackbox.ai/chat/completions as the base URL.

​
Creating a Model Alias

To create a model alias, navigate to your dashboard and configure the following fields:
Navigation: Go to /dashboard → Open Manage Organization → Select Models tab

​
Required Fields

When creating a model alias, you need to configure the following fields:
FieldRequiredDescription
Alias NameYesA custom name for your model alias. Use this name in your API requests instead of the full model path.
Base ModelYesThe underlying model to use (e.g., claude-sonnet-4, gpt-4o, llama-3.3-70b-instruct).
ProviderNoOptional provider routing preference. If specified, requests will be routed to this provider.

​
Example Usage

Once you’ve created an alias (e.g., my-assistant-model), you can use it in your API requests: 
curl -X POST https://enterprise.blackbox.ai/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "my-assistant-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
Model aliases are especially useful when working with multiple environments or when you need to A/B test different models without changing your application code.