Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

FAQ

Conserte os problemas do plano Token rápido.

Posicionamento do produto

Qual a diferença entre a Edição Pessoal e a Edição da Equipe? Qual devo escolher?

Dimensão	Edição pessoal	Edição da Equipe
Use o caso.	Desenvolvedores individuais, codificação diária de IA.	Colaboração em equipe, assento centralizado e gerenciamento de uso
Mecanismo de quotas	Quota mensal, atualizada por mês de assinatura.	Quota total mensal
Gestão de equipe	Não apoiado.	Alocação de assentos, gestão de membros, análise de uso
Segurança de dados.	Dados usados para melhoria de serviços e otimização de modelos	Compromisso de não usar dados de conversa para treinamento de modelos.
- O que é isso?	Pode experimentar filas durante as horas de pico.	Isolamento multi-doente, sem filas.

Para desenvolvedores individuais ou uso diário de ferramentas de codificação de IA, a Edição Pessoal é suficiente. Para equipes que precisam de colaboração multi-membros, gerenciamento centralizado de assento e uso, e requisitos de segurança de dados mais elevados, escolha a edição da equipe.

Posso comprar a Edição Pessoal e a Edição da Equipe? As quotas são compartilhadas?

Sim. A mesma conta pode manter a Edição Pessoal e a Edição de Equipe simultaneamente. Cada um é cobrado independentemente e as quotas não são compartilhadas.

Comprar a edição da equipe vai entrar em conflito com uma edição pessoal existente?

Sem conflito. Ambos podem ser mantidos simultaneamente e são cobrados independentemente. O plano correspondente é automaticamente combinado com base na chave API.

Ele apoia o Cursor/Claude Code/Cline e outras ferramentas de terceiros?

Token Plan é compatível com OpenAI e protocolos antrópicos. Qualquer ferramenta que suporte URL base personalizada e API Key pode se conectar, incluindo Cursor, Claude Code, Qwen Code, Qoder, Qoder CN, Cline, Openclaw, Cherry Studio, Chatbox, e muito mais.

Recursos importantes.

** Página do plano Token**: Gerencie sua assinatura e uso de visualização na página do plano Token (https://home.qwencloud.com/analytics/token-plan/team)
Veja e reset as chaves da API na página de chaves da API (https://home.qwencloud.com/api-keys)
Veja a lista completa de modelos/token-plan/team/token-plan-team-overview#supported-models)
Instruções de configuração para o Código Cláudia./developer-guides/clients-and-developer-tools/claude-code), [OpenCode] (/developer-guides/clients-and-developer-tools/opencode), [Garra aberta] (/developer-guides/clients-and-developer-tools/openclaw), e mais

Comece aqui: 60 segundos de diagnóstico.

Se sua ferramenta não está funcionando e você vê erros como 401, 403, 404, invalid access token, invalid api-key, quota exceeded, ou falhas de conexão, verifique estes primeiro:

Deve ser o plano dedicado.sk-sp- formato), não um pagamento como você-vá sk-ws- chave
Base URL: Deve conter token-plan Não, não. dashscope-intl Ou coding
** Cabeçalho de autenticação: Authorization: Bearer Não, não. x-api-key
Verifique se sua assinatura está ativa e os créditos não estão esgotados.
Configuração atualizada: Reinicie a ferramenta após atualizar a chave da API ou URL base

Se ainda estiver bloqueado, continue com as perguntas abaixo.

Conexão e uso

Erros e soluções comuns.

Mensagem de erro	Possíveis causas.	Solução
Não há nenhuma chave API fornecida.	O pedido não incluiu a chave da API em nenhum dos dois`Authorization: Bearer`or`x-api-key` Cabeçalho.	Vá para o Página do plano Token, copie sua chave dedicada da API, e configure-a em sua ferramenta.
401 InvalidApiKey: API-chave inválida fornecida.	1. Você usou um QwenCloud Pagar-como-você-vai chave (`sk-ws-xxx`, or`sk-xxx`Para chaves criadas mais cedo) em vez do Token Plano chave dedicada. 2. Sua assinatura do Token Plan expirou. 3. A chave API está incompleta ou contém espaços.	1. Confirme que está usando a chave dedicada à API do plano Token. Certifique-se de que a chave seja copiada completamente sem espaço. 2. Verifique se a assinatura expirou. 3. Se o erro persistir, reset a chave API, então configure a nova chave.
400 Modelo não existe.	O nome do modelo não corresponde a nenhum modelo disponível.	Verifique o nome do modelo contra Modelos apoiados.E garantir que seja escrito exatamente como documentado.
Modelo 'xxx' não encontrado ou não suportado	O nome do modelo está mal escrito ou usa o caso errado.	Certifique-se de que o nome do modelo seja sensível e combine com a identificação do modelo listada em Modelos apoiados..
400 Parameter inválido: erro de url, por favor verifique url!	O caminho da URL da base não bate com o protocolo. Por exemplo, o caminho compatível com OpenAI é configurado no ponto final Antrópico, ou vice-versa.	Escolha o ponto final que combina com o protocolo que sua ferramenta usa:`/apps/anthropic`. OpenAI-compatível (Cursador, Qwen Code, e similar) termina com`/compatible-mode/v1`.
400 Parameter inválido: alcance de max_tokens deve ser [1, xxxx]	O`max_tokens`O valor na solicitação (ou o comprimento máximo de saída na configuração da ferramenta) excede o máximo de saída tokens suportados pelo modelo atual.	Preparar.`max_tokens`para um valor que não exceda o limite mostrado na mensagem de erro.
O parâmetro do orçamento deve ser um inteiro positivo e não maior que xxxxx	O comprimento de pensamento configurado na ferramenta (como`thinking_budget`or`budgetTokens`) excede o limite suportado pelo modelo atual.	Defina o comprimento de pensamento para um valor que não exceda o limite mostrado no erro, ou remova o parâmetro para modelos que não suportam o modo de pensamento.
Token de acesso inválido ou token expirado	Usou uma URL base que pertence a outro plano de faturamento.	Use o URL de base correto do Token Plan. OpenAI compatível:`https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`. Antrópico compatível:`https://token-plan.maas.qwencloudapi.com/apps/anthropic`.
Chave de API incorreta fornecida	Você usou o general. QwenCloud URL base (`maas.qwencloudapi.com`).	Use o URL de base correto do Token Plan. OpenAI compatível:`https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`. Antrópico compatível:`https://token-plan.maas.qwencloudapi.com/apps/anthropic`.
A distância de entrada deve ser de 1 , xxx]	Sua entrada (incluindo histórico de conversação e contexto de código) excede o comprimento máximo de contexto do modelo.	Comece uma nova sessão ou encurtar o contexto. Você também pode mudar para um modelo com uma janela de contexto maior.
Acesso 403 Negado. Sem compra.	O modelo que você chamou só está disponível na edição da equipe. Edição Pessoal não suporta.	Mude para um modelo apoiado pela Edição Pessoal, ou use a Edição de Equipe do Token Plan.
429 Pedidos API-Key limite de taxa excedido	Os pedidos eram muito densos em um curto período e desencadearam o limite de taxa do modelo.	Espere um minuto e tente novamente. Se isso ocorrer com frequência, reduza a frequência de solicitação e verifique se a chave da API não está sendo compartilhada com outros.
429 Throttling. Alocação Quota/ insuficiente	Este erro pode ser desencadeado por duas causas: Plano de quota esgotadaA cota de assento e o pacote de crédito estão esgotados. Limite de velocidade do modelo ativado. Mesmo quando a cota do plano é suficiente, esse erro ocorre quando os símbolos consumidos por segundo ou por minuto (TPS/TPM) excedem o limite de taxa do modelo. Limites de taxa são calculados no nível da conta, o uso combinado de todos os usuários, espaços de trabalho e chaves API sob a conta conta conta em conjunto. Mesmo que o total por minuto fique dentro do limite, uma pequena explosão de pedidos ainda pode atirá-lo.	Quota esgotada Espere a cota repor no próximo ciclo de faturamento, compre um pacote de crédito, ou compre lugares adicionais para adicionar mais créditos. Limite de velocidade desencadeado. Espere cerca de um minuto e tente novamente, e alie sua taxa de solicitação (por exemplo, use até mesmo agendamento, retrocesso exponencial, ou uma fila de solicitação) para evitar picos instantâneos.
Erro de conexão	O domínio URL base está mal escrito, ou você tem um problema de conexão de rede.	Verifique a grafia do domínio URL base e sua conexão de rede.

Geração de imagens

Posso usar modelos de imagem em ferramentas de codificação?

Modelos de geração de imagens usam APIs separadas e não podem ser chamados diretamente através da URL base do modelo de texto. Você deve integrá-los através da habilidade ou mecanismo de extensão de sua ferramenta. Para as etapas de configuração, veja a seção de integração de modelos de geração de imagens no guia de configuração de cada ferramenta.

Como eu uso modelos de geração de imagens em ferramentas de codificação?

A maioria das ferramentas de codificação (como Claude Code, Cursor e Cline) suportam mecanismos de extensão como Skills, Slash Commands ou servidores MCP. Você pode usar esses mecanismos para chamar modelos de geração de imagens dentro do seu fluxo de trabalho de codificação. Para instruções passo a passo, veja [Integrar modelos de geração multimodal] (/token-plan/best-practices/integrate-multimodal-gen).

Erros comuns e correções

Que chave de API e URL base devo usar?

Use um plano de Token dedicado à chave e um plano de Token base URL**:

[Plano de página] (https://home.qwencloud.com/analytics/token-plan/team)
OpenAI compatível: https://token-plan.maas.qwencloudapi.com/compatible-mode/v1
Antrópico compatível: https://token-plan.maas.qwencloudapi.com/apps/anthropic

Pagar como você vai dashscope-intl URLs não funcionam com chaves do Token Plan.

Tenho 401 ou 403. Minha chave API é inválida?

Se você ver 401 invalid access token, InvalidApiKey, ou 403 invalid api-keyO problema é um tipo de chave errado, uma assinatura expirada, uma chave mal formada, ou uma chave e URL descompassos.

Verifique estes pontos:

Confirme que a chave é o seu plano dedicado.
Recopie a chave para remover espaços ocultos ou quebras de linha
Confirme que sua assinatura está ativa na página do Token Plan.https://home.qwencloud.com/analytics/token-plan/team)
Certifique-se que o URL base contenha token-plan

Na maioria dos casos:

401 invalid access token significa tipo de chave errada, assinatura expirada, ou chave mal formada
403 invalid api-key significa que você está usando uma chave do plano Token com uma URL do plano não Token
Incorrect API key provided significa que você está usando uma chave do plano Token com o general dashscope-intl URL

Por que eu tenho 404 ou erros de conexão?

Se você conseguir 404 status code (no body), endpoint não encontrado, ou erros de conexão, o caminho URL base geralmente é errado para sua ferramenta.

Use o caminho correto para o seu protocolo:

Ferramentas compatíveis com antrópicos usam /apps/anthropic
Ferramentas compatíveis com o OpenAI usam /compatible-mode/v1

Também verifique se o domínio é exatamente token-plan.maas.qwencloudapi.com.

Por que meu modelo não é apoiado?

Se você conseguir model 'xxx' is not supported Ou model 'xxx' not foundA identificação do modelo é incorreta, sensível a casos ou copiada com espaços extras.

Verifique estes pontos:

Use o nome exato do modelo de [modelos suportados] (/token-plan/team/token-plan-team-overview#supported-models)
Remova qualquer espaço que esteja à frente ou ao longo
Verifique a capitalização exatamente como documentado.

Como lidar com os limites de comprimento de entrada?

Se você conseguir 400 InvalidParameter: Range of input length should be [1, xxx] Seu contexto ou pedido ultrapassa os limites do modelo.

Tente essas correções:

Criar uma nova sessão
Mude para um modelo com uma janela de contexto maior.
Em sua ferramenta, configure limites de extensão de contexto se disponível.

O que devo fazer se eu ver dados falhando?

Se você ver data_inspection_failed, consulte [Problemas de erro de inspeção de dados] (/api-reference/preparation/error-messages#400-datainspectionfailed-data-inspection-failed).

Características do produto

Posso misturar Token Plan e as chaves pagas?

Não. As chaves da API e URLs base para o plano Token e QwenCloud O pagamento como você vai não é intercambiável. Não misture. Usar uma chave incorreta não deduzirá créditos da cota do Token Plan.

Posso usar uma assinatura em várias ferramentas?

Sim. Você pode usar a mesma chave API em todas as ferramentas de IA compatíveis, e todo uso é feito da mesma cota.

Há restrições de uso?

O serviço é para uso interativo em programação de IA compatível e ferramentas de agente apenas. Não pode ser usado para scripts automatizados ou backends de aplicativos. Violar esses termos pode resultar em suspensão da assinatura ou revogação da chave da API.

Onde posso acessar a gestão de equipe?

Na [Assinatura de Gestão] (https://home.qwencloud.com/analytics/token-plan/team Página, clique em adicionar membros e atribuir lugares para ir para o [Configurar Membros & Assentos] (https://home.qwencloud.com/analytics/token-plan/team-config Página, onde você pode gerenciar a configuração do SSO, adicionar membros, e atribuir ou recuperar assentos. Você também pode acessar as características de gerenciamento de equipe completa através do autônomo [Console Gestão] (https://tokenplan-enterprise.qwencloud.com). Veja [Gestão de equipe] (/token-plan/team/team-management) para detalhes.

A chave API da edição da equipe pode ser usada com a edição pessoal?

Não. A Edição Pessoal e a Edição de Equipe geram chaves independentes que não podem ser usadas de forma intercambiável. O sistema identifica automaticamente o plano correspondente baseado na chave da API.

O que são ferramentas Harness?

Ferramentas de Harness são recursos de modelos, incluindo busca na web, busca de texto para imagem, busca de imagem para imagem, raspagem de web, intérprete de código e muito mais. A edição da equipe apoia ferramentas Harness, com créditos consumidos por chamada bem sucedida. As ferramentas de segurança estão disponíveis em qualquer modelo que suporte a API Responses.

Como está a performance durante o horário de pico?

A edição da equipe é construída sobre uma arquitetura de isolamento multi-doentes, sem filas durante períodos de chamadas de pico.

Os modelos são completos ou quantizados?

Todos os modelos suportados no Token Plan são versões completas, sem quantização.

Como faço para repor ou gerenciar minha chave de API?

Use o botão de Reiniciar na página de chaves API (https://home.qwencloud.com/api-keys) para reiniciar sua chave.

Tenha em mente essas regras:

Depois de reset, atualize a chave em todas as ferramentas.
Se você voltar a assinar após a expiração, a chave muda.
O plano Token apoia uma chave por assinatura.

Qual é a diferença entre revogar um assento, mudar um papel e remover um membro da organização?

Cancela os direitos de uso do membro e libera o assento de volta para a piscina disponível. O membro perde o acesso ao assento, mas permanece na organização.
Mudar de papel: atualiza as permissões do membro (por exemplo, entre administrador e membro regular) sem afetar a atribuição de assento ou a associação da organização.
Remove completamente o membro da equipe. O assento é automaticamente recuperado e o membro é removido da lista de membros.

Por que não há lugares disponíveis depois da compra?

As cadeiras não são automaticamente atribuídas após a compra. Um administrador deve atribuí-los manualmente. Vá para o [Configurar Membros & Assentos] (https://home.qwencloud.com/analytics/token-plan/team-config) página para ver os assentos restantes, verificar o status de cada membro, e atribuir lugares. Veja [Gestão de equipe] (/token-plan/team/team-management) para detalhes.

Por que a chave API só pode ser vista uma vez, e o que devo fazer se eu perdê-la?

Para evitar o mau uso da chave API entre as equipes e evitar confusão de faturamento, a chave API é exibida apenas quando é gerada ou reiniciada pela primeira vez - não pode ser visualizada ou copiada novamente depois. Se perder a chave da API, vá para a página **Gestão de membros e clique em Reset para gerar uma nova chave. A chave original fica inválida imediatamente.

Quais são as restrições para reassinatura?

Se cancelar e recuperar uma assinatura, a chave da API e a URL base mudarão. Você deve reconfigurar a nova chave dedicada da API em suas ferramentas para retomar o uso normal.

Faturação e cota

Por que ainda sou cobrado depois de assinar?

Se ainda vê as despesas de pagamento depois de assinar o Token Plan, é geralmente uma das seguintes:

Sua ferramenta está usando uma chave API paga como você vaisk-ws- formato) e uma URL base sem token-plan. Use seu plano Token chave dedicada e garantir que a URL base contém token-plan.
Se sua ferramenta tem credenciais gerais e do Token Plan configuradas, pode encaminhar pedidos através das credenciais gerais. Remova a configuração geral da API e mantenha apenas credenciais do plano Token.
Depois de atualizar as credenciais, limpe o cache da ferramenta e reinicie-o para garantir que use a nova configuração.

Use a página do plano de dados (https://home.qwencloud.com/analytics/token-plan/team) para verificar o uso. Se necessário, reponha sua chave na página de chaves da API (https://home.qwencloud.com/api-keys).

Como os créditos são deduzidos?

O consumo de crédito é calculado com base nas fichas de entrada, cache e saída em cada pedido. O sistema primeiro deduz créditos da sua cota de assento. Após a cota de assento esgotada, os créditos são deduzidos do pacote de crédito. Se todos os créditos forem usados, o serviço será suspenso até o próximo ciclo de faturamento ou até que você compre um pacote de crédito para adicionar mais créditos.

O que acontece quando minha cota acabar?

Quando a cota de assento estiver esgotada, o sistema começa automaticamente a deduzir do pacote de crédito. Se ficar sem créditos, o serviço será suspenso. Você pode retomar o serviço de uma das seguintes maneiras:

Compre um pacote de crédito para adicionar mais créditos.
Espere sua cota ser reiniciada automaticamente no início do próximo ciclo de faturamento.

Não há nenhuma retrocessão automática para pagar quando os créditos estão esgotados.

Como posso limitar o consumo de um só membro do Credit Pack?

Na página Membros, proprietários e administradores podem clicar em Set na cota ** do pacote de crédito** coluna do membro alvo para permitir um limite de cotas. Veja [Gestão de equipe] (/token-plan/team/team-management).

Quando meus créditos são reiniciados?

A cota de assentos repõe no início de cada novo mês de assinatura. Renovar ou reassistrar o ciclo médio não adiciona ou redefiniu créditos imediatamente. A quota renovada só fica disponível quando o próximo ciclo de faturamento começa. Créditos não usados não passam para o próximo mês. Da mesma forma, créditos não utilizados no pacote de crédito expiram no final de cada ciclo de faturamento.

Acabei de renovar meu plano, mas meus créditos ainda estão zero. Por quê?

Créditos repostos apenas no início de cada mês de assinatura, não no momento da renovação. Se renovar o ciclo médio, sua renovação aumenta a assinatura, mas a nova cota não produz efeito até que o próximo ciclo de faturamento comece. Se sua quota atual de ciclo está esgotada e você precisa restaurar o serviço imediatamente, você só pode fazer isso através das seguintes opções:

Compre um pacote de crédito.
Atualize para um assento mais alto.
Comprem lugares adicionais.

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

Como posso ver meu uso?

Veja a página do Token Plan (https://home.qwencloud.com/analytics/token-plan/team) para uso geral, incluindo cota de assento e detalhes do pacote de crédito.

Posso melhorar um assento para um nível mais alto?

Sim. Na lista de assentos dos detalhes de uso na [Gestão de Assinatura] (https://home.qwencloud.com/analytics/token-plan/team Página, clique em "Upgrade" em qualquer assento ativo para movê-lo para um nível mais alto. Você paga a diferença de preço para o período de assinatura restante.

Posso comprar várias assinaturas?

Cada um QwenCloud A conta está limitada a uma assinatura do plano Token. Na mesma assinatura, você pode comprar vários lugares de cada tipo e adicionar mais lugares a qualquer momento via Adicionar assentos.

Há um limite de assento para a assinatura da edição da equipe?

O limite de assento para uma assinatura da Equipe de Token Plan é de 1.000.

Posso cancelar um assento?

Sim, por assento. Na lista de assentos na [Assinatura de Gestão] (https://home.qwencloud.com/analytics/token-plan/team Página, clique em Dessubscrever no assento você want Cancelar. Assentos com uso não podem ser cancelados. Reembolsos são devolvidos ao método de pagamento original.

Um pagamento atrasado afeta meu plano?

O Token Plan é um produto pré-pago. Enquanto os créditos do seu plano não estiverem esgotados e a assinatura ainda for válida, um pagamento atrasado em seu QwenCloud A conta não afetará seu uso do serviço.

Não. As chaves da API do plano Token são para uso pessoal do assinante. Exposição pública ou compartilhamento de contas pode resultar em suspensão automática de chave.

Posso mudar a duração da assinatura quando for renovada?

Não. Renovação só suporta renovação com a duração original da assinatura. Se precisar de uma assinatura diferente, pode reaver após a assinatura atual expirar.

Como os preços promocionais funcionam?

Preços promocionais se aplicam a assinaturas mensais de novas compras, renovações e auto-renovações. Ao adicionar assentos ou atualizar assentos no meio do ciclo, a taxa é pro rated por dias restantes, e a taxa real é a menor do valor pro rated e do preço promocional. Por exemplo: se o assento padrão tem um preço original de $30 (≈ R$ 150,609*)/mês e um preço promocional de $20 (≈ R$ 100,406*)Se a taxa pro rated para os dias restantes for $15 (≈ R$ 75,3045*) (mais baixo que o preço promocional), então $15 (≈ R$ 75,3045*) é cobrado, se a taxa é $25 (≈ R$ 125,5075*) (preço mais alto que o promocional), então $20 (≈ R$ 100,406*) Está carregada.

Segurança de dados.

Como meus dados estão protegidos?

O Token Plan não usa dados de conversa para treinamento de modelos.

FAQ