Todos os produtos
Search
Central de documentação

Alibaba Cloud Model Studio:FAQ

Última atualização: Jul 09, 2026

Perguntas frequentes sobre o Token Plan (Team Edition), abordando compra, uso, medição e desempenho.

Qual é a diferença entre o Token Plan (Team Edition) e o Coding Plan?

Token Plan (Team Edition)

Coding Plan

Casos de uso

Trabalho diário para fundadores solo, equipes e empresas

Cenários de desenvolvimento individual

Modelos compatíveis

Modelos de geração de texto e imagem

Modelos de geração de texto

Método de faturamento

Dedução de créditos com base no consumo de tokens

Faturamento por chamada de modelo

Frequência de uso

Sem cota por 5 horas ou por semana

Cota por 5 horas ou por semana

API Key e Base URL

Gere uma API key dedicado na plataforma de gerenciamento. Para a Base URL, consulte Início rápido

Obtenha sua API key dedicado e a Base URL na Página do Coding Plan

Desempenho em horários de pico

Isolamento multilocatário

Solicitações podem entrar em fila durante horários de pico

Segurança de dados

Seus dados não são usados para treinar modelos

Autorização de dados do usuário necessária

Conexão e uso

Como usar modelos de geração de imagem em ferramentas de codificação?

Os modelos de geração de imagem utilizam APIs separadas e não podem ser chamados diretamente pela Base URL do modelo de texto. Integre-os pelo mecanismo de Skill ou extensão da sua ferramenta. Para detalhes de configuração, consulte a seção de integração de modelos de geração de imagem no guia de integração de cada ferramenta.

Erros comuns e soluções

Mensagem de erro

Possível causa

Solução

401 InvalidApiKey: No API-key provided.

A solicitação não incluiu a API key no cabeçalho Authorization: Bearer ou x-api-key.

Gere uma API key na plataforma de gerenciamento e configure-a em sua ferramenta.

401 InvalidApiKey: Invalid API-key provided.

  1. Uso incorreto da API key de uso geral do Model Studio (formato sk-xxx) ou da API key do Coding Plan.

  2. A assinatura do Token Plan (Team Edition) expirou.

  3. A API key foi copiada incompleta ou contém espaços.

  1. Confirme se você está usando a API key dedicado do Token Plan. Certifique-se de que a chave foi copiada integralmente, sem espaços.

  2. Verifique se a assinatura expirou.

  3. Se o erro persistir, redefina a API key e configure a nova chave.

404 model 'xxx' not found or not supported

400 Model not exist.

  1. O nome do modelo está grafado incorretamente ou com capitalização errada.

  2. O ID do modelo não consta na lista de modelos compatíveis com o plano.

  1. Os nomes dos modelos diferenciam maiúsculas de minúsculas. Utilize um ID de modelo compatível com seu plano.

  2. Verifique se o plano selecionado inclui o modelo desejado.

401 invalid access token or token expired

Uso incorreto da Base URL do Coding Plan ou de outro plano.

Compatível com Anthropic: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Compatível com OpenAI: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

401 Incorrect API key provided

Uso incorreto da Base URL de uso geral do Model Studio (dashscope.aliyuncs.com).

Compatível com Anthropic: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Compatível com OpenAI: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

400 InvalidParameter: Range of input length should be [1, xxx]

O conteúdo de entrada (incluindo histórico de conversas e contexto de código) excede o comprimento máximo de contexto do modelo.

Inicie uma nova sessão para limpar o histórico ou utilize o comando nativo de compressão de contexto da ferramenta (como /compact no Claude Code ou /clear no Qwen Code). Também é possível alternar para um modelo com janela de contexto maior.

400 InvalidParameter: url error, please check url!

O caminho da Base URL não corresponde ao protocolo. Por exemplo, o caminho compatível com OpenAI foi configurado no endpoint Anthropic, ou vice-versa.

Escolha o endpoint correspondente ao protocolo utilizado pela sua ferramenta:

  • Compatível com Anthropic (Claude Code e similares): termina com /apps/anthropic.

  • Compatível com OpenAI (Cursor, Qwen Code e similares): termina com /compatible-mode/v1.

400 InvalidParameter: Range of max_tokens should be [1, xxxx]

O valor de max_tokens na solicitação (ou o comprimento máximo de saída na configuração da ferramenta) excede o limite de tokens de saída compatível com o modelo atual.

Defina max_tokens com um valor que não ultrapasse o limite indicado na mensagem de erro.

400 invalid_parameter_error: The thinking_budget parameter must be a positive integer and not greater than xxxxx

O comprimento de raciocínio configurado na ferramenta (como thinking_budget ou budgetTokens) excede o limite compatível com o modelo atual. O limite varia conforme o modelo — utilize o valor exibido no erro.

Defina o comprimento de raciocínio com um valor dentro do limite mostrado no erro ou remova o parâmetro para modelos que não suportam o modo de raciocínio.

400 data_inspection_failed: Input text data may contain inappropriate content.

A entrada ou saída acionou a política de segurança de conteúdo da plataforma.

Modifique a entrada e envie novamente. Se o problema persistir, ajuste o prompt para evitar tópicos sensíveis.

429 API-Key Requests rate limit exceeded, please try again later.

As solicitações foram muito frequentes em um curto período, acionando o limite de taxa do modelo.

Aguarde um minuto e tente novamente. Se isso ocorrer com frequência, reduza a taxa de solicitações e verifique se a API key não está sendo compartilhada com outros usuários.

429 Throttling.AllocationQuota: Allocated quota exceeded, please increase your quota limit.

insufficient_quota: You exceeded your current quota, please check your plan and billing details.

Este erro pode ter dois motivos:

Cota do plano esgotada: tanto a cota da licença quanto o pacote de cota compartilhada foram totalmente consumidos.

Limite de taxa do modelo atingido: mesmo com cota suficiente no plano, este erro ocorre quando os tokens consumidos por segundo ou por minuto (TPS/TPM) ultrapassam o limiar de taxa do modelo. Os limites de taxa são calculados no nível da conta Alibaba Cloud — o uso combinado de todos os usuários RAM, workspaces e API keys sob a conta é somado. Mesmo que o total por minuto esteja dentro do limite, um pico repentino de solicitações ainda pode acioná-lo.

Cota esgotada: adquira licenças adicionais (após a compra, atribua a nova licença a um membro antes de usar), compre um pacote de cota compartilhada ou aguarde a redefinição automática da cota no próximo ciclo de faturamento.

Limite de taxa atingido: aguarde cerca de um minuto e tente novamente. Suavize sua taxa de solicitações (por exemplo, use agendamento uniforme, backoff exponencial ou fila de solicitações) para evitar picos instantâneos.

Connection error

O domínio da Base URL está grafado incorretamente ou ocorreu um problema de conexão de rede.

Verifique a grafia do domínio da Base URL e sua conexão de rede.

Recursos do produto

A API key do Token Plan (Team Edition) funciona com outros planos ou APIs de uso geral?

Não. As API keys e Base URLs do Token Plan (Team Edition), do Coding Plan e do serviço de pagamento conforme o uso do Model Studio não são intercambiáveis. O uso de uma API key de outro plano não deduzirá créditos da sua cota do Token Plan (Team Edition).

Posso usar uma única assinatura em várias ferramentas?

Sim. É possível utilizar a mesma API key em todas as ferramentas de IA compatíveis, e todo o uso é deduzido da mesma cota compartilhada. Cada membro possui uma API key independente, que não deve ser compartilhada com outros membros.

Quais são as restrições de uso?

Este plano destina-se exclusivamente ao uso interativo em ferramentas compatíveis de codificação e agentes de IA. Não é permitido o uso em scripts automatizados ou backends de aplicações. Violações podem resultar na suspensão da assinatura ou revogação da API key.

Onde acesso o gerenciamento de equipe?

Contas Alibaba Cloud e usuários RAM podem fazer login no console do Token Plan. Em seguida, na página My Subscriptions, clique em Settings no cartão Team Edition para editar as informações da organização e clique em Assign seats na área Subscription details para gerenciar membros. Membros que ingressaram via SSO fazem login na plataforma de gerenciamento pelo endereço compartilhado pelo administrador. Para mais detalhes, consulte Acesso.

Como os membros obtêm uma API key?

O administrador cria uma conta de membro na plataforma de gerenciamento, atribui uma licença e gera uma API key para o membro. Os membros não podem gerar API keys por conta própria e devem contatar o administrador. Para mais detalhes, consulte Gerenciamento de equipe.

Qual a diferença entre revogar uma licença, alterar uma função e remover um membro da organização?

  • Revogar licença: Cancela os direitos de uso do membro e devolve a licença ao pool disponível. O membro perde o acesso à licença, mas permanece na organização.

  • Alterar função: Atualiza as permissões do membro (por exemplo, entre administrador e membro regular) sem afetar a atribuição de licença ou a participação na organização.

  • Remover da organização: Remove completamente o membro da equipe. A licença é recuperada automaticamente e o membro é excluído da lista de membros.

Por que a API key só pode ser visualizada uma vez e o que fazer se eu a perder?

Para evitar o uso indevido da API key entre equipes e prevenir confusões de faturamento, a chave é exibida apenas no momento da geração ou redefinição inicial — não é possível visualizá-la ou copiá-la posteriormente. Caso perca a API key, acesse a página Member Management e clique em Reset para gerar uma nova chave. A chave original torna-se inválida imediatamente.

Compra

Posso comprar vários planos simultaneamente?

Cada conta Alibaba Cloud pode ter apenas uma assinatura ativa. Dentro da mesma assinatura, é possível adquirir múltiplas licenças de cada tipo. Pacotes de cota compartilhada também podem ser acumulados.

Posso cancelar minha assinatura?

Sim, por licença. Na página My Subscriptions do console, clique em Cancel ao lado da licença desejada. Licenças com uso registrado não podem ser canceladas. Os reembolsos são devolvidos à conta de pagamento original dentro de 1 a 3 dias úteis. Para mais detalhes, consulte Gerenciamento de assinaturas.

Uma conta Alibaba Cloud inadimplente afeta o Token Plan (Team Edition)?

O Token Plan (Team Edition) é uma assinatura pré-paga. Desde que sua cota não esteja esgotada e a assinatura não tenha expirado, a inadimplência da conta Alibaba Cloud não afeta o seu uso.

Quais são as restrições para conversão de planos e reassinatura?

Conversão de planos: O Token Plan (Team Edition) e o Coding Plan são dois planos de assinatura independentes e não podem ser convertidos entre si. A mudança de um Token Plan (Team Edition) adquirido para um Coding Plan, ou vice-versa, não é suportada, mesmo mediante pagamento de diferença de preço. No entanto, é possível assinar ambos os planos simultaneamente na mesma conta.

Reassinatura após cancelamento: Se você cancelar e recomprar uma assinatura, a API key e a Base URL serão alteradas. Será necessário reconfigurar a nova API key dedicado em suas ferramentas para retomar o uso normal.

Faturamento e medição

Quais são as regras de dedução de créditos?

Os créditos consumidos por solicitação dependem dos tokens de entrada, tokens em cache e tokens de saída. Os créditos são deduzidos primeiramente da cota da licença e, em seguida, do pacote de cota compartilhada. Quando todas as cotas se esgotam, o serviço é suspenso até o próximo ciclo de faturamento ou até a aquisição de um pacote de cota compartilhada.

Como verifico meu uso?

Visualize os detalhes de uso do seu plano e do pacote de cota compartilhada na página do Token Plan (Team Edition). Administradores também podem visualizar registros detalhados de consumo de todos os membros na página Usage Analysis da plataforma de gerenciamento. Para mais detalhes, consulte Gerenciamento de equipe.

Como funciona a redefinição de uso?

A cota da licença é redefinida ao final de cada mês de assinatura. A cota não utilizada não é transferida para o mês seguinte. A cota do pacote compartilhado também é redefinida mensalmente.

O que acontece quando excedo minha cota?

Após o esgotamento da cota da licença, os créditos são deduzidos automaticamente do pacote de cota compartilhada. Quando todas as cotas se esgotam, o serviço é suspenso. Para restaurar o serviço:

  • Adquira um pacote de cota compartilhada.

  • Aguarde a redefinição automática da cota no próximo ciclo de faturamento.

Por que meus créditos não aumentaram após a renovação?

As cotas das licenças do Token Plan (Team Edition) são redefinidas automaticamente ao final de cada mês de assinatura. A renovação ou reassinatura apenas estende o período da assinatura ou reserva cota para o próximo ciclo de faturamento — ela não adiciona créditos ao ciclo atual. Se a cota do ciclo atual estiver esgotada e você precisar restaurar o serviço imediatamente, as únicas opções disponíveis são:

  • Adquirir um pacote de cota compartilhada.

  • Fazer upgrade para uma licença de nível superior.

  • Adquirir licenças adicionais.

Assinar cota para o próximo ciclo de faturamento não restaura o serviço imediatamente.

Segurança de dados

Como a segurança dos dados é garantida?

O Token Plan (Team Edition) não utiliza dados de conversas para treinar modelos. Os dados são criptografados em trânsito via HTTPS e isolados por meio de uma arquitetura multilocatária, proporcionando isolamento de dados de nível empresarial.