Skip to main content
QwenCloud home page
Docs
Clients & tools

DeepSeek Harness

DeepSeek Harness is an open-source AI Agent framework by DeepSeek, supporting both Web UI and CLI modes. Connect it to QwenCloud using Pay-as-you-go, Coding Plan, Token Plan Personal Edition, or Token Plan Team Edition.

Install DeepSeek Harness

  1. Install Node.js (v18.0 or later).
  2. Run the following command to start the DeepSeek Harness Web UI:
npx @deepseek-ai/dsh web
After execution, the Web UI runs at http://127.0.0.1:3080 by default.

Configure Credentials

Edit the configuration file ~/.dsh/settings.yaml to add a provider and default model. Alternatively, start the Web UI and configure via Settings > Models > Add a custom provider.

Token Plan Personal Edition

Replace YOUR_API_KEY with the Token Plan Personal Edition API Key. For available models, see Token Plan Personal Edition supported models.
SettingValue
Provider IDbailian-tpp
Base URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API KeyToken Plan Personal Edition API Key
ModelEnter a model ID, e.g. qwen3.8-max
You can also directly edit ~/.dsh/settings.yaml: 
agent-default-model:
  provider: bailian-tpp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tpp:
      api: openai-completions
      baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash
Set the environment variable BAILIAN_API_KEY to your Token Plan Personal Edition API Key: 
export BAILIAN_API_KEY="YOUR_API_KEY"
Alternatively, enter the API Key directly in the Web UI under Settings > Models.

Token Plan Team Edition

Replace YOUR_API_KEY with the Token Plan Team Edition API Key. For available models, see Token Plan Team Edition supported models.
SettingValue
Provider IDbailian-tp
Base URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API KeyToken Plan Team Edition API Key
ModelEnter a model ID, e.g. qwen3.8-max
Corresponding ~/.dsh/settings.yaml configuration: 
agent-default-model:
  provider: bailian-tp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tp:
      api: openai-completions
      baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

Coding Plan

Replace YOUR_API_KEY with the Coding Plan API Key. For available models, see Coding Plan supported models.
SettingValue
Provider IDbailian-coding
Base URLhttps://coding-intl.dashscope.aliyuncs.com/v1
API Protocolopenai-completions
API KeyCoding Plan API Key
ModelEnter a model ID, e.g. qwen3.7-plus
Corresponding ~/.dsh/settings.yaml configuration: 
agent-default-model:
  provider: bailian-coding
  model: qwen3.7-plus

llm-pi-ai:
  providers:
    bailian-coding:
      api: openai-completions
      baseURL: https://coding-intl.dashscope.aliyuncs.com/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.7-plus
        - id: qwen3.6-plus

Pay-as-you-go

Replace YOUR_API_KEY with your QwenCloud API Key. For available models, see OpenAI compatible - supported models.
SettingValue
Provider IDbailian
Base URLhttps://dashscope-intl.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API KeyQwenCloud API Key (starts with sk-)
ModelEnter a model ID, e.g. qwen3.7-max
Corresponding ~/.dsh/settings.yaml configuration: 
agent-default-model:
  provider: bailian
  model: qwen3.7-max

llm-pi-ai:
  providers:
    bailian:
      api: openai-completions
      baseURL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

Verify Configuration

After saving the configuration, select your configured model in the Web UI model selector and send a message. If the model responds normally, the configuration is successful.

FAQ

Error codes

If you encounter errors during configuration, refer to the FAQ for the corresponding billing plan:

Fetch available models returns 401

The QwenCloud OpenAI-compatible endpoint does not provide a GET /models API. Clicking Fetch available models returns 401 or 404. You can ignore this button and manually enter the model ID in the Model catalog.

MISSING_CREDENTIAL error

Re-enter the API Key in the Web UI under Settings > Models and save; or confirm that the BAILIAN_API_KEY environment variable is set and restart DeepSeek Harness.
DeepSeek Harness - QwenCloud