Todos os produtos
Search
Central de documentação

Alibaba Cloud Model Studio:FAQ

Última atualização: Sep 04, 2026

Problemas de conexão e configuração

Erros comuns e soluções

Mensagem de erro

Possível causa

Solução

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

A entrada excede o comprimento permitido.

  1. Crie uma nova sessão para resolver o erro.

  2. Para evitar esse erro, simplifique sua entrada ou mude para um modelo com uma janela de contexto maior. Para obter detalhes, consulte {{XREF_0}}

  3. Se você usar o OpenCode, configure limit para limitar a janela de contexto. Para mais informações, consulte {{XREF_1}}.

401 invalid access token or token expired

  1. Você usou uma chave de API geral do Model Studio (que começa com sk-xxx) em vez da chave de API específica do seu plano.

  2. Sua assinatura do Coding Plan expirou.

  3. A chave de API está incompleta, contém espaços extras ou está malformada.

  1. {{XREF_2}}.

  2. Acesse a página do Coding Plan para verificar se sua assinatura expirou.

  3. Acesse a página do Coding Plan para copiar sua chave de API novamente. Certifique-se de que ela esteja completa e sem espaços extras.

  4. Se o erro persistir, redefina sua chave de API na página do Coding Plan e atualize sua configuração com a nova chave.

model 'xxx' is not supported

  1. O modelo não é suportado pelo Coding Plan.

  2. O nome do modelo está incorreto, com maiúsculas/minúsculas erradas ou contém espaços extras.

Use um ID de modelo suportado por {{XREF_3}}. Os IDs de modelo diferenciam maiúsculas de minúsculas e não devem conter espaços à esquerda ou à direita.

403 invalid api-key

Você está usando a URL base geral do Model Studio em vez da URL base específica do plano.

Endpoint compatível com Anthropic: https://coding -intl .dashscope.aliyuncs.com/apps/anthropic

Endpoint compatível com OpenAI: https://coding -intl .dashscope.aliyuncs.com/v1

404 status code (no body)

O caminho da URL base está incorreto. Por exemplo, você definiu incorretamente a URL base como https://coding.dashscope.aliyuncs.com/v1 no Claude Code. A URL correta é https://coding.dashscope.aliyuncs.com/apps/anthropic.

Endpoint compatível com Anthropic: https://coding -intl .dashscope.aliyuncs.com/apps/anthropic

Endpoint compatível com OpenAI: https://coding -intl .dashscope.aliyuncs.com/v1

Connection error

A URL base está incorreta ou há um problema de rede.

Verifique a ortografia da URL base e sua conexão de rede.

Connection closed mid-response (geralmente acompanhado por API error · Retrying in 0s · attempt x/10)

A resposta em streaming foi interrompida durante a transferência e não retornou completamente. Isso geralmente ocorre devido à instabilidade de rede ou a um proxy local instável (VPN/HTTP Proxy) que encerra a conexão persistente com coding -intl .dashscope.aliyuncs.com.

  1. O cliente geralmente tenta novamente de forma automática (tentativa x/10) e, na maioria dos casos, se recupera após a nova tentativa.

  2. Se ocorrer com frequência, verifique a estabilidade da sua rede local e desative ou solucione problemas de qualquer proxy local (VPN/HTTP Proxy) para garantir acesso estável a coding -intl .dashscope.aliyuncs.com.

  3. Se o problema persistir, inicie uma nova sessão ou tente novamente mais tarde.

hour allocated quota exceeded

A cota de solicitações de 5 horas foi esgotada.

Aguarde 5 horas para que a cota seja redefinida automaticamente.

week allocated quota exceeded

A cota de solicitações semanal foi esgotada.

A cota é redefinida às 00:00:00 (UTC+8) de segunda-feira.

month allocated quota exceeded

A cota de solicitações mensal foi esgotada.

A cota é redefinida às 00:00:00 (UTC+8) no dia correspondente do seu próximo mês de assinatura.

concurrency allocated quota exceeded

O número de solicitações simultâneas excedeu o limite alocado dinamicamente.

Aguarde um momento e tente novamente. A plataforma ajusta esse limite com base na carga de recursos, portanto, esse erro é mais provável durante horários de pico.

429 usage allocated quota exceeded

As solicitações foram enviadas com muita frequência em um curto período, acionando o limite de taxa de chamadas do modelo.

Aguarde um minuto e tente novamente. Se esse erro ocorrer com frequência, reduza a frequência das suas solicitações e verifique se sua chave de API não está sendo compartilhada com outras pessoas.

Claude Code: Mensagem "Switched to native installer"

Isso não afeta o uso normal do Claude Code. Execute claude install no terminal para migrar o Claude Code para a instalação nativa oficial e siga o comando retornado no terminal para concluir a migração da configuração.

Claude Code: Erro "Unable to connect"

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country. Check supported
countries at https://anthropic.com/supported-countries

Causa: Na primeira inicialização, o Claude Code tenta se conectar a api.anthropic.com para autenticação inicial. Essa conexão falha porque o Claude Code não está disponível em alguns países e regiões.

Solução:

  1. Adicione "hasCompletedOnboarding": true como um campo de nível superior em ~/.claude.json.

    Para uma solução automatizada, use Qwen Code . Inicie o Qwen Code executando qwen no terminal e envie a seguinte mensagem de chat: Please add "hasCompletedOnboarding": true as a top-level field in the ~/.claude.json file without overwriting existing content .

{
  "hasCompletedOnboarding": true
}
  1. Salve o arquivo e reinicie o Claude Code.
claude

OpenCode: Erro "Request entity too large"

Esse erro indica que o conteúdo da solicitação, como contexto de código ou histórico de conversa, excede o limite máximo de entrada. Para resolver este problema:

  1. Execute /new para criar uma nova conversa ou execute /compact para compactar o contexto. Para mais métodos de mitigação de estouro de contexto, consulte a documentação.
  2. Caso o problema persista, atualize o OpenCode para a versão 1.2.16 ou posterior. Esta versão inclui uma correção para este problema.

OpenCode: Erro de parâmetro "thinking_budget"

Causa: O valor de budgetTokens no arquivo de configuração opencode.json excede o thinking_budget máximo suportado pelo modelo atual. Os limites variam conforme o modelo. Ajuste sua configuração de acordo com a tabela abaixo.

Nome do modelo

Orçamento máximo de pensamento

qwen3,7-plus

262.144

qwen3,6-plus

81.920

qwen3,5-plus

81.920

qwen3-max-2026-01-23

81.920

kimi-k2,5

81.920

glm-5

32.768

glm-4,7

32.768

MiniMax-M2,5

Ativado por padrão. O parâmetro budgetTokens não é necessário.

qwen3-coder-next

Modo de pensamento não suportado.

qwen3-coder-plus

Modo de pensamento não suportado.

Solução: Abra o arquivo de configuração do OpenCode opencode.json e ajuste o valor de options.thinking.budgetTokens para que não exceda o limite do modelo. Para modelos que não suportam o modo de pensamento, como qwen3-coder-next e qwen3-coder-plus, remova o item de configuração options.thinking. Para obter detalhes, consulte OpenCode.

OpenCode: Erro de intervalo "max_tokens"

Causa: O valor de limit.output no arquivo de configuração opencode.json excede o número máximo de tokens de saída (max_tokens) suportado pelo modelo atual.

Solução: Modifique o arquivo de configuração opencode.json e ajuste o valor de limit para o modelo correspondente de acordo com OpenCode.

Os modelos do Coding Plan suportam o modo de pensamento?

A maioria dos modelos do Coding Plan que suportam pensamento profundo tem o modo de pensamento ativado por padrão. Para ativá-lo em ferramentas comuns:

O modelo que você está usando deve suportar o modo de pensamento.

Claude Code

Ativar modo de pensamento: Insira /config, navegue até Thinking mode e pressione Enter para alterar o valor para true.

Visualizar o processo de pensamento: Pressione Ctrl + O.

● I am Claude Code, the official command-line interface tool from Anthropic.                05:13 PM  kimi-k2.5
  My core purpose is to be a software engineering assistant:
  - Write, modify, and debug code
  - Explore and analyze codebases
  - Run terminal commands and automate tasks
  - Provide technical code explanations and suggestions
  My output style is concise and direct, prioritizing technical accuracy. I am powered by Claude Opus 4.6
  and use tools to complete tasks rather than just having a conversation.
∴ Thinking…
  The user asked, "Think and then tell me: who are you?" I need to think before answering.
  Based on the system prompt, I am Claude Code, the official CLI tool from Anthropic. I am powered by Claude Opus 4.6
  (based on the model ID in the background information: 'claude-opus-4-6').
  My characteristics are:
  1. Focus on software engineering tasks.
  2. Use tools to complete tasks (not just converse).
  3. Maintain a concise and professional tone.
  4. Do not use emojis proactively.
  5. Prioritize technical accuracy over emotional validation.
  I need to think before answering, so I should give a concise and accurate self-introduction.

OpenCode

Para obter detalhes, consulte OpenCode. Configure o parâmetro options da seguinte forma:

{
  "thinking": {
    "type": "enabled",
    "budgetTokens": 1024
  }
}

budgetTokens é o número máximo de tokens para pensamento. Você pode ajustá-lo conforme necessário.

Qwen Code

Abra ~/.qwen/settings.json e, na propriedade modelProviders, defina o parâmetro enable_thinking como true para ativar o modo de pensamento:

{
  "ide": {
    "hasSeenNudge": true
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian Coding Plan] qwen3.6-plus",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      ...
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "china",
    "version": "xxx"
  },
  "model": {
    "name": "qwen3.6-plus"
  },
  "$version": 3
}
{
  "ide": {
    "hasSeenNudge": true
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian Coding Plan] qwen3.6-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      ...
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "china",
    "version": "xxx"
  },
  "model": {
    "name": "qwen3.6-plus"
  },
  "$version": 3
}

OpenClaw

Para ativar o modo de pensamento no OpenClaw, siga estas etapas:

  1. Verificar a versão do OpenClaw

    Execute openclaw tui no terminal para entrar na TUI. Na caixa de diálogo, insira openclaw --version para verificar se a sua versão do OpenClaw é v2026.03.02 ou posterior. Versões anteriores do OpenClaw podem não conseguir ativar o modo de pensamento.

openclaw --version
OpenClaw 2026.3.8 (commit: 3caab92)
  1. Selecionar um nível de pensamento

    Na TUI do OpenClaw, insira o comando /think high para selecionar o nível de pensamento (neste exemplo, high é selecionado como o nível de pensamento para a sessão atual).

/think high
→ high
  1. Modificar o arquivo de configuração
    1. Definir o parâmetro compat

      Consulte OpenClaw, abra o arquivo de configuração e adicione o parâmetro compat à configuração do modelo que suporta o modo de pensamento:

"compat": {
    "thinkingFormat": "qwen"
  }
  1. Definir o parâmetro reasoning

    Na mesma configuração de modelo, defina o parâmetro reasoning como true:

{
  "id": "qwen3-max-2026-01-23",
  "name": "qwen3-max-2026-01-23",
  "reasoning": true,
  "compat": {
    "thinkingFormat": "qwen"
  },
  "input": [
    "text"
  ],
  "cost": {
    "input": 0,
    "output": 0,
    "cacheRead": 0,
    "cacheWrite": 0
  },
  "contextWindow": 262144,
  "maxTokens": 65536
}
  1. Reiniciar o Gateway do OpenClaw

    Após salvar o arquivo de configuração, execute o seguinte comando no terminal para reiniciar o Gateway do OpenClaw e aplicar as alterações.

openclaw gateway restart

OpenClaw: Registros de chamadas para modelos não configurados

Motivo: O arquivo openclaw.json não possui a configuração agents.defaults.models para restringir o intervalo de modelos disponíveis.

Solução: Em ~/.openclaw/openclaw.json, declare explicitamente a lista de modelos permitidos em agents.defaults.models para restringir o OpenClaw a chamar apenas os modelos configurados. Para mais informações, consulte OpenClaw.

OpenClaw: Chat não responde após a conexão

As possíveis causas incluem:

  1. Um proxy local (VPN/HTTP Proxy) intercepta ou não consegue encaminhar corretamente as solicitações para coding.dashscope.aliyuncs.com.
  2. A URL Base no arquivo de cache do OpenClaw ~/.openclaw/agents/main/agent/models.json aponta para um endereço incorreto, e as solicitações são enviadas para um endpoint que não responde.

Solução:

  1. Tente desativar o proxy local ou garanta que o proxy possa acessar coding.dashscope.aliyuncs.com.
  2. Exclua o arquivo de cache ~/.openclaw/agents/main/agent/models.json e reinicie o OpenClaw. Após a reinicialização, o arquivo de cache será reconstruído automaticamente com base na configuração em ~/.openclaw/openclaw.json.

OpenClaw: Erro "OAuth token refresh failed"

Esse erro indica que você está conectado a um service OAuth de terceiros, não a um Coding Plan.

Solução:

  1. Configure o Coding Plan no OpenClaw. Para obter detalhes, consulte OpenClaw.

  2. Limpe as credenciais antigas do OAuth e o cache de modelos e, em seguida, reinicie o OpenClaw.

    Antes de excluir credenciais antigas do OAuth, faça backup dos arquivos para permitir uma reversão, se necessário.

rm ~/.openclaw/agents/main/agent/auth.json
  rm ~/.openclaw/agents/main/agent/models.json
  openclaw gateway restart

OpenClaw: Erro "Unknown model"

Esse erro indica que o OpenClaw não consegue encontrar o modelo especificado no arquivo de configuração. Verifique os seguintes itens nesta ordem:

  1. Configuração incorreta da chave models.providers ou prefixo do modelo

    Ao usar o Coding Plan, models.providers deve conter a chave bailian (que pode coexistir com outros provedores). Além disso, agents.defaults.model.primary deve ter o prefixo bailian/. A estrutura correta é a seguinte:

// Configuration file: ~/.openclaw/openclaw.json
{
  "models": { "providers": { "bailian": {...} } },
  "agents": { "defaults": { "model": { "primary": "bailian/qwen3.6-plus" } } }
}
  1. Configurações residuais de provedores antigos estão causando conflitos de roteamento

    Se você já usou outros provedores, como qwen-portal, configurações residuais de provedores podem causar confusão no roteamento de modelos. Limpe provedores irrelevantes e garanta que o modelo apontado pelo campo primary esteja definido corretamente na lista models.providers.bailian.models. Para informações de configuração, consulte OpenClaw.

O que é qwen-portal/coder-model?

qwen-portal/coder-model é um modelo gratuito fornecido pela versão web do Qwen Chat e não faz parte do Model Studio. Se você tentar usar este modelo no Model Studio ou no Coding Plan, receberá um erro indicando que o modelo não existe. Use modelos suportados pelo Model Studio.

OpenClaw: Erro "No API key found"

Esse erro indica que o OpenClaw não consegue encontrar a chave de API para o provedor (xxxxx) especificado na mensagem de erro. Verifique os seguintes itens nesta ordem:

  1. A configuração do provedor correspondente está ausente em models.providers.

    Abra o arquivo de configuração ~/.openclaw/openclaw.json e confirme se existe uma chave que corresponda ao nome do provedor na mensagem de erro sob models.providers.

    1. Se você se conectar ao Coding Plan, a configuração deve incluir a chave bailian (pode coexistir com outros provedores).
    2. Se a chave estiver ausente, adicione a configuração do provedor correspondente.
  2. A chave de API do provedor está configurada incorretamente.

    • Certifique-se de ter inserido uma chave de API válida, que não esteja vazia e não tenha espaços extras.
    • Se você usar o Coding Plan, certifique-se de usar a chave do plano (sk-sp-xxx).
    • Se a interface web exibir __OPENCLAW_REDACTED__, a chave de API já está salva e não precisa ser reinserida. Se estiver em branco ou exibir YOUR_API_KEY, você deve inserir a chave novamente.
  3. Um cache de credenciais locais desatualizado está impedindo que a nova configuração entre em vigor.

    Antes de excluir credenciais antigas, faça backup dos arquivos para permitir uma reversão, se necessário.

# Delete old credentials and model cache
rm ~/.openclaw/agents/main/agent/auth-profiles.json
rm ~/.openclaw/agents/main/agent/models.json
# Restart the Gateway to apply the new configuration
openclaw gateway restart

OpenClaw: Erro "API rate limit reached"

Verifique os seguintes itens nesta ordem:

  1. Configuração incorreta do OpenClaw

    Se a URL base ou o provedor de modelos estiver configurado incorretamente, as solicitações podem não ser roteadas pelo canal do Coding Plan e, em vez disso, serem roteadas para chamadas gerais de API, acionando um limite de taxa.

    • Se você usar a assinatura do Coding Plan, verifique se models, agents e gateway (incluindo campos aninhados) em OpenClaw configuration file são consistentes com as configurações na documentação. Por exemplo, a estrutura para um provedor de service de modelo é { "models": { "providers": { "bailian": {...} } } } .
    • Se você não tiver uma assinatura do Coding Plan, mude para uma para obter cota do plano.
  2. Cota da assinatura excedida: Verifique o uso da sua assinatura na página do Coding Plan.

  3. Tente redefinir a chave de API: Se o problema persistir após concluir as verificações anteriores, acesse a página do Coding Plan para redefinir sua chave de API.

OpenClaw: Erro "Failed to discover" na inicialização

O OpenClaw mostra um dos seguintes erros na inicialização:

  • Failed to discover Alibaba Cloud models: TimeoutError: The operation was aborted due to timeout
  • Failed to discover Alibaba Cloud models: 404 Not Found

Causa: O OpenClaw tenta consultar a lista de modelos para o Coding Plan do Model Studio, mas essa lista de modelos não pode ser consultada por meio de uma API.

Solução:

  1. Esta mensagem não afeta a operação normal do OpenClaw e pode ser ignorada.
  2. Se o OpenClaw não funcionar corretamente, verifique outras mensagens de erro.
  3. Para suprimir este aviso, exclua alibaba-cloud:default profile do arquivo ~/.openclaw/agents/main/agent/auth-profiles.json. Por exemplo:
"profiles": {
     "alibaba-cloud:default": {
       "type": "api_key",
       "provider": "alibaba-cloud",
       "key": "sk-sp-xxxxx"
     }
   }

Depois de alterar para "profiles": {}, o aviso não aparecerá mais.

OpenClaw: Erro "auth.profiles"

Você pode ver erros semelhantes aos seguintes ao usar o OpenClaw:

  • auth.profiles.qwen-portal:default.mode: Invalid input
  • auth.profiles.qwen-portal:default: Unrecognized key: "apiKey"

Causa: O campo auth.profiles no arquivo openclaw.json foi modificado incorretamente, como alterar o mode para um valor inválido ou adicionar o campo apiKey. O campo auth armazena apenas metadados de autenticação, não chaves secretas. O Coding Plan não precisa ser configurado em auth.profiles.

Solução
  1. Corrija a configuração de auth.profiles excluindo campos adicionados ou modificados incorretamente e perfis desnecessários.
  2. Confirme se a chave de API para o Coding Plan está configurada em models.providers.bailian.apiKey. Para mais informações, consulte OpenClaw.

O Coding Plan suportaAgent Teamsno Claude Code?

Não suportado. O seguinte erro é relatado: "model claude-opus-4-6 is not supported.".

O Coding Plan suporta a API Responses da OpenAI?

Não. O Coding Plan suporta apenas o protocolo OpenAI Chat Completions e o protocolo Anthropic Messages. A API Responses da OpenAI não é suportada.

Erro "HTTP 401: Incorrect API key provided"

Possíveis causas:

  • Formato de chave de API inválido: A chave de API está vazia, tem um formato incorreto, está incompleta ou contém espaços extras. Certifique-se de usar a Chave de API para o Coding Plan, que começa com sk-sp- . Copie toda a chave e certifique-se de que ela não contenha espaços extras.

  • Assinatura do Coding Plan expirada ou inválida: Uma chave de API específica do Coding Plan depende do status da assinatura. Se sua assinatura do Coding Plan expirou ou é inválida, a chave correspondente não funcionará mais. Garanta que sua assinatura esteja ativa.

  • URL Base incorreta: Você configurou uma chave de API específica do Coding Plan (que começa com sk-sp- ), mas a URL Base ainda está definida como o endereço padrão do Model Studio, como https://dashscope-intl.aliyuncs.com/compatible-mode/v1. Com base em the AI tool that you are integrating, substitua a URL Base pelo endereço específico correspondente do Coding Plan na tabela abaixo.

    Ferramenta

    Protocolo

    URL Base

    OpenClaw

    Compatível com OpenAI

    https://coding -intl.dashscope.aliyuncs.com/v1

    OpenCode

    Compatível com Anthropic

    https://coding -intl.dashscope.aliyuncs.com/apps/anthropic/v1

    Claude Code

    Compatível com Anthropic

    https://coding -intl.dashscope.aliyuncs.com/apps/anthropic

    Cursor

    Compatível com OpenAI

    https://coding -intl.dashscope.aliyuncs.com/v1

    VSCode Cline

    Compatível com OpenAI

    https://coding -intl.dashscope.aliyuncs.com/v1

    Qwen Code

    Compatível com OpenAI

    https://coding -intl.dashscope.aliyuncs.com/v1

  • Chave de API incorreta usada: Você configurou a URL Base do Coding Plan, mas inseriu incorretamente a chave de API geral para o Model Studio, que começa com sk-. Atualize a chave de API para a Chave de API do Coding Plan.

  • Erro de configuração causado por cache obsoleto do OpenClaw: No arquivo ~/.openclaw/agents/main/agent/models.json, exclua o item de configuração providers.bailian e reinicie o OpenClaw.

Erro "Authentication failed" com token do ModelScope

Esse erro indica que você está conectado ao service de terceiros ModelScope, não a um Coding Plan. Para se conectar a um Coding Plan, consulte Connect to client or development tools.

Este erro ocorre quando você fornece uma credencial incorreta para o service de API do ModelScope . Verifique os seguintes itens nesta ordem:

  1. Você inseriu as credenciais de acesso erradas para a plataforma: Um token do ModelScope tem o formato ms-xxx , enquanto uma chave de API geral para o Alibaba Cloud Model Studio tem o formato sk-xxx. As duas são plataformas independentes e suas credenciais de acesso não são intercambiáveis. Acesse ModelScope para obter um token.
  2. Formato incorreto: Certifique-se de que não haja espaços extras ou quebras de linha ao copiar o token do ModelScope.

Erro "Only available for Coding Agents"

Esse erro indica que a chamada foi feita a partir de uma ferramenta ou ambiente não suportado.

O Coding Plan é destinado exclusivamente ao uso dentro de ferramentas de programação, como Claude Code e Qwen Code, e não é suportado em ferramentas como curl, Postman ou Dify.

Problemas de faturamento e cota

Cobranças inesperadas com um Coding Plan

Se você continuar a incorrer em cobranças ou tiver um pagamento em atraso após assinar um Coding Plan, isso pode ser devido a um dos seguintes motivos:

  1. Configuração incorreta da Chave de API e URL Base específicas do plano (Motivo mais comum)
    • Causa: Se você configurar sua ferramenta de IA com uma Chave de API geral (no formato sk-xxx) e uma URL Base geral (que não contém a palavra-chave coding), o sistema identifica as chamadas como pagamento conforme o uso e as fatura adequadamente.
    • Solução: Você deve usar a configuração do Coding Plan. A Chave de API deve estar no formato sk-sp-xxx, e a URL Base deve conter a palavra-chave coding (como https://coding -intl.dashscope.aliyuncs.com/xxx). Para mais informações, consulte Obtain the plan API Key and Base URL.
  2. Pagamento em atraso causado por atrasos de faturamento (cobranças incorridas antes de assinar o Coding Plan)
    • Causa: As faturas são agregadas por minuto, e a geração da fatura pode ser atrasada por alguns minutos. Por exemplo, uma chamada de API feita às 16:00 pode não ser faturada até às 16:05, o que pode ser depois que você assinou o Coding Plan.
    • Solução: As cobranças são baseadas no horário real de faturamento. Para obter detalhes, consulte Bill queries and cost management.
  3. Uso de credenciais de API gerais por engano
    • Causa: Se ambas as configurações gerais e específicas do plano estiverem salvas em sua ferramenta, algumas ferramentas (como o OpenClaw) podem rotear automaticamente as solicitações usando as credenciais gerais, resultando em cobranças.
    • Solução: Recomendamos remover a configuração de API geral da sua ferramenta e garantir que você selecione um model supported by the Coding Plan. Por exemplo, no OpenCode, selecione um modelo com o provedor rotulado como 'Model Studio Coding Plan'.
  4. Cache do cliente não limpo
    • Causa: Depois de configurar novas credenciais, algumas ferramentas ainda podem usar versões em cache das antigas credenciais de API gerais.
    • Solução: Limpe o cache e reinicie a ferramenta. Por exemplo, com o OpenClaw, exclua o arquivo ~/.openclaw/agents/main/agent/models.json, execute openclaw gateway restart para reiniciar o service e, em seguida, reconfigure-o de acordo com a documentação OpenClaw.

Esgotamento de cota

  • Plano Lite: Se você esgotar sua cota de 5 horas ou semanal, aguarde a redefinição automática. Se esgotar sua cota mensal, você deve esperar até o próximo ciclo de assinatura para que ela seja redefinida.
  • Plano Pro: Caso esgote sua cota de 5 horas ou semanal, aguarde a redefinição automática. Ao esgotar sua cota mensal, é necessário aguardar até o próximo ciclo de assinatura para a redefinição.

Mudança automática para pagamento conforme o uso

Não. Após o esgotamento da cota do seu Coding Plan, chamadas adicionais de API falharão com um erro, e o uso não mudará automaticamente para pagamento conforme o uso. Para continuar usando o service, você deve esperar que sua cota seja redefinida no próximo ciclo de assinatura.

Teste gratuito e Coding Plan

O Coding Plan é uma assinatura independente. Seu sistema de faturamento e cota é separado do programa de teste gratuito para modelos de uso geral no Model Studio.

Cálculo do período de assinatura

Sua assinatura torna-se ativa no momento da compra e expira às 23:59:59 (UTC+8) no dia correspondente do mês seguinte. Se o mês seguinte não tiver um dia correspondente, a assinatura expira às 23:59:59 (UTC+8) no último dia desse mês.

Por exemplo: Se você assinar um Coding Plan em 3 de fevereiro de 2026, ele será válido até 3 de março de 2026.

Visualização do consumo de tokens

Atualmente, isso não é suportado. O consumo de cota do Coding Plan é baseado no número de chamadas de modelo, não no consumo de tokens. Você pode visualizar suas informações de uso na página do Coding Plan.

Uso por modelo específico

Isso não é suportado. A página do Coding Plan exibe apenas o consumo geral e a cota restante para todo o plano.

Assinatura anual

Atualmente, o Coding Plan está disponível apenas como uma assinatura mensal. Um plano anual ainda não está disponível.

Falha na renovação automática

Isso pode ser devido aos seguintes motivos:

  1. Configuração ainda não efetivada: A renovação automática entra em vigor no dia seguinte à ativação, não imediatamente.
  2. Fundos insuficientes: As cobranças de renovação automática são deduzidas dos métodos de pagamento vinculados à sua conta. Certifique-se de que seus métodos de pagamento sejam válidos e tenham fundos suficientes.

Renovação após expiração

Não, a renovação não é suportada após a expiração da assinatura.

Erro de renovação duplicada

Causa: Você já renovou sua assinatura para o próximo mês, e a renovação para meses adicionais não é suportada.

Período de service de renovação antecipada

Ao adquirir um plano mensal, a duração da assinatura é calculada por mês civil. O plano torna-se ativo após a compra e expira às 23:59:59 (UTC+8) no dia correspondente do mês seguinte. Se o próximo mês não tiver um dia correspondente, ele expira às 23:59:59 (UTC+8) no último dia desse mês. Se você renovar antecipadamente, o novo período se estende a partir da data de expiração original.

Por exemplo:

  • Uma assinatura inicial em 15 de março às 10:00 expira em 15 de abril às 23:59:59.
  • Se você renovar por um mês em 10 de abril, a nova data de expiração se estende até 15 de maio às 23:59:59.

Uso de cupons para renovação

Sim, você pode usar cupons de uso geral.

Renovação de assinatura

Você pode renovar o plano Pro na página do Coding Plan ou na página de Renovação. Para informações sobre a descontinuação das renovações para o plano Lite Basic, consulte o Aviso.

Recursos do product

Modelos suportados

Tanto os planos Lite quanto Pro suportam todos os modelos incluídos no plano (incluindo Qwen, GLM, Kimi e MiniMax). Para uma lista completa de modelos, consulte Coding Plan Overview.

Atualizações da lista de modelos

A lista de modelos suportados é atualizada periodicamente. Para a lista atual, consulte a página Coding Plan Overview.

Limite de assinatura

Cada conta do Model Studio pode assinar apenas um Coding Plan por vez (independentemente de ser o plano Lite ou Pro).

É possível usar modelos que não estão emthe list of supported models?

O Coding Plan suporta apenas modelos listados em list of supported models. O uso de qualquer outro modelo resulta em erro.

Velocidade de resposta dos planos Lite e Pro

Os planos Lite e Pro oferecem a mesma velocidade de resposta porque usam os mesmos recursos de modelo e service de inferência.

Renovação e upgrade do plano Lite

A partir de 13 de abril de 2026, o plano Lite não estará mais disponível para renovação e não poderá ser atualizado para o plano Pro. Para obter detalhes, consulte o aviso.

  • Se você tiver um plano Lite, poderá usá-lo até que expire.
  • Se você ativou a renovação automática para seu plano Lite, o sistema a desativará automaticamente 30 dias após a data do aviso. Você pode continuar a usar o plano até o término do período de service atual.

Agradecemos sua compreensão e apoio ao Alibaba Cloud Model Studio.

Downgrade para o plano Lite

Não, o downgrade não é suportado.

Limite de concorrência

Sim, o Coding Plan tem um limite de concorrência. A plataforma ajusta dinamicamente esse limite com base na carga geral de recursos para evitar sobrecarga durante horários de pico e garantir uma velocidade de resposta estável e qualidade de inferência para cada agente. Se você atingir o limite de concorrência, aguarde alguns instantes e tente novamente.

Suporte a múltiplos usuários

A chave de API do Coding Plan é apenas para uso pessoal e não deve ser compartilhada. Se o sistema detectar que sua chave de API foi exposta publicamente, ela poderá ser desativada automaticamente.

Compartilhamento de um plano Pro

Não. Mantenha sua chave de API segura. Não a compartilhe com outras pessoas ou a exponha em código do lado do cliente. Se o sistema detectar que sua chave de API foi exposta publicamente, ela poderá ser desativada automaticamente.

Janelas de contexto de modelo e tratamento de estouro

Nome do modelo

Janela de contexto (tokens)

qwen3,7-plus

1.000.000

qwen3,6-plus

1.000.000

qwen3,5-plus

1.000.000

kimi-k2,5

262.144

glm-5

202.752

MiniMax-M2,5

196.608

qwen3-max-2026-01-23

262.144

qwen3-coder-next

262.144

qwen3-coder-plus

1.000.000

glm-4,7

202.752

Se você encontrar um erro por exceder a janela de contexto, recomendamos iniciar uma nova sessão. Você também pode usar os seguintes métodos para evitar esse problema:

  1. Trocar modelos: Mude para um modelo que suporte uma janela de contexto maior, como qwen3,7-plus, qwen3,6-plus, qwen3,5-plus ou qwen3-coder-plus.
  2. Reduzir arquivos irrelevantes: Recomendamos iniciar sua ferramenta de codificação de IA no diretório específico do projeto e manter apenas os arquivos necessários do projeto.
  3. Dividir tarefas: Divida tarefas complexas em subtarefas menores e pergunte sobre elas individualmente para reduzir o contexto usado em uma única solicitação.
  4. Fornecer instruções precisas: Solicitações vagas podem acionar varreduras desnecessárias de arquivos. Use perguntas ou instruções claras e específicas ao usar uma ferramenta de codificação de IA.

As operações específicas variam conforme a ferramenta. Para obter detalhes, consulte Connect to Clients/Development Tools.

Redefinição da chave de API

Na página do Coding Plan, clique em no botão Reset ao lado da sua chave de API do Coding Plan.

ObservaçãoApós redefinir sua chave de API, você deve atualizá-la em todas as ferramentas onde ela é usada. Caso contrário, essas ferramentas pararão de funcionar.

Se um Coding Plan expirar e não for renovado, a Chave de API é redefinida após a reativação?

Sim, ela será redefinida. Se você renovar antes da data de expiração, sua chave de API não será redefinida.

Lembretes de expiração

Sim. O sistema envia lembretes de renovação 7, 3 e 1 dia antes da expiração da sua assinatura por meio de mensagens internas, e-mails, SMS e chamadas de voz automatizadas.

Configuração de notificações de expiração

Isso não é suportado. O sistema envia automaticamente lembretes de expiração 7, 3 e 1 dia antes da expiração da sua assinatura por meio de mensagens internas, e-mails, SMS e chamadas de voz automatizadas. A inscrição manual não é necessária.

Múltiplas chaves de API

Não. Atualmente, apenas uma chave de API é suportada por assinatura do Coding Plan.

Suporte a lista de permissões de IP

Não. Se sua chave de API for comprometida, redefina-a na página do Coding Plan.

Acesso de usuário RAM à chave de API

Entre em contato com o proprietário da conta Alibaba Cloud ou um usuário RAM com permissões administrativas para adicionar a permissão Subscription Plans à sua conta.

Uso com VSCode

Use uma extensão do VS Code que suporte APIs compatíveis com OpenAI ou Anthropic, como Qwen Code ou Claude Code.

Quantização de modelo

Os modelos no Coding Plan, como glm-5 e qwen3,5-plus, são versões completas que não foram submetidas a quantização ou redução de recursos.

Coding Plan vs. Savings Plan de Uso Geral de IA

Recurso

Coding Plan

AI General-purpose Savings Plan

Caso de uso

Para ferramentas de codificação de IA (como Claude Code, OpenClaw, etc.)

Para compensar taxas de pagamento conforme o uso para chamadas de API gerais do Model Studio

Formato da chave de API

sk-sp-xxx (Chave específica do plano)

sk-xxx (Chave geral do Model Studio)

Domínio da URL Base

coding -intl.dashscope.aliyuncs.com

dashscope -intl.aliyuncs.com

Método de faturamento

Assinatura mensal

Faturado com base no uso de tokens

Cenários aplicáveis

Programação interativa de IA

Chamadas de API e desenvolvimento de aplicativos

Resolução do erro data_inspection_failed

Consulte a documentação Error Codes.

Uso com Dify

O uso do Coding Plan no Dify não é recomendado. O Coding Plan destina-se apenas a ferramentas de codificação de IA, como Claude Code e Qwen Code. Não use a chave de API do plano para scripts automatizados, backends de aplicativos personalizados ou quaisquer cenários de chamada em lote não interativos. Tal uso viola os termos de service e pode resultar na suspensão da sua assinatura ou na desativação da sua chave de API.

Uso do Coding Plan no Postman

Isso não é recomendado. O Coding Plan destina-se apenas a ferramentas de codificação de IA, como Claude Code e Qwen Code. Não use a chave de API do plano para scripts automatizados, backends de aplicativos personalizados ou quaisquer cenários de chamada em lote não interativos. Tal uso viola os termos de service e pode resultar na suspensão da sua assinatura ou na desativação da sua chave de API.