Chatbox

Updated at:

Use Alibaba Cloud Model Studio models in Chatbox.

Quick Start

  1. 1

    Get an API key

    Get the API key for your billing plan:

  2. 2

    Configure the model

    In Chatbox, click Settings at the bottom left, click Model Provider, and click Add at the bottom. Enter a Name, set API Mode to OpenAI API Compatible, and click Add. Configure the following fields for your billing plan:

    Token Plan

    ParameterValue
    API hosthttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    API keyToken Plan Personal Edition or Team Edition API key
    ModelEnter a text generation model supported by Personal Edition or Team Edition

    Pay-as-you-go

    Pay-as-you-go is billed by actual usage. Replace {WorkspaceId} with your Workspace ID. The following example uses China North 2 (Beijing).

    ParameterValue
    API hosthttps://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    API keyModel Studio API key
    Modelqwen3.8-max or qwen3.8-flash; for available models, see models supported by the OpenAI-compatible API

    Coding Plan

    ParameterValue
    API hosthttps://coding.dashscope.aliyuncs.com/v1
    API keyCoding Plan API key
    Modelqwen3.7-plus; for available models, see models supported by Coding Plan

    Leave the API path empty.

  3. 3

    Verify

    Click New, enter the model from the table in Model ID, and save. Select the model in the chat and send "Hello". A normal response confirms the configuration.

Error codes

If you encounter errors during configuration, see the FAQ for your billing plan:

FAQ

How do I use savings plans and resource plans with pay-as-you-go?

The pay-as-you-go setup remains the same: use your general Model Studio API key and Base URL. After you purchase a savings plan or resource plan, it takes effect automatically and eligible usage is deducted automatically. See Savings plans and resource plans.

Error 401 Unauthorized

Possible causes:

  • The API key does not match the selected billing plan. API keys for Token Plan, Pay-as-you-go, and Coding Plan are not interchangeable.
  • The API key is incomplete or contains extra spaces.

Use the dedicated API key for the selected plan, and copy the complete key again.