Clientes/opencode
Use a API da Wokey com o opencode
Obtenha uma chave de API da Wokey, aponte o opencode para a base URL da Wokey e confirme a conexão com uma requisição curl.
Atualizado
Nesta páginaexpand_more
Obtenha uma chave de API e a base URLlink
Todos os clientes usam a mesma chave de API da Wokey e a mesma base URL.
Crie uma chave de API
Entre e crie uma chave da plataforma na página API. As chaves de uma mesma conta compartilham o saldo dela.
Criar chave de APIkeyUse a base URL da Wokey
Defina como base URL do cliente o domínio do gateway; a configuração abaixo mostra se é preciso acrescentar /v1.
Configure o clientelink
Um único comando grava o provider da Wokey e muda o modelo padrão para wokey/auto.
export WOKEY_API_KEY="YOUR_API_KEY"
curl -fsSL https://wokey.ai/downloads/opencode/install.sh | sh
opencodeFormatos de API e base URLslink
Quando um mesmo cliente troca de formato de API, pode mudar se a base URL termina em /v1.
| Formato | Base URL | Use para |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi e outros modelos |
Onde é configurado: ~/.config/opencode/opencode.json
Verifique com curllink
Se o cliente mostrar um erro, primeiro descarte problemas com a chave e a base URL usando curl.
opencode usa o formato OpenAI Chat Completions por padrão. Se esta requisição retornar 200, a chave e a base URL estão corretas. Substitua YOUR_API_KEY pela sua chave antes de enviar.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Erros e solução de problemaslink
Primeiro separe os casos de autenticação, saldo, limite de taxa, disponibilidade do modelo e tempo limite do upstream.
invalid api key
A chave está ausente, foi digitada errado, foi excluída, ou os cabeçalhos Authorization / x-api-key são conflitantes.
insufficient balance
O saldo da conta está baixo demais. Recarregue antes de enviar mais requisições.
model_denylisted / account_restricted
As chamadas ao modelo, ou a todos os modelos da conta, estão pausadas após violações repetidas. Veja Taxas de tratamento de violação e restrições.
request_blocked
Esta requisição foi bloqueada antes de chegar ao upstream e não é cobrada, por exemplo o reenvio sem alterações de uma requisição que o modelo acabou de recusar, ou um usuário final pausado (X-End-User-Id). A mensagem de erro diz o que está bloqueado; altere a requisição conforme indicado ou tente de novo mais tarde. As outras requisições não são afetadas.
rate limited
O tráfego está frequente demais. Tente de novo mais tarde ou reduza a concorrência. Se só um modelo, ou um usuário final (X-End-User-Id), continua retornando 429, pode ser um limite temporário após violações.
client disconnected
O cliente fechou a conexão antes de a resposta terminar (código downstream_aborted). Por padrão isso é gratuito. Quando uma conta tem pelo menos 50 desconexões do cliente nas últimas 24 horas e elas representam 10% ou mais das suas requisições, as requisições desconectadas seguintes são cobradas pelo uso que o upstream informou: a entrada processada, incluindo leituras e gravações de cache, e a saída apenas quando o upstream a contabilizou. Uma desconexão antes de o upstream informar qualquer uso continua gratuita. A conta é avisada quando a cobrança começa, e a cobrança para automaticamente em até uma hora quando a taxa de desconexão volta ao normal. A causa comum é um tempo limite do cliente ou do proxy curto demais, ou um programa que cancela requisições antes de terminarem.
upstream unavailable
O serviço do modelo upstream está temporariamente indisponível. Troque de modelo ou tente de novo mais tarde.
upstream timeout
A resposta do upstream excedeu o tempo limite. Encurte o contexto, reduza max_tokens ou tente de novo.
upstream overloaded
O modelo upstream está temporariamente sobrecarregado e a Wokey já tentou de novo por outras rotas (código upstream_overloaded). Não tem relação com o seu saldo. Tente de novo em instantes ou troque de modelo.
Perguntas frequenteslink
- O que o script de instalação altera?
- Ele adiciona um provider chamado wokey a ~/.config/opencode/opencode.json e define o modelo padrão como wokey/auto. Um arquivo existente é antes salvo como opencode.json.bak, e os outros providers nele são mantidos.
- Posso evitar colocar a chave de API no comando?
- Execute o script sem WOKEY_API_KEY definida e ele pede a chave no terminal sem exibi-la. A chave fica armazenada em opencode.json, então não compartilhe esse arquivo.
- Como uso um modelo específico?
- Defina WOKEY_MODEL antes de executar o script, por exemplo export WOKEY_MODEL=claude-opus-5-5, e o modelo padrão passa a ser wokey/claude-opus-5-5. Sem isso, o script usa auto.