Clientes/WorkBuddy

Use a API da Wokey com o WorkBuddy

Obtenha uma chave de API da Wokey, aponte o WorkBuddy 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 APIkey

Use 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

O WorkBuddy usa OpenAI Chat Completions para modelos personalizados. No WorkBuddy, abra Settings → Model → Custom models e informe o endpoint da Wokey, a chave de API e deepseek-v4.1-flash; assim as tarefas e os fluxos de agente do WorkBuddy podem usar chamadas de ferramentas e entrada de imagem.

  1. 1

    Abra as configurações de modelo

    Clique no botão da conta no canto inferior esquerdo do WorkBuddy → Settings → Model. Você também pode abrir o seletor de modelos e escolher Configure custom model.

  2. 2

    Adicione um modelo personalizado

    Escolha Custom. Defina o endpoint como https://api.wokey.ai, cole sua chave de API da Wokey e informe o ID exato do modelo deepseek-v4.1-flash (o ID antigo deepseek-flash também funciona).

  3. 3

    Defina as capacidades

    Ative chamadas de ferramentas e entrada de imagem. Deixe o modo de raciocínio e o protocolo personalizado desativados. deepseek-v4.1-flash aceita texto, imagens e ferramentas; se você usar deepseek-v4-flash, desative a entrada de imagem, porque esse modelo aceita só texto.

  4. 4

    Salve e troque de modelo

    Execute Test connection, salve o modelo e selecione-o no seletor de modelos da conversa. Comece com um prompt de texto curto antes de testar ferramentas ou imagens.

WorkBuddy
Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

Formatos de API e base URLslink

Quando um mesmo cliente troca de formato de API, pode mudar se a base URL termina em /v1.

FormatoBase URLUse para
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi e outros modelos

Onde é configurado: Settings → Models → Custom models

Solução de problemas comunslink

  • 404: mantenha o endpoint em https://api.wokey.ai e o protocolo personalizado desativado. Só com o protocolo personalizado ativado você deve informar o caminho completo https://api.wokey.ai/v1/chat/completions.
  • 401: cole a chave em si no campo API key; não adicione o prefixo Bearer. Confirme que a chave está ativa e que a conta tem saldo.
  • model_not_found: defina o ID do modelo como deepseek-v4.1-flash, sem espaços nem sufixos extras.
  • Requisições com imagem falham: selecione deepseek-v4.1-flash e ative a entrada de imagem. deepseek-v4-flash aceita só texto.
  • 429, 502, 504 ou 529: reduza a concorrência, encurte o contexto ou tente de novo mais tarde; você também pode trocar para outro modelo disponível.

Verifique com curllink

Se o cliente mostrar um erro, primeiro descarte problemas com a chave e a base URL usando curl.

WorkBuddy 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
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "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.

401

invalid api key

A chave está ausente, foi digitada errado, foi excluída, ou os cabeçalhos Authorization / x-api-key são conflitantes.

402

insufficient balance

O saldo da conta está baixo demais. Recarregue antes de enviar mais requisições.

403

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.

403

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.

429

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.

499

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.

502

upstream unavailable

O serviço do modelo upstream está temporariamente indisponível. Troque de modelo ou tente de novo mais tarde.

504

upstream timeout

A resposta do upstream excedeu o tempo limite. Encurte o contexto, reduza max_tokens ou tente de novo.

529

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 endereço de API no WorkBuddy deve terminar em /v1?
Não. Use https://api.wokey.ai e mantenha desligada a chave de protocolo personalizado. Só com o protocolo personalizado ligado você informa o endereço completo https://api.wokey.ai/v1/chat/completions; uma combinação errada retorna 404.
O que vai no nome do modelo?
O ID exato do modelo, por exemplo deepseek-v4.1-flash, sem espaços nem sufixos. Qualquer outra coisa retorna model_not_found.
Por que as requisições com imagem falham?
Verifique se o modelo é deepseek-v4.1-flash e se a chave de entrada de imagem está ligada. deepseek-v4-flash é um modelo de texto, então desligue a entrada de imagem ao usá-lo.