Ferramenta CLI

QwenCloud CLI para gerenciamento e invocação de modelo: gerencie o catálogo de modelos, contas, uso, cobrança, assinaturas e tickets de suporte e invoque modelos de texto, imagem, vídeo e fala

Versão 1.5.0

QwenCloud CLI é de código aberto – navegue pelo código, registre problemas ou contribua: GitHub

Início rápido

Requer Node.js 18 ou posterior. O nome do pacote npm e as versões instaláveis estão sujeitos à página de lançamento real.

1. Instale e verifique:

npm install -g @qwencloud/qwencloud-cli
qwencloud version

2. Atualize para a versão mais recente se a CLI já estiver instalada:

Os usuários do npm podem atualizar diretamente executando:

npm install -g @qwencloud/qwencloud-cli@latest

Você também pode verificar se há uma nova versão com:

qwencloud version --check
qwencloud update

update apenas verifica e imprime orientações de atualização; ele não é instalado automaticamente. Execute o comando que ele imprime. Se você acabou de concluir a etapa 1, já possui a versão mais recente e pode pular esta etapa.

3. Faça login de forma interativa:

qwencloud auth login

4. Execute sua primeira consulta:

qwencloud models list

5. Faça sua primeira invocação de modelo (requer uma chave de API, crie uma no console):

export QWENCLOUD_API_KEY=sk-xxxx
qwencloud chat create "Reply with one short sentence: hello from QwenCloud"

Em um terminal interativo, este comando transmite texto por padrão. Para regras de parâmetro, entrada de arquivo e saída de automação, consulte Invocação de modelo.

Corre qwencloud sem argumentos para entrar no modo interativo; com um comando ele é executado uma vez e sai.

A invocação do modelo requer apenas uma chave de API; nenhum login de gerenciamento é necessário. Definir QWENCLOUD_API_KEY (ou QWEN_API_KEY / DASHSCOPE_API_KEY) ou passar --api-key. Login de gerenciamento (auth login) é usado para navegação de modelo, uso, cobrança e outros comandos de gerenciamento; um sucesso models list a resposta confirma que a instalação e a rede estão funcionando. Os agentes podem executar qwencloud config set output.format json para bloquear a saída JSON; correr qwencloud doctor --format json se a verificação falhar.

Modelos e documentos

Filtrar modelos disponíveis, verificar detalhes do modelo ou encontrar documentos de integração? Comece aqui.

lista de modelos

Lista os modelos disponíveis, filtrados por modalidade de entrada/saída.

qwencloud models list [--input <text|image|video|audio|vector>] [--output <text|image|video|audio|vector>] [--page <integer>] [--per-page <integer>] [--all] [--verbose] [--format <auto|table|json|text>]

qwencloud models list --input image --output text
qwencloud models list --all --verbose --format json

Exemplo de estrutura de saída JSON (valores de amostra apenas para ilustração de campo):

{
  "models": [
    {
      "id": "qwen3.6-plus",
      "modality": {
        "input": ["text", "image"],
        "output": ["text"]
      },
      "can_try": true,
      "free_tier": {
        "mode": "standard",
        "quota": {
          "remaining": 850000,
          "total": 1000000,
          "unit": "tokens",
          "used_pct": 15,
          "status": "valid",
          "resetDate": "2026-08-01T00:00:00.000Z"
        }
      },
      "pricing": {
        "tiers": [
          {
            "label": "Text input",
            "input": 1.25,
            "output": 3.75,
            "cache_creation": 1.5625,
            "cache_read": 0.125,
            "unit": "USD/1M tokens"
          }
        ],
        "summary": {
          "cheapest_input": 1.25,
          "cheapest_output": 3.75,
          "unit": "USD/1M tokens",
          "billing_type": "token"
        }
      },
      "features": ["function-calling"],
      "context": {
        "context_window": 131072,
        "max_input": 122880,
        "max_output": 8192
      }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}

Depois de encontrar modelos candidatos, execute qwencloud models info <id> para visualizar detalhes completos de preços, contexto e limite de taxa. Os modelos programados para aposentadoria incluem um adicional lifecycle campo aninhado com a estrutura {status, offline_time, announcement_url}; status está atualmente retiring. Os modelos normais não incluem este campo.

informações dos modelos

Veja todos os detalhes de um único modelo; forneça o argumento posicional ou --model.

qwencloud models info [id] [--model [id]] [--format <auto|table|json|text>]

qwencloud models info qwen3.6-plus
qwencloud models info --model qwen3.6-plus --format json

Este comando retorna metadados do catálogo de modelos, como modalidade, recursos, contexto, preço e limites de taxa; ele não fornece o esquema completo dos parâmetros da solicitação. Os modelos programados para aposentadoria também incluem o lifecycle campo. Para parâmetros de modelo e valores aceitos, use a página oficial de parâmetros da API que corresponde ao ID do modelo e ao tipo de interface. qwencloud docs search <model-id> pode ajudar a localizar essa página, mas você deve verificar o ID do modelo e o tipo de interface.

Para continuar comparando modelos candidatos, execute qwencloud models search <query> para restringir resultados.

pesquisa de modelos

Pesquise modelos por palavra-chave ou modalidade.

qwencloud models search <query> [--page <integer>] [--per-page <integer>] [--all] [--format <auto|table|json|text>]

qwencloud models search "function calling"
qwencloud models search image --all --format json

pesquisa de documentos

Pesquisar documentação oficial; opcionalmente, visualize o enésimo resultado embutido.

qwencloud docs search <query> [--limit <integer>] [--page <integer>] [--language <en|zh>] [--view <integer>] [--format <auto|table|json|text>]

qwencloud docs search "chat completions" --language en --limit 10
qwencloud docs search "API Key" --view 1

Depois de encontrar uma entrada de destino, execute qwencloud docs view <path-or-url> para ler o conteúdo completo.

visualização de documentos

Visualize o conteúdo da página por caminho do documento ou URL.

qwencloud docs view <path-or-url> [--format <auto|table|json|text>]

qwencloud docs view api-reference/preparation/cli

Autenticação, conta e espaço de trabalho

Faça login, verifique a validade da credencial ou veja quais espaços de trabalho sua conta pode acessar? Use estes comandos.

login de autenticação

Faça login e salve as credenciais; terminais interativos preferem PKCE, ambientes não interativos usam Device Flow.

qwencloud auth login [--init-only] [--complete] [--timeout <seconds>] [--format <auto|table|json|text>]

qwencloud auth login
qwencloud auth login --init-only --format json
qwencloud auth login --complete --timeout 180

Em ambientes não TTY sem --init-only/--complete, o comando retornará automaticamente no modo somente inicialização. As credenciais são preferencialmente armazenadas nas chaves do sistema, recorrendo a um arquivo criptografado. Você também pode correr qwencloud login diretamente.

Após o login bem-sucedido, execute qwencloud auth status --format json para verificar as credenciais, então qwencloud models list para verificar as permissões de consulta.

status de autenticação

Verifique as credenciais locais e o status de verificação do servidor.

qwencloud auth status [--format <auto|table|json|text>]

qwencloud auth status --format json

Exemplo completo de estrutura JSON:

{
  "authenticated": true,
  "server_verified": true,
  "auth_mode": "device_flow",
  "source": "keychain",
  "user": {
    "aliyunId": "example-user"
  },
  "token": {
    "expires_at": "2026-08-01T00:00:00.000Z",
    "scopes": ["inference:read", "usage:read", "config:write"]
  }
}

Quando o servidor está inacessível, mas as credenciais locais ainda são válidas, server_verified é false e pode incluir um warning; o código de saída é 2 quando não está conectado ou as credenciais expiraram.

Se authenticated é false, execute novamente qwencloud auth login.

logout de autenticação

Saia e exclua as credenciais locais. Você também pode correr qwencloud logout diretamente.

qwencloud auth logout [--format <auto|table|json|text>]

qwencloud auth logout

lista de espaços de trabalho

Liste os espaços de trabalho acessíveis à conta atual.

qwencloud workspace list [--format <auto|table|json|text>]

qwencloud workspace list --format json

Depois de listar os espaços de trabalho, execute qwencloud workspace limit para verificar se a conta pode criar mais.

limite do espaço de trabalho

Veja a contagem de espaços de trabalho usados e o limite rígido da conta.

qwencloud workspace limit [--format <auto|table|json|text>]

qwencloud workspace limit

A invocação do modelo não requer login de gerenciamento; uma chave de API é suficiente. Para obter as fontes e precedência documentadas das credenciais de inferência, consulte Invocação de modelo.

Invocação de modelo

Inicie bate-papos, gere ou edite imagens, gere vídeos, transcreva fala, sintetize fala ou consulte tarefas assíncronas no terminal.

Nenhum dos seis comandos requer login de gerenciamento; passar --api-key, ou definir QWENCLOUD_API_KEY ou QWEN_API_KEY ou DASHSCOPE_API_KEY, para invocar diretamente. As credenciais de inferência são selecionadas nesta ordem documentada: --api-key → QWENCLOUD_API_KEY → QWEN_API_KEY → DASHSCOPE_API_KEY. Quando nada é fornecido, o comando retorna AUTH_REQUIRED e sai com o código 2.

Os parâmetros e valores suportados variam de acordo com o modelo. A aceitação CLI de um parâmetro, a transmissão de um campo, uma resposta HTTP 2xx, o código de saída 0 ou o recebimento de um ID de tarefa não significa que o modelo suporta ou usou esse parâmetro. Esta página documenta apenas pontos de entrada CLI. Para parâmetros de modelo, use a página de parâmetros de API vinculada ao final de cada seção de comando que corresponde à família de modelo, ID de modelo, protocolo e ramificação de execução. qwencloud models info <id> retorna apenas metadados do modelo. qwencloud docs search <model-id> é apenas um auxílio à pesquisa por palavras-chave; verifique o ID do modelo e o tipo de interface em cada resultado.

--request aceita JSON embutido, @file, ou - para ler do stdin, e a raiz deve ser um objeto. Um explícito --model substituições model no pedido. Quando um sinalizador de conveniência e seu campo de solicitação sinônimo estão presentes, o comando geralmente reporta PARAM_LAYER_CONFLICT e sai com o código 4. A análise bem-sucedida não significa que a solicitação foi enviada inalterada; As solicitações TTS WebSocket, em particular, são reconstruídas.

Para chamadas pré-pagas, quando qualquer entrada explícita acima recebe um arquivo local, a CLI o carrega primeiro e reescreve a entrada em um arquivo temporário. oss:// URL.

HTTP/HTTPS e oss:// as entradas são enviadas como URLs, mas não há garantia de que o serviço do modelo será capaz de acessá-las. Um caminho local em --request é apenas uma string JSON; a CLI não o descobre ou carrega recursivamente. Usando um arquivo local com relatórios do Token Plan LOCAL_UPLOAD_UNSUPPORTED e sai com o código 4. A orientação de remediação aparece em message; não há separado hint.

A CLI não verifica um arquivo existente antes de gravar um resultado e pode sobrescrevê-lo diretamente. A imagem e o TTS gravam no diretório atual por padrão. O vídeo grava somente quando a invocação atual aguarda com êxito e fornece --out. task get grava automaticamente no diretório atual apenas para tarefas bem-sucedidas de imagem, vídeo ou áudio cujo tipo de mídia pode ser identificado na extensão de URL. Antes de consultar novamente a mesma tarefa bem-sucedida, mova qualquer arquivo com o mesmo nome que você precisa manter.

criação de bate-papo

Inicie um bate-papo de texto ou multimídia. O modelo padrão atual é qwen3.8-max.

qwencloud chat create [prompt] [--model <id>] [--temperature <n>] [--max-tokens <n>] [--stream] [--thinking|--no-thinking] [--image <path-or-url>] [--video <path-or-url>] [--request <json|@file|->] [--api-key <key>] [--format <auto|table|json|text>]

qwencloud chat create "Explain serverless computing in one sentence"
qwencloud chat create "Describe this image" --image https://example.com/image.png
qwencloud chat create "List three ideas" --stream --format json

Um prompt não pode coexistir com request.messages. --image e --video requer um prompt posicional; sinalizadores de mídia em uma invocação somente de solicitação não são gravados na solicitação. Se --temperature, --max-tokens, --stream, --thinking, ou um sinalizador de mídia coexiste com o campo de solicitação correspondente, o comando relata PARAM_LAYER_CONFLICT e sai com o código 4.

A CLI entra no modo de streaming apenas devido a uma mensagem explícita --stream ou porque stdout é um TTY; request.stream não é possível alternar a ramificação de saída CLI. Em um TTY, um pedido fornecido stream entra em conflito com a configuração de streaming implícita e sai com o código 4. Sem streaming --format json retorna {meta,data} e preserva a montante reasoning_content. --thinking controla apenas se a saída legível e os eventos de streaming mostram conteúdo de raciocínio.

Transmissão --format json retorna NDJSON, não um documento JSON. Cada evento de conteúdo contém um incremento delta que deve ser concatenado em ordem. Com --thinking, as linhas delta de raciocínio contêm reasoning: true. Somente após a conclusão bem-sucedida é que a última linha {"meta":{...}}, que pode conter request_id, model, finish_reasone uso de token normalizado. Quando o modelo estiver programado para aposentadoria, meta também inclui um model_offline_warning campo string com a data de aposentadoria e um link de migração. Uma falha de evento de streaming é gravada em stderr e sai com o código 1; um erro de rede de conexão é gravado em stderr e sai com o código 3. stdout já pode conter parcial delta saída antes de uma falha, sem final meta linha.

--image e --video siga as regras de arquivo em nível de domínio. Passando um arquivo local com relatórios do Token Plan LOCAL_UPLOAD_UNSUPPORTED e sai com o código 4; use um URL acessível ao modelo de destino.

O padrão qwen3.8-max branch usa a API de bate-papo compatível com OpenAI. Consulte API de bate-papo compatível com OpenAI para seus parâmetros. Modelos de geração de texto pode complementar a seleção do modelo, mas não substitui a página de parâmetros da API correspondente. O sucesso do comando não significa que todos os parâmetros fornecidos foram usados ​​pelo modelo.

geração de imagem

Gere uma imagem ou processe uma imagem de referência com um modelo que suporte edição. O modelo padrão atual é qwen-image-3.0-pro.

qwencloud image generate [prompt] [--model <id>] [--size <width*height>] [--n <count>] [--image <path-or-url>] [--out <path>] [--response-format <fmt>] [--request <json|@file|->] [--no-wait] [--timeout <seconds>] [--api-key <key>] [--format <auto|table|json|text>]

qwencloud image generate "A paper-cut illustration of a cloud city"
qwencloud image generate "Replace the sky with sunset" --model qwen-image-3.0 --image ./photo.png
qwencloud image generate "A watercolor fox" --model wanx2.1-t2i-turbo --no-wait --format json

A CLI despacha apenas por ID de modelo: IDs começando com wanx, ou correspondente wan2.<minor> com uma versão secundária abaixo de 6, execute de forma assíncrona. wan1.x, wan2.6+e outros modelos não são classificados como assíncronos por esta regra. O modelo padrão atual é executado de forma síncrona. --image valida primeiro o modelo de edição; o modelo padrão atual não entra diretamente no ramo de edição.

Um prompt não pode coexistir com request.input. --image requer um prompt posicional; --image em uma invocação somente de solicitação não é gravada na solicitação. Se --size, --n, ou --image coexiste com o campo de solicitação correspondente, o comando reporta PARAM_LAYER_CONFLICT. Download de imagens bem-sucedido para --out ou o diretório atual por padrão. Com --response-format b64 --format json, a CLI baixa cada resultado, converte-o localmente para base64 e retorna-o por meio data.images[ ].b64; a tabela e a saída de texto mostram apenas uma mensagem ou URL, não base64. Outro --response-format os valores atualmente não relatam erros e ainda usam o comportamento de download padrão; não confie nesse comportamento.

Para um modelo assíncrono, --no-wait retorna um ID de tarefa e sai com o código 0 sem preservar --out ou b64 configurações de pós-processamento; mais tarde task get aplica suas próprias regras de download automático. Quando a pesquisa assíncrona atinge o --timeout limite, a implementação atual retorna o status incompleto e sai com o código 0. Consultas já em andamento podem fazer com que a duração real exceda esse valor. Isto não significa que a tarefa esteja concluída; continuar com qwencloud task get <task-id>. Um assíncrono FAILED a tarefa termina com o código 1. Um tempo limite de transporte síncrono ou outro NETWORK_ERRORe uma resposta de download não 2xx, saia com o código 3. Uma resposta de API do modelo diferente de 2xx, um erro de rede de download desembrulhado ou uma falha de gravação geralmente termina com o código 1.

--image segue as regras de arquivo em nível de domínio. Passando um arquivo local com relatórios do Token Plan LOCAL_UPLOAD_UNSUPPORTED e sai com o código 4; use um URL acessível ao modelo de destino. Para parâmetros, use a página que corresponde ao branch de execução: Qwen texto para imagem para o padrão qwen-image-3.0-pro ramo síncrono, Qwen edição de imagem para o Qwen ramo de edição e Wan tarefa de criação de texto para imagem v2 para o Wan ramificação de tarefa de criação de texto para imagem assíncrona v2.

geração de vídeo

Envie uma tarefa de texto para vídeo ou imagem para vídeo. O modelo padrão atual é happyhorse-1.1-t2v quando --image está ausente e happyhorse-1.1-i2v quando --image é fornecido.

qwencloud video generate [prompt] [--model <id>] [--image <path-or-url>] [--wait|--no-wait] [--timeout <seconds>] [--out <path>] [--request <json|@file|->] [--api-key <key>] [--format <auto|table|json|text>]

qwencloud video generate "A paper airplane flying over a city"
qwencloud video generate "Make the cat run" --image ./cat.png --out ./cat.mp4
qwencloud video generate "A sunrise over the sea" --no-wait --format json

Este comando sempre envia de forma assíncrona e aguarda a conclusão por padrão. A seleção do modelo padrão verifica apenas um explícito --image, não uma imagem dentro --request; uma solicitação I2V nativa deve ser definida model explicitamente. Um prompt não pode coexistir com request.input, e um modelo T2V explícito não pode ser combinado com --image. Esses erros de parâmetro saem com o código 4.

--no-wait retorna um ID da tarefa e sai com o código 0, comprovando apenas que a tarefa foi enviada; não preserva --out para uma consulta posterior. Quando a pesquisa assíncrona atinge o --timeout limite, o comando imprime o status da tarefa mais recente e sai com o código 8. Consultas já em andamento podem fazer com que a duração real exceda esse valor. Um FAILED a tarefa termina com o código 1. Depois que uma tarefa é bem-sucedida, o arquivo é baixado somente quando esta invocação aguarda o sucesso e é fornecida explicitamente --out; caso contrário, o comando retornará a URL.

--image segue as regras de arquivo em nível de domínio. Passando um arquivo local com relatórios do Token Plan LOCAL_UPLOAD_UNSUPPORTED e sai com o código 4; use um URL acessível ao modelo de destino. Sem --image, o HappyHorse Ramal T2V usa HappyHorse tarefa de criação de texto para vídeo. Passando --image muda para o ramal I2V, que usa HappyHorse tarefa de criação de imagem para vídeo; não use a página de parâmetros T2V para essa ramificação. Para Wan modelos, selecione a página oficial que corresponde ao T2V, I2V, primeiro e último quadro específico, referência ou ramificação de edição em vez de vincular todos Wan invocações para uma página.

transcrição de áudio

Transcreva uma gravação de áudio local ou URL de áudio. O modelo padrão atual é qwen-audio-3.0-asr-flash.

qwencloud audio transcribe [file-or-url] [--model <id>] [--language <hint>] [--wait|--no-wait] [--timeout <seconds>] [--request <json|@file|->] [--api-key <key>] [--format <auto|table|json|text>]

qwencloud audio transcribe ./meeting.wav
qwencloud audio transcribe https://example.com/meeting.mp3 --language en
qwencloud audio transcribe https://example.com/meeting.wav --model paraformer-v2 --no-wait --format json

Modelos cujos IDs começam com qwen use uma solicitação multimodal nativa síncrona; outros modelos usam ASR assíncrono. O Qwen infere ramo parameters.format da fonte de áudio explícita ou do primeiro URL de áudio na solicitação e usa wav quando nenhuma extensão reconhecível estiver disponível. O argumento posicional não pode coexistir com request.inpute --language não pode coexistir com o campo de idioma correspondente na solicitação. Esses erros de parâmetro saem com o código 4.

A ramificação síncrona retorna texto; --wait e --no-wait não têm efeito. --timeout ainda deve passar na validação de número positivo, mas não controla a solicitação síncrona posteriormente. Assíncrono --no-wait retorna um ID de tarefa e sai com o código 0. Quando a pesquisa atinge o --timeout limite, o comando imprime o status da tarefa e sai com o código 8; consultas já em andamento podem fazer com que a duração real exceda esse valor. Ao finalizar, o comando imprime uma prévia de até 200 caracteres e a URL do resultado; ele não salva o JSON da transcrição completa.

O argumento posicional segue as regras de arquivo em nível de domínio. Passando um arquivo local com relatórios do Token Plan LOCAL_UPLOAD_UNSUPPORTED e sai com o código 4; use um URL acessível ao modelo de destino. O padrão qwen-audio-3.0-asr-flash path é um ramo multimodal nativo síncrono. Nenhuma página oficial de esquema de parâmetros foi identificada que corresponda exatamente a esse ID de modelo e protocolo padrão, portanto, o qwen3-asr Qwen-ASR/DashScope page não deve ser tratada como seu parâmetro exato page. Use o catálogo de modelos de fala para texto para descoberta de modelo. Para não-Qwen modelos assíncronos, selecione criar tarefa/resultado da consulta ou Fun-ASR página que corresponde ao modelo e protocolo específicos. Para continuar consultando uma tarefa assíncrona, use qwencloud task get <task-id>.

discurso de áudio

Sintetize texto em áudio e escreva-o localmente. O modelo padrão atual é qwen-audio-3.0-tts-plus.

qwencloud audio speech [text] [--model <id>] [--voice <name>] [--out <path>] [--request <json|@file|->] [--api-key <key>] [--format <auto|table|json|text>]

qwencloud audio speech "Welcome to QwenCloud"
qwencloud audio speech "Welcome to QwenCloud" --voice longanhuan_v3.6 --out ./welcome.mp3

O comando é executado de forma síncrona. O texto posicional não pode coexistir com request.input. Um ID de modelo contendo cosyvoice ou começando com sambert usa WebSocket; outros modelos aplicáveis ​​usam HTTP. Os modelos TTS somente em tempo real e omni/live-translate são rejeitados localmente com o código de saída 4. Um resultado de URL HTTP é baixado, enquanto um resultado binário do WebSocket é gravado em um arquivo. Sem --out, o resultado será gravado no diretório atual.

Uma solicitação WebSocket retém apenas o resolvido model, input.texte parameters. A CLI primeiro adiciona valores padrão para text_type, formate sample_rate; solicitação parameters em seguida, substitua esses padrões e um explícito --voice substitui a voz por último. Outros campos de solicitação de nível superior não estão incluídos na mensagem WebSocket. A verificação de conflito atual examina apenas request.input.voice; se a solicitação já contém parameters.voice, um explícito --voice substitui-lo sem reportar PARAM_LAYER_CONFLICT.

O tempo limite HTTP interno de 60 segundos cobre apenas o período antes de uma resposta ser obtida, não lendo o corpo da resposta ou baixando posteriormente o URL de áudio. O WebSocket usa um cronômetro geral de aproximadamente 60 segundos para que as mensagens intermediárias não sejam redefinidas. Este comando não possui sinalizador de tempo limite. Um relatório de tempo limite de transporte NETWORK_ERROR e sai com o código 3. Uma resposta de download de áudio não 2xx sai com o código 3; um erro de rede de download desembrulhado ou falha de gravação geralmente termina com o código 1.

O padrão qwen-audio-3.0-tts-plus branch usa HTTP síncrono SpeechSynthesizer. Nenhuma página oficial de esquema de parâmetros foi identificada que corresponda exatamente a esse ID de modelo e protocolo padrão. Use o catálogo de modelos de conversão de texto em fala para descoberta de modelo e o Qwen lista de vozes ao selecionar um Qwen voz. CosyVoice e as páginas de parâmetros Sambert WebSocket se aplicam apenas às respectivas ramificações e não devem ser usadas como páginas de parâmetros para o padrão Qwen Filial HTTP. Este comando não possui entrada de upload; --out é apenas um caminho de resultado.

tarefa obtida

Consulte o status de um ID de tarefa existente uma vez. Este comando não pesquisa continuamente.

qwencloud task get <task-id> [--api-key <key>] [--format <auto|table|json|text>]

qwencloud task get TASK_ID
qwencloud task get TASK_ID --format json

Se <task-id> é totalmente omitido, relata o Comandante MISSING_ARGUMENT e sai com o código 1. Se uma string explícita apenas com espaços em branco for passada, o comando reporta INVALID_ARGUMENT e sai com o código 4. Este comando não tem --out sinalizador ou sinalizador para desativar downloads. Após o retorno de uma tarefa remota SUCCEEDED, a CLI processa o resultado antes de imprimir o envelope final. Uma resposta de download de mídia não 2xx sai com o código 3; um erro de rede desembrulhado ou falha de gravação geralmente sai com o código 1. Nesses casos, nenhum envelope de status final é impresso. Um controle remoto SUCCEEDED status, portanto, não garante que a CLI retornou com êxito ou gravou o arquivo. Se a recuperação da visualização da transcrição falhar, a CLI retornará à URL; as visualizações contêm no máximo 200 caracteres. A saída JSON também é normalizada {meta,data} envelope, não a resposta bruta do serviço.

Este comando não tem entrada de upload nem página de parâmetro de modelo. Consulte o ID da tarefa retornado pela operação anterior e avalie task_status, o código de saída do processo e o caminho local juntos, em vez de tratar qualquer sinal único como prova de que todo o processamento foi bem-sucedido.

Uso, cobrança e assinaturas

Want saber quanto você usou neste mês, quanto gastou, qual modelo ou chave de API custa mais ou quanta cota de assinatura resta? Use estes comandos.

As opções de data variam de acordo com o comando: usage summary as datas afetam apenas PAYG, usage free-tier atualmente retorna apenas um instantâneo; outras consultas são resolvidas em ordem: --from/--to > --days > --period > acumulado do mês. Comum --period os valores incluem today, yesterday, week, month, last-month, quarter, yeare YYYY-MM.

resumo de uso

Resuma a cota gratuita, o plano de token e o uso pré-pago.

qwencloud usage summary [--from <date>] [--to <date>] [--period <preset>] [--format <auto|table|json|text>]

qwencloud usage summary --period month
qwencloud usage summary --from 2026-07-01 --to 2026-07-21 --format json

Parâmetros de data e JSON de nível superior period único escopo pay_as_you_go; free_tier, coding_plane token_plan são instantâneos atuais no momento da consulta.

Exemplo completo de estrutura JSON (valores de amostra apenas para ilustração de campo):

{
  "period": {
    "from": "2026-07-01",
    "to": "2026-07-21"
  },
  "free_tier": [
    {
      "model_id": "qwen-plus",
      "quota": {
        "remaining": 850000,
        "total": 1000000,
        "unit": "tokens",
        "used_pct": 15,
        "status": "valid",
        "resetDate": "2026-08-01T00:00:00.000Z"
      }
    }
  ],
  "coding_plan": {
    "subscribed": true,
    "plan": "pro",
    "price": {
      "amount": 50,
      "currency": "USD",
      "cycle": "monthly"
    },
    "included_models": [],
    "windows": {
      "per_5h": {
        "remaining": 4800,
        "total": 6000,
        "used_pct": 20,
        "next_reset_at": "2026-07-21T12:00:00.000Z"
      },
      "weekly": {
        "remaining": 25000,
        "total": 30000,
        "used_pct": 16.67,
        "next_reset_at": "2026-07-27T00:00:00.000Z"
      },
      "monthly": {
        "remaining": 90000,
        "total": 100000,
        "used_pct": 10,
        "next_reset_at": "2026-08-01T00:00:00.000Z"
      }
    }
  },
  "token_plan": {
    "subscribed": true,
    "planName": "Token Plan",
    "status": "valid",
    "totalCredits": 25000,
    "remainingCredits": 18000,
    "usedPct": 28,
    "resetDate": "2026-08-01T00:00:00.000Z"
  },
  "pay_as_you_go": {
    "models": [
      {
        "model_id": "qwen-plus",
        "usage": {
          "tokens": 600000
        },
        "cost": 0.38,
        "currency": "USD"
      }
    ],
    "total": {
      "cost": 0.38,
      "currency": "USD"
    }
  }
}

Quando um modelo mostrar uso incomum, execute qwencloud usage breakdown --model <id>; para detalhes em nível de solicitação, use qwencloud usage logs.

detalhamento de uso

Visualize o uso pré-pago para um modelo específico, dividido por dia, mês ou trimestre.

qwencloud usage breakdown --model <id> [--granularity <day|month|quarter>] [--from <date>] [--to <date>] [--period <preset>] [--days <number>] [--format <auto|table|json|text>]

qwencloud usage breakdown --model qwen-plus --days 7
qwencloud usage breakdown --model qwen-plus --granularity month --period quarter

uso de nível gratuito

Navegue pelo status atual da cota gratuita para todos os modelos.

qwencloud usage free-tier [--from <date>] [--to <date>] [--period <preset>] [--format <auto|table|json|text>]

qwencloud usage free-tier --format json

Este comando sempre retorna o instantâneo da cota livre atual; sinalizadores de data atualmente não filtram a cota histórica.

pagamento de uso

Procure o uso pré-pago para todos os modelos.

qwencloud usage payg [--from <date>] [--to <date>] [--period <preset>] [--days <number>] [--format <auto|table|json|text>]

qwencloud usage payg --period last-month
qwencloud usage payg --days 30 --format json

registros de uso

Consulte registros de chamadas por horário, modelo, status ou ID de solicitação.

qwencloud usage logs [--from <date-or-rfc3339>] [--to <date-or-rfc3339>] [--period <preset>] [--model <id>]... [--status <type>]... [--request-id <id>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qwencloud usage logs --period 24h --status 4xx --status 5xx
qwencloud usage logs --request-id 12345-abcdef --format json

O intervalo máximo de tempo por consulta é de 14 dias.

resumo do faturamento

Resuma os valores de faturamento antes de impostos, impostos e pós-impostos por mês de liquidação.

qwencloud billing summary [--from <yyyy-mm>] [--to <yyyy-mm>] [--charge-type <all|subscription|payg>] [--format <auto|table|json|text>]

qwencloud billing summary --from 2026-06 --to 2026-07

Para localizar fontes de custo, execute qwencloud billing breakdown --group-by model ou --group-by api-key.

detalhamento do faturamento

Divida os gastos por modelo ou chave de API.

qwencloud billing breakdown [--granularity <day|month>] [--group-by <model|api-key>] [--from <date>] [--to <date>] [--period <preset>] [--charge-type <all|subscription|payg>] [--top <integer>] [--format <auto|table|json|text>]

qwencloud billing breakdown --group-by api-key --top 20
qwencloud billing breakdown --granularity day --period week

As consultas em nível de dia duram no máximo 31 dias; as consultas no nível do mês abrangem no máximo 12 meses.

limite de faturamento

Veja o limite de gastos e a configuração de alertas.

qwencloud billing limit [--format <auto|table|json|text>]

qwencloud billing limit --format json

vinculação de método de pagamento de cobrança

Abra a página de gerenciamento de métodos de pagamento para vincular ou gerenciar métodos de pagamento.

qwencloud billing payment-method bind [--format <table|json|text>]

qwencloud billing payment-method bind

Este comando assume como padrão o formato de tabela quando nenhum formato é especificado; os agentes devem passar --format json explicitamente.

lista de métodos de pagamento de faturamento

Liste os métodos de pagamento vinculados à conta.

qwencloud billing payment-method list [--format <table|json|text>]

qwencloud billing payment-method list --format json

Se a lista estiver vazia ou você precisar alterar a forma de pagamento, execute qwencloud billing payment-method bind.

status da assinatura

Resuma o status da assinatura.

qwencloud subscription status [--plan <token|coding>] [--format <auto|table|json|text>]

qwencloud subscription status --plan coding --format json

Ao usar o Team Token Plan, execute qwencloud subscription tokenplan seats --format json para visualizar instâncias de assento.

pedidos de assinatura

Liste pedidos de compra, renovação e upgrade de assinatura.

qwencloud subscription orders [--from <date>] [--to <date>] [--type <purchase|renew|upgrade>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qwencloud subscription orders --type purchase --page 1 --page-size 20

status do plano de token de assinatura

Visualize o tipo de assento do Token Plan, ciclo, status de renovação e informações de diagnóstico.

qwencloud subscription tokenplan status [--format <auto|table|json|text>]

qwencloud subscription tokenplan status --format json

assentos de tokenplan de assinatura

Listar instâncias de assento do Token Plan com paginação.

qwencloud subscription tokenplan seats [--spec-type <pro|standard>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qwencloud subscription tokenplan seats --spec-type pro --format json

Este comando assume como padrão o formato de tabela quando nenhum formato é especificado; os agentes devem passar --format json explicitamente.

Configuração, diagnóstico e conclusão

Want bloquear a saída legível por máquina, solucionar problemas do ambiente local, ativar a conclusão do shell ou confirmar a versão? Use estes comandos.

lista de configurações

Listar configurações configuráveis pelo usuário. A única configuração atualmente exposta é output.format.

qwencloud config list [--format <auto|table|json|text>]

qwencloud config list --format json

configuração obtida

Leia um valor de configuração.

qwencloud config get <key> [--format <auto|table|json|text>]

qwencloud config get output.format

conjunto de configurações

Defina um valor de configuração.

qwencloud config set <key> <value> [--format <auto|table|json|text>]

qwencloud config set output.format json

output.format aceita auto, table, json, text.

Depois de configurar, execute qwencloud config get output.format para confirmar.

configuração não definida

Exclua um valor de configuração e restaure o comportamento padrão.

qwencloud config unset <key> [--format <auto|table|json|text>]

qwencloud config unset output.format

médico

Verifique a versão, autenticação, token, rede, conclusão do shell e configuração global.

qwencloud doctor [--format <auto|table|json|text>]

qwencloud doctor --format json

Corrija problemas com base nos resultados do diagnóstico e execute novamente qwencloud doctor até que todas as falhas sejam resolvidas.

conclusão da instalação

Instale a conclusão do comando para o shell atual ou especificado.

qwencloud completion install [--shell <bash|zsh|fish>]

qwencloud completion install --shell zsh

geração de conclusão

Produza o script de conclusão para o shell atual ou especificado.

qwencloud completion generate [--shell <bash|zsh|fish>]

qwencloud completion generate --shell bash

Quando --shell for omitido, o shell será detectado automaticamente. Suportado: bash, zsh, peixe.

versão

Versão de saída; --check também verifica se há novas versões.

qwencloud version [--check]

qwencloud version --check

Suporte e atualizações

Enviar e rastrear problemas, fechar ou avaliar tickets ou verificar atualizações da CLI? Escolha sua ação aqui.

lista de suporte

Liste tickets de suporte com paginação.

qwencloud support list [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qwencloud support list --page 1 --page-size 10

visualização de suporte

Veja detalhes do ticket e histórico de mensagens.

qwencloud support view <ticket-id> [--format <auto|table|json|text>]

qwencloud support view TICKET_ID --format json

suporte para criação

Crie um ticket de forma interativa ou não interativa com parâmetros emparelhados.

qwencloud support create [--list-categories] [--category-id <id>] [--description <text>] [--format <auto|table|json|text>]

qwencloud support create --list-categories
qwencloud support create --category-id CATEGORY_ID --description "Issue description"

Requer TTY quando parâmetros não interativos completos não são fornecidos.

Após a criação, salve o ID do ticket retornado e execute qwencloud support view <ticket-id> para acompanhar o progresso.

resposta de suporte

Responder a um ticket; ambientes não interativos devem fornecer o corpo da mensagem.

qwencloud support reply <ticket-id> [--message <text>] [--format <auto|table|json|text>]

qwencloud support reply TICKET_ID --message "Please check the logs"

suporte fechado

Fechar um ticket; scripts devem usar --yes para pular a confirmação.

qwencloud support close <ticket-id> [--yes] [--format <auto|table|json|text>]

qwencloud support close TICKET_ID --yes

taxa de suporte

Avalie um ticket resolvido; a faixa de classificação é de 1 a 5.

qwencloud support rate <ticket-id> [--rating <1|2|3|4|5>] [--comment <text>] [--format <auto|table|json|text>]

qwencloud support rate TICKET_ID --rating 5 --comment "Excellent"

atualização

Verifique a versão e o prompt de atualização de saída; não instala diretamente.

qwencloud update

qwencloud update

Convenções globais

qwencloud [--format <auto|table|json|text>] [--quiet] <area> <verb> [args] [flags]

auto usa tabela em TTY, JSON em pipe/redirect; uma solicitação de tabela explícita em um ambiente não TTY é degradada em texto com um aviso stderr. Os dados de sucesso vão para stdout, erros e diagnósticos vão para stderr. JSON dos comandos de gerenciamento retém campos específicos de comando; resultados bem-sucedidos de invocação de modelo geralmente são {meta,data}. Quando o modelo invocado estiver programado para descontinuação, meta inclui um model_offline_warning campo. Erro JSON não possui campos globalmente uniformes: o campo de código de saída para um local CliError é error.exit_code, enquanto alguns erros de gateway, negócios ou autenticação o omitem. Os scripts devem contar com o código de saída do processo. Converse com --stream --format json gera NDJSON em vez de um envelope de sucesso.

Em consultas paginadas, o JSON normalmente preserva a página solicitada e retorna uma matriz vazia para fora dos limites; tabelas interativas normalmente se ajustam a uma página válida. Os agentes devem sempre especificar --format json, número da página e tamanho da página explicitamente.

Algumas validações locais em comandos específicos reutilizam o código de erro geral 1. O código de saída 8 para invocação de modelo é uma exceção: o vídeo e o ASR assíncrono primeiro gravam o envelope incompleto no stdout e, em seguida, saem com o código 8 sem gravar um erro JSON separado. Os scripts devem inspecionar ambos data.task_status em stdout e o código de saída do processo. Para outras falhas, trate qualquer código de saída diferente de zero como falha e despache em error.code quando disponível.

Apêndice

Folha de dicas de comando