Skip to main content

Perguntas frequentes sobre o Token Plan

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?

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ívelConcorrência recomendada
Lite1-2 Agents
Essential2-3 Agents
Standard3-4 Agents
Pro6-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

SintomaCausaTratamento
429 insufficient_quotaCota do plano ou cota do pacote de uso esgotadaAguarde a redefinição, faça upgrade ou compre um pacote de uso ou pacote de uso compartilhado
429 Requests rate limit exceededSolicitações muito concentradas em um curto períodoAguarde cerca de 1 minuto antes de tentar novamente e reduza a frequência das solicitações
Limite de concorrênciaO número de Agents em execução simultânea excede o valor recomendado para o nívelReduza o número de Agents em execução simultânea ou faça upgrade para um nível superior
401, 403, 404Erro de configuração de API Key, Base URL ou modeloVerifique o prefixo da chave, a Base URL e o ID do modelo

Ordem de solução de problemas

  1. Confirme se a API Key começa com sk-sp- e se é usada com a Base URL do Token Plan.
  2. 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.
  3. Verifique se a cota se esgotou nas páginas My Subscriptions e Usage Analysis do console.
  4. Verifique se o erro é insufficient_quota, Requests rate limit exceeded ou um erro de autenticação.

Erros comuns

Mensagem de erroPossível causaSolução
401 InvalidApiKey: No API-key provided.Nenhuma API Key incluída no cabeçalho da solicitaçãoGere 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 incompletaConfirme 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 suportadosConfirme 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 supportedNome do modelo digitado incorretamente ou fora da lista de modelos suportadosConfirme 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 EditionMude para um modelo suportado pelo Personal Edition ou use o Token Plan Team Edition
401 invalid access token or token expiredUso incorreto da Base URL do Coding Plan ou de outro modo de faturamentoUse a Base URL do Token Plan
401 Incorrect API key providedUso 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 modeloInicie 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 textoMude 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ídeosModelos de geração de imagens e vídeos usam endpoints separados e não podem ser chamados diretamente pela Base URL do modelo de textoIntegre por meio do mecanismo de extensão Skill, Slash Command ou Agent da ferramenta
429 Requests rate limit exceededSolicitações muito concentradas em um curto período; vários Agents em paralelo também podem acionar o limite de concorrênciaAguarde 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 esgotadaCompre 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 GatewayErro intermitente no lado do servidorTente 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.
Para as Base URLs, consulte Início rápido do Personal Edition · Etapa 2 e Início rápido do Team Edition · Etapa 2. Para os modelos suportados, consulte Personal Edition e Team Edition.

Dúvidas sobre uso

Para saber como a cota é calculada, quando é redefinida, o que fazer quando ela se esgota, onde visualizá-la e por que o consumo está anormal, consulte: