Respostas para perguntas comuns sobre edições, compras e assinaturas, cancelamentos e reembolsos, limites de uso e integração do Token Plan.
Produto e edições
Qual é a diferença entre o Personal Edition e o Team Edition?
O Personal Edition destina-se a desenvolvedores individuais e é assinado por nível de plano. O Team Edition destina-se a equipes e empresas e é assinado por seat, com gerenciamento de seats, análise de uso por membro e integração SSO. As duas edições também diferem no mecanismo de cota, na segurança de dados e no desempenho em horários de pico. Para uma comparação completa, consulte Assinatura e benefícios do Personal Edition e Assinatura e benefícios do Team Edition.
Posso comprar o Personal Edition e o Team Edition? As cotas são calculadas separadamente ou compartilhadas?
Sim. A mesma conta Alibaba Cloud pode manter o Personal Edition e o Team Edition ao mesmo tempo. Cada uma tem faturamento independente e as cotas não são compartilhadas.
Posso fazer upgrade ou converter o Personal Edition em um seat do Team Edition?
Não. O Personal Edition e o Team Edition são produtos separados, sem cota compartilhada, e o Personal Edition não pode ser atualizado nem convertido diretamente em um seat do Team Edition. Para usar o Team Edition, assine-o separadamente. Atualmente, o Personal Edition não oferece suporte a cancelamento de assinatura; você pode interromper a renovação quando a assinatura expirar.
Posso usar uma API Key do Team Edition no Personal Edition?
Não. O Personal Edition e o Team Edition geram API Keys independentes que não podem ser usadas de forma intercambiável. O sistema identifica automaticamente o plano correspondente com base na API Key.
Se eu já tenho o Personal Edition, comprar o Team Edition causará conflito?
Não. Ambos podem ser mantidos ao mesmo tempo e são faturados de forma independente. O plano correspondente é associado automaticamente com base na API Key.
Quais modelos o Token Plan suporta?
O Token Plan oferece suporte a modelos Qwen, Wan, DeepSeek, Moonshot AI, Zhipu AI, MiniMax e HappyHorse. A variedade de modelos difere entre o Personal Edition e o Team Edition. Para a lista completa, consulte os modelos suportados pelo Personal Edition e pelo Team Edition.
O Token Plan oferece suporte a ferramentas de terceiros como Cursor, Claude Code e Cline?
Sim. O Token Plan é compatível com os protocolos OpenAI e Anthropic. Qualquer ferramenta compatível com uma Base URL e uma API Key personalizadas pode se conectar. Para configuração, consulte Início rápido.
O que são ferramentas integradas do modelo?
As ferramentas integradas do modelo são capacidades fornecidas pelo modelo, incluindo busca na web, busca de texto para imagem, busca reversa de imagens, web scraping e interpretador de código. Elas são acionadas automaticamente quando você chama um modelo por meio da Responses API e são deduzidas dos Credits. Tanto o Personal Edition quanto o Team Edition oferecem suporte a elas. Para detalhes, consulte Ferramentas integradas do modelo.
O Token Plan oferece cota de teste gratuita ou Tokens gratuitos?
O próprio Token Plan não oferece cota de teste ou Tokens gratuitos. O Model Studio fornece uma cota gratuita separada para alguns modelos; você pode verificar no console a lista de modelos com cota gratuita disponível.
Compra e assinatura
Usuários RAM podem usar o Token Plan?
Sim. Os usuários RAM precisam das permissões do Token Plan e das permissões do Billing Management concedidas pela conta primária: a política do Billing Management é AliyunBSSReadOnlyAccess para o Personal Edition e AliyunBSSFullAccess para o Team Edition. Para as etapas completas de autorização e uma comparação de permissões, consulte Permissões e política de uso · Autorização de usuário RAM.
A autorização RAM e a atribuição de seat são dois conceitos independentes: a autorização RAM determina quem pode gerenciar a assinatura; a atribuição de seat determina quem pode usar os modelos. Os membros do Team Edition ainda precisam receber um seat no gerenciamento de equipes antes de obterem uma API Key.
Posso fazer upgrade? Como a cota é calculada após o upgrade?
O upgrade de um nível inferior para um nível superior é suportado. Os upgrades não redefinem o ciclo de assinatura atual: você paga a diferença de preço proporcional aos dias restantes, e os Credits adicionais para o ciclo atual são calculados proporcionalmente com base na diferença de cota mensal entre o novo nível e o anterior. A cota mensal do novo nível se aplica a partir do próximo mês de assinatura.
Para a fórmula e um exemplo, consulte Uso e cota · Cálculo da cota no upgrade.
Posso fazer downgrade?
Não. Para mudar para um nível ou tipo de seat inferior, faça uma nova compra ou reassine após o vencimento da assinatura. Para detalhes, consulte Personal Edition · Outros e Team Edition · Observações importantes.
Como desativar a renovação automática?
- Personal Edition: entre na página Token Plan do console do Model Studio e desative a renovação automática no gerenciamento de assinaturas.
- Team Edition: entre em Billing Management > Renewal Management, localize o pedido do Token Plan Team Edition e desative a renovação automática.
Preciso reconfigurar a API Key após a renovação?
Não. A renovação, a nova compra após o vencimento da assinatura e a nova compra após o cancelamento da assinatura de um seat não alteram a API Key de um seat atribuído. A API Key fica temporariamente indisponível enquanto a assinatura estiver vencida ou cancelada e volta a ficar utilizável após a conclusão bem-sucedida da renovação ou da nova compra.
Como visualizar a data de início e os dias restantes de um plano?
- Data de início: entre no console do Model Studio e acesse a página Token Plan.
- Dias restantes: os dias restantes exibidos no console são arredondados para baixo em períodos completos de 24 horas. Por exemplo, 22 dias e 20 horas restantes são exibidos como 22 dias; a validade real é baseada no horário de término.
O Token Plan oferece suporte a vouchers para estudantes?
Não. Os vouchers para estudantes se aplicam apenas aos produtos especificados na página da promoção e não podem ser usados para comprar o Token Plan.
Cancelamento e reembolsos
Posso cancelar a assinatura do Personal Edition?
Atualmente, o Personal Edition não oferece suporte a cancelamento de assinatura. Você pode interromper a renovação quando a assinatura expirar.
Posso cancelar a assinatura de seats do Team Edition?
Sim, você pode cancelar por seat. Seats que já tenham consumo não podem ter a assinatura cancelada. Os reembolsos são devolvidos à conta de pagamento original em um prazo estimado de 1 a 3 dias úteis. Para a operação, consulte Team Edition · Cancelar assinatura de seats.
Limites de uso
O que significa "a automação de API em produção é proibida"?
O Token Plan Personal Edition destina-se ao desenvolvimento interativo individual por meio de ferramentas oficialmente designadas (como Cursor, Claude Code e Windsurf). Não é permitido usar a API Key para serviços automatizados em produção, scripts em lote ou tarefas agendadas em segundo plano.
Os membros da equipe podem visualizar o uso da equipe?
Não. Os membros da equipe não podem visualizar a assinatura da equipe, a cota do seat ou o saldo do pacote de uso compartilhado; somente o proprietário ou administrador pode visualizar essas informações. Para detalhes, consulte Gerenciamento de equipes · Funções e permissões.
Os dados são usados para treinar modelos?
O uso de dados do Personal Edition é regido pelo contrato de serviço; o Team Edition não usa dados de conversa para treinamento de modelos. Para detalhes, consulte Permissões e política de uso · Política de uso de dados.
Várias pessoas podem compartilhar uma conta?
Não. O Token Plan Personal Edition é limitado a um único usuário; não é permitido compartilhar a mesma conta ou API Key entre várias pessoas. Para colaboração com vários usuários, use o Token Plan Team Edition.
Posso usar a mesma API Key em vários dispositivos?
Sim. A mesma API Key pode ser configurada em vários dispositivos seus, mas apenas para uso próprio. A redefinição da API Key invalida imediatamente a chave antiga, e você deve atualizar a nova chave em todos os dispositivos. Redefina a chave apenas se ela for vazada.
Quantos Agents simultâneos são suportados?
A concorrência do Personal Edition depende do nível do plano:
| Nível | Concorrência recomendada |
|---|---|
| Lite | 1-2 Agents |
| Essential | 2-3 Agents |
| Standard | 3-4 Agents |
| Pro | 6-8 Agents |
As respostas ficarão mais lentas durante os horários de pico?
O Personal Edition pode entrar em fila durante os horários de pico. Para um throughput mais estável, faça upgrade para um nível superior ou use o Team Edition. O Team Edition usa uma arquitetura de isolamento multilocatário e não entra em fila durante os horários de pico.
Qual é o limite de taxa (TPM/RPM)? Ele pode ser aumentado?
Os limites de taxa são ajustados dinamicamente com base na carga geral para manter o serviço estável. Os limites de taxa do plano não podem ser aumentados. Se você for limitado pela taxa, reduza o contexto, diminua a complexidade da tarefa e aguarde cerca de 1 minuto antes de tentar novamente.
O Team Edition tem limites de concorrência?
Sim. A plataforma ajusta dinamicamente o limite de concorrência com base na carga geral de recursos. Se você atingir o limite de concorrência, aguarde um momento e tente novamente.
Integração e erros
Distinguir quatro cenários primeiro
| Sintoma | Causa | Tratamento |
|---|---|---|
| 429 insufficient_quota | Cota do plano ou cota do pacote de uso esgotada | Aguarde a redefinição, faça upgrade ou compre um pacote de uso ou pacote de uso compartilhado |
| 429 Requests rate limit exceeded | Solicitações muito concentradas em um curto período | Aguarde cerca de 1 minuto antes de tentar novamente e reduza a frequência das solicitações |
| Limite de concorrência | O número de Agents em execução simultânea excede o valor recomendado para o nível | Reduza o número de Agents em execução simultânea ou faça upgrade para um nível superior |
| 401, 403, 404 | Erro de configuração de API Key, Base URL ou modelo | Verifique o prefixo da chave, a Base URL e o ID do modelo |
Ordem de solução de problemas
- Confirme se a API Key começa com
sk-sp-e se é usada com a Base URL do Token Plan. - Confirme se o ID do modelo está entre os modelos suportados pelo Personal Edition e pelo Team Edition e se ele se aplica à edição atual.
- Verifique se a cota se esgotou nas páginas My Subscriptions e Usage Analysis do console.
- Verifique se o erro é
insufficient_quota,Requests rate limit exceededou um erro de autenticação.
Erros comuns
| Mensagem de erro | Possível causa | Solução |
|---|---|---|
401 InvalidApiKey: No API-key provided. | Nenhuma API Key incluída no cabeçalho da solicitação | Gere uma API Key e configure-a na ferramenta |
401 InvalidApiKey: Invalid API-key provided. | Uso incorreto de uma API Key de pagamento conforme o uso ou de uma chave do Coding Plan; assinatura vencida; chave copiada de forma incompleta | Confirme se você está usando a API Key do Token Plan e garanta que ela esteja completa e sem espaços |
404 model_not_found: Model not exist. | Nome do modelo digitado incorretamente ou fora da lista de modelos suportados | Confirme se o nome do modelo diferencia maiúsculas de minúsculas e corresponde a um ID de modelo suportado pelo plano |
404 model 'xxx' not found or not supported | Nome do modelo digitado incorretamente ou fora da lista de modelos suportados | Confirme se o nome do modelo diferencia maiúsculas de minúsculas e corresponde a um ID de modelo suportado pelo plano |
403 AccessDenied.Unpurchased: Access to model denied. | O modelo é suportado apenas pelo Team Edition, não pelo Personal Edition | Mude para um modelo suportado pelo Personal Edition ou use o Token Plan Team Edition |
401 invalid access token or token expired | Uso incorreto da Base URL do Coding Plan ou de outro modo de faturamento | Use a Base URL do Token Plan |
401 Incorrect API key provided | Uso incorreto da Base URL geral do Model Studio (dashscope-intl.aliyuncs.com) | Use a Base URL do Token Plan |
400 Range of input length should be [1, xxx] | O conteúdo de entrada excede o comprimento máximo de contexto do modelo | Inicie uma nova sessão para limpar o histórico ou use o comando de compactação de contexto da ferramenta |
400 invalid_parameter_error: Unexpected item type in content. | Conteúdo não textual, como uma imagem, foi passado para um modelo apenas de texto | Mude para um modelo que ofereça suporte à modalidade ou confirme se o conteúdo da solicitação corresponde às capacidades do modelo |
Erro 400 ao chamar modelos de geração de imagens ou vídeos | Modelos de geração de imagens e vídeos usam endpoints separados e não podem ser chamados diretamente pela Base URL do modelo de texto | Integre por meio do mecanismo de extensão Skill, Slash Command ou Agent da ferramenta |
429 Requests rate limit exceeded | Solicitações muito concentradas em um curto período; vários Agents em paralelo também podem acionar o limite de concorrência | Aguarde cerca de 1 minuto antes de tentar novamente e reduza a frequência e a concorrência das solicitações |
429 insufficient_quota: Your token-plan quota has been exhausted. | Cota do plano ou cota do pacote de uso esgotada | Compre um pacote de uso, faça upgrade do plano ou aguarde a redefinição da cota no próximo mês de assinatura |
502 Bad Gateway | Erro intermitente no lado do servidor | Tente novamente mais tarde |
Cota esgotada
Uma resposta 429 insufficient_quota indica que a cota se esgotou. Para a ordem de dedução e as opções de recuperação, consulte Uso e cota · Esgotamento e recuperação de cota.
Limitação de taxa e concorrência
Uma resposta 429 Requests rate limit exceeded indica limitação de taxa, não esgotamento de cota. Os limites de taxa são ajustados dinamicamente com base na carga geral, e os limites de taxa do plano não podem ser aumentados. Aguarde cerca de 1 minuto antes de tentar novamente, reduza o contexto, diminua a concorrência ou reduza a frequência das solicitações. O Team Edition também tem limites de concorrência.
Autenticação e configuração
As API Keys e Base URLs do Token Plan, do Coding Plan e do pagamento conforme o uso são isoladas e devem ser usadas em pares correspondentes:
- Token Plan: API Key que começa com
sk-sp-+ Base URL do Token Plan. - Coding Plan: API Key do Coding Plan +
https://coding-intl.dashscope.aliyuncs.com/v1. - Pagamento conforme o uso: API Key do Model Studio (que começa com
sk-) +https://dashscope-intl.aliyuncs.com/compatible-mode/v1.