> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Alias

<Info>
  Model aliasing is currently supported on **enterprise.blackbox.ai**. Use `https://enterprise.blackbox.ai/chat/completions` as the base URL.
</Info>

<div style={{textAlign: 'center'}}>
  <video src="https://storage.googleapis.com/blackbox-docs/videos/model-alias.mp4" width="100%" height="100%" controls />
</div>

## Creating a Model Alias

To create a model alias, navigate to your dashboard and configure the following fields:

<Info>
  **Navigation:** Go to `/dashboard` → Open **Manage Organization** → Select **Models** tab
</Info>

## 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:

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  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"}]
    }'
  ```

  ```python Python theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  import requests

  response = requests.post(
      "https://enterprise.blackbox.ai/chat/completions",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "model": "my-assistant-model",
          "messages": [{"role": "user", "content": "Hello"}]
      }
  )
  print(response.json())
  ```

  ```javascript Node.js theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  const response = await fetch("https://enterprise.blackbox.ai/chat/completions", {
      method: "POST",
      headers: {
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      body: JSON.stringify({
          model: "my-assistant-model",
          messages: [{ role: "user", content: "Hello" }]
      })
  });
  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

<Tip>
  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.
</Tip>