Alibaba Cloud Model Studio:Cherry Studio

Use modelos do Alibaba Cloud Model Studio no Cherry Studio.

Início rápido

1. 1

   Obtenha uma chave de API

   Obtenha a chave de API do seu plano de cobrança:

   • Token Plan Personal Edition: Criar ou visualizar API Key
   • Token Plan Team Edition: Atribuir assento e obter API Key
   • Pagamento conforme o uso: Chave de API do Model Studio
   • Coding Plan: Chave de API do Coding Plan
2. 2

   Configure o modelo

   No Cherry Studio, clique no botão de configurações no canto superior direito, clique em Adicionar em Modelos, insira um nome de provedor (por exemplo, Bailian) e selecione OpenAI como o tipo de provedor. Configure os seguintes campos para o seu plano de cobrança:

   Token Plan

   Parâmetro	Valor
   Endereço da API	https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   Chave de API	Chave de API do Token Plan (Edição Pessoal ou Edição de Equipe)
   Modelo	Insira um modelo de geração de texto suportado pela Edição Pessoal ou pela Edição de Equipe

   Pagamento conforme o uso

   O Pagamento conforme o uso é cobrado pelo uso real. Substitua {WorkspaceId} pelo seu ID do Workspace. O exemplo a seguir usa Singapura.

   Parâmetro	Valor
   Endereço da API	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   Chave de API	Chave de API do Model Studio
   Modelo	qwen3.8-max ou qwen3.8-flash; para os modelos disponíveis, consulte modelos suportados pela API compatível com OpenAI

   Coding Plan

   Parâmetro	Valor
   Endereço da API	https://coding-intl.dashscope.aliyuncs.com/v1
   Chave de API	Chave de API do Coding Plan
   Modelo	qwen3.7-plus; para os modelos disponíveis, consulte modelos suportados pelo Coding Plan

3. 3

   Verifique

   Insira o modelo em ID do modelo e clique em Adicionar. Volte ao chat, selecione o modelo que você acabou de adicionar e envie uma mensagem. Uma resposta normal confirma a configuração.

Códigos de erro

Se você encontrar erros, consulte as perguntas frequentes do seu plano de cobrança:

• Token Plan: FAQ da Edição Pessoal · FAQ da Edição de Equipe
• Pagamento conforme o uso: Códigos de erro
• Coding Plan: FAQ do Coding Plan

FAQ

Como usar um plano de economia com pagamento conforme o uso?

A configuração de pagamento conforme o uso permanece a mesma: use a chave de API geral do Model Studio e a Base URL. Após comprar um plano de economia, ele entra em vigor automaticamente e o uso elegível é deduzido automaticamente. Consulte Planos de economia.

Erro 401: não autorizado

Possíveis causas:

• A chave de API não corresponde ao plano de cobrança selecionado. As chaves de API do Token Plan, do Pagamento conforme o uso e do Coding Plan não são intercambiáveis.
• A chave de API e o endereço da API do Pagamento conforme o uso estão em regiões diferentes.

Use a chave de API dedicada ao plano selecionado e verifique se a chave de API do Pagamento conforme o uso corresponde à região.

Erro de falta de permissão quando uma subconta RAM chama um modelo

As subcontas RAM precisam de permissão para chamar o modelo. Consulte Gerenciamento de Workspace.

Erro: o valor do parâmetro enable_thinking é restrito a True

Causa: Este modelo requer o modo de pensamento, que não foi ativado.

Solução: Ative o modo de pensamento no cliente.

Cobranças geradas mesmo com uma cota gratuita ao usar o Pagamento conforme o uso

Possíveis causas:

• Incompatibilidade de região: A cota gratuita se aplica apenas a modelos na região de Singapura. Usar modelos em outras regiões gera cobranças. Verifique se o Endereço da API corresponde à região de destino. Consulte Cota gratuita para novos usuários.
• Cota gratuita por modelo: Cada modelo tem sua própria cota gratuita.
• Atraso na atualização dos dados: Os dados da cota gratuita são atualizados a cada hora. Sua cota pode estar esgotada mesmo que o console mostre um saldo restante.

Consulte Identificar modelos com cobranças e Como visualizar registros de invocação de modelos? para obter detalhes.