---
title: "Customize Internal Models"
site_url: "https://www.letsmagic.cn/help"
retrieval_url: "https://www.letsmagic.cn/help/en-US/llms/advanced-enterprise-management/customize-internal-models.md"
citation_url: "https://www.letsmagic.cn/help/en-US/docs/advanced-enterprise-management/customize-internal-models"
---

# Customize Internal Models

Summary：Add text, image generation, or video model providers for the current organization in the admin console, and configure the specific models the organization can use.

Canonical citation URL (for users)：https://www.letsmagic.cn/help/en-US/docs/advanced-enterprise-management/customize-internal-models
Machine retrieval URL (for agents only)：https://www.letsmagic.cn/help/en-US/llms/advanced-enterprise-management/customize-internal-models.md
Category：Advanced Management
Type：Step-by-Step Tutorial
Difficulty：Advanced
Updated：2026-09-02

Add text, image generation, or video model providers for the current organization in the admin console, and configure the specific models the organization can use.

## Before You Begin

- Sign in to SuperMagic and open the admin console for the organization you want to configure.
- Confirm that the current account has permission to manage custom models under **AI Management**.
- Determine whether you need to connect a text, image generation, or video model.
- Obtain the API Key, Access Key, Secret Key, or other access credentials issued by the provider.
- Obtain the complete API endpoint, model identifier, model deployment name, and display information.

API Keys, Access Keys, and Secret Keys are sensitive credentials. Enter them only on controlled administration pages. Do not include them in documents or screenshots, or send them to unauthorized individuals.

## Understand Providers and Models

Custom models have two configuration levels:


| Configuration object | Purpose                                                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Provider**         | Stores the access credentials, API endpoint, alias, and display priority required to connect to the model service.        |
| **Model**            | Stores the model identifier, deployment name, parameters, capabilities, and display information used by the organization. |


You must first add and configure a provider, and then add specific models under that provider. A provider can contain multiple models. If you use multiple accounts from the same provider, you can use aliases to distinguish their configurations.

## Open the Custom Models Page

1. Click **AI Management** at the top of the admin console.
2. Expand **Custom Models** in the left navigation menu.
3. Click **Text Models**, **Image Generation Models**, or **Video Models**, as needed.

![Select the type of model to configure](https://www.letsmagic.cn/help/docs/docs/2026-08-19/c6644fde-adb1-4d3c-a8f2-71c457e5e052.jpg)

The page displays the providers added for the current organization under **Enabled Providers** and **Disabled Providers**, along with options such as **Add Provider**, **Service Configuration**, and **Manage Models**.

## Add a Model Provider

1. Open the page for the type of model you want to configure.
2. Click **Add Provider**.

![Open the window for adding a model provider](https://www.letsmagic.cn/help/docs/docs/2026-08-19/96c6b41c-f0e3-4224-8df1-032a75e82887.jpg)

3. Click the **Provider** drop-down menu.
4. Search for and select the service provider you want to connect.
5. Under **Alias**, enter a name that administrators can easily recognize.
6. Enter the connection information displayed on the page, such as the API Key, Access Key, Secret Key, or API endpoint.
7. Click **OK**.

![Enter the model provider connection information](https://www.letsmagic.cn/help/docs/docs/2026-08-19/d75ade97-4aa7-4623-b1de-d9bff9d8b359.jpg)

Authentication methods may vary by provider. Refer to the fields on the current page and the connection information supplied by the service provider. You cannot directly change the provider type after creating it. If you selected the wrong type, delete the provider and add it again.

## Configure Provider Services

1. Click **Service Configuration** or **Manage Models** on the target provider card.
2. Review or modify the provider alias.
3. Review and update the access credentials and API endpoint.
4. Set the provider's display order under **Display Priority**.
5. Click **Save**.

![Configure model provider services and the model list](https://www.letsmagic.cn/help/docs/docs/2026-08-19/18643f2c-55c7-4aaf-8a60-1173513fa9f1.jpg)

After you save the provider configuration, the provider's existing models and the **Add Model** option appear at the bottom of the page.

## Add and Configure Models

### Add a Text Model

1. Click **Add Model** in the provider's model list.
2. Select a model type under **Model Type**.
3. Select a model ID under **Model Identifier**.
4. Under **Model Deployment Name**, enter the name or ID of the actual deployment on the provider's platform.
5. Select or upload a model display icon.
6. Enter the **Model Display Name** and **Model Description**.
7. Under **Maximum Context Tokens**, enter the maximum number of tokens supported by the model.
8. Based on the model's actual capabilities, select whether it supports tool calling, visual recognition, and deep thinking.
9. If the API has specific requirements, enter additional request headers or request body parameters.
10. Click **OK**.

![Configure basic text model information](https://www.letsmagic.cn/help/docs/docs/2026-08-19/07bbb019-40fd-440d-8b82-0732911783b3.jpg)

![Configure text model parameters and capabilities](https://www.letsmagic.cn/help/docs/docs/2026-08-19/97123f81-e9e2-41af-8dee-8a3e415e4812.jpg)

The model identifier cannot be changed after it is created. The model deployment name is used as the model ID in requests and must match the actual configuration on the provider's platform.

### Add an Image Generation or Video Model

1. Click **Add Model** on the service configuration page for an image generation or video provider.
2. Under **Model Identifier**, select the model you want to connect.
3. Enter the **Model Deployment Name** actually used on the provider's platform.
4. Select or upload a model display icon.
5. Enter the **Model Display Name** and **Model Description**.
6. Click **OK**.

![Add an image generation model](https://www.letsmagic.cn/help/docs/docs/2026-08-19/031a5deb-a108-403d-8498-c672f573186a.jpg)

![Add a video model](https://www.letsmagic.cn/help/docs/docs/2026-08-19/970f3301-df2d-43e0-90a0-1a68e438a32b.jpg)

The available model identifiers and connection fields may vary by provider. Before saving, verify each item against the provider's actual configuration.

## Test and Manage Models

### Test Model Connectivity

1. Find the target model in the model list.
2. Click **Connectivity Test**.
3. When a confirmation prompt appears, read the message and confirm the operation.
4. Wait for the page to return the test result.

![Test video model connectivity](https://www.letsmagic.cn/help/docs/docs/2026-08-19/6062c7b5-4c0f-4d5d-9af5-10694b736b50.jpg)

If the test fails, check whether the access credentials, API endpoint, and model deployment name are correct. Also confirm that the provider account has permission to call the corresponding model.

### Edit or Copy a Model

1. Find the target model in the model list.
2. Click the edit icon to modify the model deployment name, display information, or other editable settings.
3. Click the copy icon to create a separate configuration based on the current model.
4. Review the copied fields and save the configuration.

![Edit a video model](https://www.letsmagic.cn/help/docs/docs/2026-08-19/818341fb-0549-4613-8262-3d154ff67641.jpg)

![Copy a video model](https://www.letsmagic.cn/help/docs/docs/2026-08-19/7d771eb1-e6a3-4607-9217-e8a23e7b5026.jpg)

### Enable or Disable

- Use the **Status** toggle on the provider card or service configuration page to enable or disable the entire provider.
- Use the status toggle in the model list to enable or disable an individual model.

![Enable or disable a video model](https://www.letsmagic.cn/help/docs/docs/2026-08-19/5375ac13-918d-41b5-831f-162772121045.jpg)

Before disabling a provider or model, confirm whether any Digital Crew, AI assistants, workflows, or other features in the current organization still depend on that model.

### Delete a Model or Provider

1. Confirm that the model or provider is no longer used by the current organization.
2. Click the delete icon in the model list, or click **Delete Provider** on the service configuration page.
3. Follow the on-screen instructions to complete the deletion.

![Manage video model status and actions](https://www.letsmagic.cn/help/docs/docs/2026-08-19/4df7ea08-db4f-4831-8774-b24c481ac031.jpg)

Deletions typically cannot be directly reversed. Before proceeding, record any model identifiers, deployment names, and connection settings that you need to retain.

## Verify the Configuration

After completing the configuration, verify the following in order:

1. The provider appears in the correct enabled or disabled section.
2. The model list displays the correct model name, model ID, and capability information.
3. The model status meets the current organization's enablement requirements.
4. The connectivity test completes successfully.
5. Organization features that use models can select and call the model.