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ão | Valor a inserir |
|---|---|
| Provedor | Compatível com OpenAI (ou OpenAI com URL base personalizada) |
| URL base / API base | https://api.uncensoredqwen.com/v1 |
| Chave de API | A chave da sua conta |
| ID do modelo | uncensored |
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.
- Observe o saldo. Execute a chamada
/v1/modelsou uma chamada de conclusão curta do terminal, anote o cabeçalhoX-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 emGET /v1/balance. - 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.
