Use a API da Wokey com o DeepSeek Harness

1. 1

   Instale a pré-versão 0.2.1

   A tag latest do npm ainda é 0.2.0; a DeepSeek recomenda v0.2.1-rc.1 ou posterior para o V4.1-Flash-1017, então instale @next.

2. 2

   Defina a variável da chave de API

   A configuração só indica apiKeyEnv, então a chave nunca fica no arquivo. Você também pode salvar a chave em Settings → Models na interface web.

3. 3

   Adicione o provider

   Edite ~/.dsh/profiles/web/cordis.patch.yml (profiles/headless para dsh headless). Este exemplo usa Anthropic Messages para os dois modelos, com https://api.wokey.ai como base URL. Se você preferir OpenAI Chat Completions, crie um provider separado e use https://api.wokey.ai/v1.

4. 4

   Declare a entrada de imagem

   O DeepSeek Harness trata um modelo personalizado não declarado como somente texto, então pode recusar uma imagem antes de a Wokey ver a requisição, mesmo que o modelo na Wokey suporte visão. Para Opus 5.5, Haiku 5.5 ou qualquer outro modelo com visão, adicione input: [text, image] sob esse modelo; na interface, use Settings → Models → editar o provider → Customized settings → expandir a linha do modelo → Input types → Image. Salve e inicie uma nova sessão.

5. 5

   Mantenha os providers existentes

   Essa sobrescrita substitui toda a config da entrada llm-pi-ai, então, se você já adicionou providers na interface, liste-os também sob providers. Use espaços em toda indentação e não misture tabs no YAML. Inicie uma nova sessão depois de salvar.

# 1. Instalar ou atualizar para 0.2.1
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            input: [text, image]
          - id: deepseek-v4.1-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: claude-opus-5-5

# 3. Iniciar
dsh web

Onde é configurado: ~/.dsh/profiles/web/cordis.patch.yml

A Wokey oferece as interfaces de inferência do modelo listadas nesta página, não os endpoints independentes /v1/tools/search ou /v1/tools/fetch. Suportar chamada de ferramentas não significa suportar toda ferramenta web nativa do upstream. A busca no lado do servidor dentro das requisições ao modelo depende da rota de fornecimento real e atualmente não está listada como um recurso da Wokey verificado e suportado de forma uniforme; esta página não publica um preço da Wokey por chamada de Search/Fetch. Para busca e fetch independentes com suporte documentado, use uma chave de API da DeepSeek com api.deepseek.com, configurada e cobrada separadamente das chamadas de modelo da Wokey.

• “The current model does not support images”: é a verificação local de capacidades do Harness; não significa que a Wokey ou o Opus 5.5 não tenham visão. Ative Image para esse modelo ou adicione input: [text, image] à entrada dele no YAML.
• As imagens continuam sendo recusadas depois de salvar: inicie uma nova sessão e selecione o modelo de novo; uma sessão existente mantém a capacidade do modelo e os anexos que registrou.
• A requisição com imagem retorna 400: alinhe o protocolo e a base URL. Anthropic Messages usa https://api.wokey.ai sem /v1; OpenAI Chat Completions usa https://api.wokey.ai/v1. deepseek-v4.1-flash suporta os dois formatos, mas o cliente ainda precisa enviar a estrutura do protocolo escolhido.
• O app não inicia ou informa um número de linha do YAML: verifique se input está aninhado sob o modelo certo, se todos os hífens de modelo estão alinhados e se o arquivo não tem tabs. Restaure um backup e salve de novo usando só espaços.
• O app inicia com “Select a model”: verifique se agent-default-model ainda aponta para um provider e um modelo que existem. Atualize-o depois de excluir ou renomear um provider.
• O modelo aparece após a descoberta, mas sem capacidade de imagem: Fetch available models preenche principalmente os IDs e os campos de capacidade. Declare explicitamente input: [text, image] para cada modelo personalizado com visão, em vez de marcar todos os modelos como compatíveis com visão.
• Outros providers sumiram depois de salvar: uma sobrescrita em cordis.patch.yml substitui toda a entrada llm-pi-ai, então mantenha todos os providers existentes sob providers.

DeepSeek Harness 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": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

O baseURL do DeepSeek Harness deve terminar em /v1?

Depende do campo api do provider. Com anthropic-messages use https://api.wokey.ai sem /v1; OpenAI Chat Completions precisa de um provider separado com https://api.wokey.ai/v1.

Por que diz que o modelo atual não suporta imagens?

É uma verificação local de capacidades no Harness: modelos personalizados declaram apenas entrada de texto por padrão. Adicione input: [text, image] à entrada do modelo, salve e tente de novo em uma nova sessão.

Por que meus outros providers sumiram depois de salvar?

A sobrescrita llm-pi-ai em cordis.patch.yml substitui a entrada inteira. Escreva os providers que você já tinha em providers junto com a Wokey.