Model Alias

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:

Field	Required	Description
Alias Name	Yes	A custom name for your model alias. Use this name in your API requests instead of the full model path.
Base Model	Yes	The underlying model to use (e.g., claude-sonnet-4, gpt-4o, llama-3.3-70b-instruct).
Provider	No	Optional 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

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.