PT ▾
Obter chave de API

uncensoredqwen.comGuia

Chave de API Qwen para VS Code: Configuração de endpoint personalizado

Para usar uma chave de API qwen para VS Code, você não precisa de um plugin específico da Alibaba. Qualquer extensão que suporte um provedor compatível com OpenAI aceita três valores: uma URL base, uma chave e um nome de modelo. Este guia fornece os valores exatos e as verificações que capturam os erros comuns.

Atualizado

Painel do editor de código isométrico com uma chave dourada conectada a uma tomada de endpoint ligada a um servidor

O que você precisa antes de abrir o VS Code

Uma chave de API qwen para VS Code é apenas uma chave de API mais as configurações de endpoint corretas em uma extensão. Reúna esses três valores primeiro:

  • URL base: https://api.uncensoredqwen.com/v1
  • ID do modelo: uncensored
  • Chave de API: criada na página de chave de API após entrar com Google ou com e-mail e senha

Contas novas podem resgatar $0,50 de crédito de teste com um clique nessa página. Não precisa de cartão, é limitado a um por pessoa e é válido por 7 dias. Isso é suficiente para testar a configuração de um editor por alguns dias de codificação real.

Uma nota sobre nomenclatura: o serviço é um modelo de pesos abertos hospedado por um provedor independente. Não é a API oficial da Alibaba, nem um roteador para outros fornecedores. No seu editor, ele aparece sob o nome de exibição que você der a ele.

Teste a chave com curl primeiro

Antes de alterar qualquer configuração do editor, confirme se a chave e a URL funcionam por conta própria. Se isso falhar, nenhuma extensão terá sucesso, e você saberá que o problema é a chave, e não o plugin.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Uma lista JSON que inclui uncensored significa que a autenticação funciona. Então, envie uma conclusão real:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

Os cabeçalhos de resposta incluem X-Balance-USD, que é uma maneira rápida de ver o crédito restante sem sair do terminal.

Adicione o provedor em uma extensão do VS Code

Várias extensões do VS Code para assistência de codificação com IA podem se comunicar com qualquer servidor compatível com OpenAI. Os rótulos variam um pouco de ferramenta para ferramenta, mas os campos mapeiam um para um. Procure uma escolha de provedor nomeada como "OpenAI Compatible", "OpenAI" com URL base personalizada ou "Endpoint personalizado".

Campo da extensãoValor a inserir
ProvedorCompatível com OpenAI (ou OpenAI com URL base personalizada)
URL base / API basehttps://api.uncensoredqwen.com/v1
Chave de APIA chave da sua conta
ID do modelouncensored

Extensões que leem um arquivo de configuração JSON geralmente querem algo com esta aparência. Os nomes exatos das chaves variam, então verifique a documentação da sua extensão e adapte os nomes dos campos:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Não faça commit deste arquivo. Se suas configurações estiverem dentro de um repositório, use o armazenamento de segredos da extensão ou uma variável de ambiente, e adicione o caminho da configuração ao .gitignore.

Após salvar, abra o painel de chat da extensão e envie uma mensagem curta como "Explique esta função" com um arquivo aberto. Uma resposta em streaming significa que a configuração está concluída.

Corrija os erros comuns de configuração

A maioria das configurações falhas deve a alguns erros de digitação. Percorra esta lista em ordem.

A URL tem o formato errado

A URL base termina em /v1. As extensões adicionam /chat/completions elas mesmas. Se você colar o caminho completo, receberá um 404 porque o cliente solicita /v1/chat/completions/chat/completions. Uma barra final geralmente é inofensiva, mas a falta de /v1 não é.

O nome do modelo está errado

Algumas extensões preenchem automaticamente um menu suspenso de modelo com nomes de outro serviço. Substitua-o por uncensored exatamente, em minúsculas. Se o campo for um menu suspenso sem entrada personalizada, procure uma opção "custom model" ou "other".

A chave tem caracteres estranhos

Copiar de uma página da web pode adicionar um espaço ou nova linha final. Cole em um editor de texto puro, remova espaços extras e cole novamente. Uma resposta 401 quase sempre aponta para isso ou para uma chave de uma conta diferente.

A extensão ainda fala com seu servidor padrão

Se seu saldo não mudar após as requisições de chat, o editor pode estar usando um provedor integrado. Verifique se o perfil do modelo ativo é o que você editou e recarregue a janela após alterar as configurações.

As requisições falham com 429

Esse é um limite de requisições, coberto na próxima seção. O corpo do erro carrega um código que indica qual limite você atingiu.

Verifique se as requisições realmente alcançam a API

Editores raramente dizem a você qual servidor respondeu. Duas verificações rápidas removem a dúvida.

  1. Observe o saldo. Execute a chamada /v1/models ou uma chamada de conclusão curta do terminal, anote o cabeçalho X-Balance-USD, envie três mensagens de chat no editor e repita a chamada no terminal. O número deve cair em uma pequena quantidade. O mesmo valor está disponível em GET /v1/balance.
  2. Peça algo que a configuração padrão recusaria ou trataria de forma diferente. Um teste pequeno e inofensivo é solicitar uma resposta com exatamente cinco palavras. Se a resposta seguir a instrução e chegar em streaming, a conexão está saudável.

Se o saldo não mudar, abra o painel de saída da extensão ou o console do desenvolvedor. A maioria das extensões registra a URL da requisição e o status HTTP, e um host errado aparece imediatamente. Corrija a URL base, recarregue a janela e tente novamente.

Equipes que compartilham um repositório devem fornecer a cada pessoa uma chave separada em vez de um valor compartilhado. Dessa forma, um limite de requisições atingido por uma pessoa não bloqueia as outras, e uma chave vazada pode ser substituída sem perturbar todos os outros.

Autocompletar, chat e limites de requisições

O chat é leve nos limites: uma requisição por mensagem. O autocompletar inline é diferente. Muitas extensões enviam uma requisição após uma pausa curta na digitação, o que pode produzir dezenas de chamadas por minuto enquanto você trabalha.

Conheça os números. Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de teste permite 2 simultâneas e 60 por minuto. Quando você excede esses limites, a API responde com HTTP 429 e o código rate_limited (muitas por minuto) ou concurrency (muitas de uma vez). Em sobrecarga temporária, você também recebe 429 com um cabeçalho Retry-After: 5. Uma conclusão em streaming mantém seu slot de concorrência até o fim do stream, então streams lentos contam contra você por mais tempo.

Configurações práticas que ajudam:

  • Use o serviço para chat, edições e explicações, e desative o autocompletar tab ou aumente seu atraso de debounce enquanto estiver com uma chave de teste.
  • Reduza o número máximo de tokens de saída para autocompletar para algumas dezenas. Conclusões curtas terminam rapidamente e liberam o slot.
  • Evite abrir várias janelas do editor usando a mesma chave durante o período de teste.

Requisições com falha ou recusadas não são cobradas, então erros custam apenas tempo.

Custo de uma sessão de codificação

Prompts de programação são pesados em entrada porque as extensões anexam conteúdos de arquivos. O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Considere uma interação de chat que envia 6.000 tokens de código e contexto e recebe 800 tokens de volta:

  • Entrada: 6.000 x $0,15 / 1.000.000 = $0,0009
  • Saída: 800 x $0,50 / 1.000.000 = $0,0004
  • Total: $0.0013 por turno

A 100 dessas interações em um dia de trabalho, o custo é $0,13. O crédito de teste de $0,50 cobre aproximadamente 380 interações desse tamanho ($0,50 / $0,0013 é cerca de 385). O crédito é pré-pago, nunca expira, e as recargas são valores cheios de $20 a $500, com um bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200. Veja a página de preços para métodos de pagamento.

A janela de contexto é de 100.000 tokens, prompt mais conclusão. Se uma extensão indexar todo o seu repositório em cada prompt, as solicitações grandes custarão mais e se aproximarão desse limite. Restrinja o contexto aos arquivos que você realmente precisa.

Privacidade e onde ler mais

Os prompts não são usados para treinamento. Ainda assim, o código-fonte frequentemente contém segredos, então mantenha os arquivos .env e as credenciais fora dos arquivos que você anexa a um chat. A maioria das extensões permite excluir caminhos do contexto.

O modelo é apenas de texto. Ele responde a perguntas de programação, cria rascunhos de funções, explica erros e suporta chamada de funções e modo JSON, mas não gera imagens, áudio ou vídeo. Para campos de requisição e exemplos além desta página, leia a documentação da API. Se algo ainda falhar após as verificações acima, o artigo anterior sobre erros comuns na API Qwen lista mais padrões de erro com correções.

Perguntas e respostas

Onde obtenho uma chave de API Qwen para o VS Code?

Registre-se no site, abra a página da chave de API e crie uma chave. Você também pode resgatar o crédito de teste de $0,50 com um clique lá, sem necessidade de cartão.

Qual URL base eu insiro na extensão?

Use https://api.uncensoredqwen.com/v1 e não inclua /chat/completions. O ID do modelo é uncensored.

Por que minha extensão retorna 401?

A chave geralmente está errada, tem um espaço solto ou pertence a outra conta. Copie-a novamente e teste com a chamada curl para /v1/models.

Posso usá-lo para autocompletar com tab?

Funciona através de configurações de autocompletar compatíveis com OpenAI, mas solicitações frequentes podem atingir o limite de 60 por minuto da versão de teste. Uma chave completa permite 300 por minuto.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API