Use Cases
| Suitable for users who have deployed Coze Studio locally or on a server and want to use MaiToken models to build agents and workflows. |
|---|
| This section applies to the open-source version of Coze Studio. Before starting the configuration, complete the Coze Studio deployment and confirm that you can access the administration console. |
|---|
Configuration Steps
Open Model Management: On the device where Coze Studio is deployed, open http://localhost:8888/admin/#model-management . If Coze Studio is deployed on a server, replace
localhostwith the actual administration address.Add a Model: Click “Add Model.”
Select the Protocol: Select
openaias the Protocol.Enter the Base URL: Enter https://api.maitoken.com/v1 . The model management page requires a Base URL, so you generally should not append
/chat/completions.Enter the API Key: Paste your MaiToken Key.
Enter the Model ID: Enter
<Model ID>in the Model ID or Model field. After the model has been put into use, do not change its ID without careful consideration, as existing Agents may no longer be able to find it.Configure Model Capabilities: Enable options such as Function Calling, Vision, and Reasoning according to the model's actual capabilities. If you are unsure, start by enabling text and tool-calling capabilities.
Test and Save: Click “Test.” After the test succeeds, save and enable the model.
Select the Model in an Agent: Create a test Agent, select the newly added MaiToken model from the model selector, save the configuration, and open the debugging page.
| Field | Value |
|---|---|
| Protocol | openai |
| Base URL | https://api.maitoken.com/v1 |
| API Key | <your MaiToken Key> |
| Model ID | <Model ID> |
Test the Configuration
Test a Basic Conversation: Enter “Reply with OK only” in the chat box. If you receive a valid response, the API Key, API address, and Model ID are configured correctly.
Test Tool Calling: Enter “Call a simple tool. If no tools are currently available, reply with OK only.”
Test the Agent: Ask the Agent to perform a simple test task and confirm that the result is as expected. Do not use real production workloads for the initial test.
Common Issues
| Issue | Solution |
|---|---|
| The administration console cannot be opened | Confirm that Coze Studio has been deployed and started. If you are using Docker, also check the port mapping. |
| Model testing returns 404 | Set the Base URL to https://api.maitoken.com/v1 . Do not append /chat/completions. |
| The Agent cannot find the model | Confirm that the model is enabled, and then refresh the model selector on the Agent editing page. |
