CA云上创造CA云上创造
模型广场API 文档邀请返现实时价格实时折扣使用排行榜常见问题
接入指南

DeepSeek Harness

把 CA云上创造 配成 DeepSeek Harness 的 OpenAI 兼容模型提供方，然后 dsh web 启动 Web 界面。

DeepSeek Harness（命令名 dsh）支持配置 OpenAI 兼容的模型提供方。完成本节配置后，可以在 DeepSeek Harness 中通过 CA云上创造 调用 deepseek-flash、deepseek-flash-free、deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-free、gpt-6-astra、gpt-5.6-sol 等模型，并继续使用 Harness 的 Web 界面、会话和 Agent 能力。

支持的模型

  • ·DeepSeek：deepseek-flash（DeepSeek V4.1 Flash）、deepseek-flash-free（福利版）、deepseek-v4-pro（0813 正式版）、deepseek-v4-flash（0731 正式版）、deepseek-v4-flash-free
  • ·GPT：gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、gpt-5.5

1. 准备工作

开始前，请安装 Node.js 24，并准备好一个可用的 CA云上创造 API Key。

1.1 安装 Node.js 24

DeepSeek Harness 要求使用 Node.js 24。npm 会随 Node.js 一起安装，请根据自己的操作系统和 CPU 架构下载安装包：

  • ·Node.js 国内官网
  • ·Node.js 官方下载

使用国内镜像时，请在目录中选择 v24.x.x 版本，再下载适合当前系统的安装包。安装完成后，重新打开终端并检查版本：

bash
node --version
npm --version

node --version 的输出应以 v24. 开头。

1.2 准备 CA API Key

API Key 以 sk- 开头，可以在 CA云上创造 控制台创建：创建 CA API Key。

2. 一键配置并启动

无需打开或手动修改任何配置文件。先在代码块中把 sk-请替换成你的真实Key 替换成你自己的 CA API Key，再复制整段命令到终端运行。命令会自动完成安装、配置并启动 DeepSeek Harness。

macOS / Linux

bash
bash << 'CA_SETUP'
set -e

npm install -g @deepseek-ai/dsh
CA_API_KEY="sk-请替换成你的真实Key"
export CA_API_KEY

NODE_PATH="$(npm root -g)/@deepseek-ai/dsh/node_modules" node << 'NODE'
const fs = require('fs');
const os = require('os');
const path = require('path');
const yaml = require('js-yaml');

const home = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
const settingsPath = path.join(home, 'settings.yaml');
fs.mkdirSync(home, { recursive: true });

const current = fs.existsSync(settingsPath)
  ? (yaml.load(fs.readFileSync(settingsPath, 'utf8')) || {})
  : {};

if (fs.existsSync(settingsPath)) {
  fs.copyFileSync(settingsPath, settingsPath + '.bak.' + Date.now());
}

current['llm-pi-ai'] ??= {};
current['llm-pi-ai'].providers ??= {};
current['llm-pi-ai'].providers.ca = {
  displayName: 'CA云上创造',
  apiKeyEnv: 'CA_API_KEY',
  api: 'openai-completions',
  baseURL: 'https://caapi.top/v1',
  models: [
    { id: 'deepseek-flash', name: 'DeepSeek V4.1 Flash' },
    { id: 'deepseek-flash-free', name: 'DeepSeek V4.1 Flash Free' },
    { id: 'deepseek-v4-pro', name: 'DeepSeek V4 Pro' },
    { id: 'deepseek-v4-flash', name: 'DeepSeek V4 Flash' },
    { id: 'deepseek-v4-flash-free', name: 'DeepSeek V4 Flash Free' },
    { id: 'gpt-6-astra', name: 'GPT 6 Astra' },
    { id: 'gpt-5.6-sol', name: 'GPT 5.6 Sol' },
    { id: 'gpt-5.6-luna', name: 'GPT 5.6 Luna' },
    { id: 'gpt-5.6-terra', name: 'GPT 5.6 Terra' },
    { id: 'gpt-5.5', name: 'GPT 5.5' },
  ],
};
current['agent-default-model'] = {
  provider: 'ca',
  model: 'deepseek-flash-free',
};

fs.writeFileSync(
  settingsPath,
  yaml.dump(current, { lineWidth: -1, noRefs: true }),
  { mode: 0o600 },
);

const envPath = path.join(home, '.env');
const oldLines = fs.existsSync(envPath)
  ? fs.readFileSync(envPath, 'utf8').split(/\r?\n/)
  : [];
const lines = oldLines.filter(
  (line) => line && !line.startsWith('CA_API_KEY='),
);
lines.push('CA_API_KEY=' + process.env.CA_API_KEY);
fs.writeFileSync(envPath, lines.join('\n') + '\n', { mode: 0o600 });

console.log('CA云上创造 配置完成，默认模型：deepseek-flash-free');
NODE

dsh web
CA_SETUP

Windows PowerShell

powershell
npm install -g @deepseek-ai/dsh

$env:CA_API_KEY = 'sk-请替换成你的真实Key'
$env:NODE_PATH = "$(npm root -g)\@deepseek-ai\dsh\node_modules"

@'
const fs = require('fs');
const os = require('os');
const path = require('path');
const yaml = require('js-yaml');

const home = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
const settingsPath = path.join(home, 'settings.yaml');
fs.mkdirSync(home, { recursive: true });

const current = fs.existsSync(settingsPath)
  ? (yaml.load(fs.readFileSync(settingsPath, 'utf8')) || {})
  : {};

if (fs.existsSync(settingsPath)) {
  fs.copyFileSync(settingsPath, settingsPath + '.bak.' + Date.now());
}

current['llm-pi-ai'] ??= {};
current['llm-pi-ai'].providers ??= {};
current['llm-pi-ai'].providers.ca = {
  displayName: 'CA云上创造',
  apiKeyEnv: 'CA_API_KEY',
  api: 'openai-completions',
  baseURL: 'https://caapi.top/v1',
  models: [
    { id: 'deepseek-flash', name: 'DeepSeek V4.1 Flash' },
    { id: 'deepseek-flash-free', name: 'DeepSeek V4.1 Flash Free' },
    { id: 'deepseek-v4-pro', name: 'DeepSeek V4 Pro' },
    { id: 'deepseek-v4-flash', name: 'DeepSeek V4 Flash' },
    { id: 'deepseek-v4-flash-free', name: 'DeepSeek V4 Flash Free' },
    { id: 'gpt-6-astra', name: 'GPT 6 Astra' },
    { id: 'gpt-5.6-sol', name: 'GPT 5.6 Sol' },
    { id: 'gpt-5.6-luna', name: 'GPT 5.6 Luna' },
    { id: 'gpt-5.6-terra', name: 'GPT 5.6 Terra' },
    { id: 'gpt-5.5', name: 'GPT 5.5' }
  ]
};

current['agent-default-model'] = {
  provider: 'ca',
  model: 'deepseek-flash-free'
};

fs.writeFileSync(
  settingsPath,
  yaml.dump(current, { lineWidth: -1, noRefs: true }),
  { mode: 0o600 }
);

const envPath = path.join(home, '.env');
const oldLines = fs.existsSync(envPath)
  ? fs.readFileSync(envPath, 'utf8').split(/\r?\n/)
  : [];
const lines = oldLines.filter(
  (line) => line && !line.startsWith('CA_API_KEY=')
);
lines.push('CA_API_KEY=' + process.env.CA_API_KEY);
fs.writeFileSync(envPath, lines.join('\n') + '\n', { mode: 0o600 });

console.log('CA云上创造 配置完成，默认模型：deepseek-flash-free');
'@ | node

if ($LASTEXITCODE -eq 0) {
  dsh web
}

命令会自动完成安装、备份并合并现有配置、保存 Key、设置 CA云上创造 模型，然后启动 DeepSeek Harness。它不会删除已有的主题或其他设置。

启动成功后，终端会显示本地地址，默认通常为 http://127.0.0.1:3080。在浏览器打开该地址并新建会话即可使用。以后再次启动时，只需在项目目录运行：

bash
dsh web

如需在指定项目中使用，请先进入项目的真实目录再运行 dsh web。不要直接照抄 /path/to/my-project，它只是占位符。

3. 验证接入

可以先用 Headless 模式发送一条最小请求，验证配置、Key 和模型是否都可用：

bash
export CA_API_KEY="sk-xxxxxx"
dsh --profile headless "只回复 OK"

如果终端返回 OK，说明 DeepSeek Harness 已经通过 CA云上创造 成功调用模型。随后运行 dsh web 即可进入 Web 界面。

4. 添加和切换其他模型

如果需要在 Harness 中选择多个 CA云上创造 模型，可以在同一个 models 列表中继续添加模型。以下示例同时提供 DeepSeek V4.1 Flash、DeepSeek V4 付费与免费模型，以及多个 GPT 模型：

yaml
llm-pi-ai:
  providers:
    ca:
      displayName: CA云上创造
      apiKeyEnv: CA_API_KEY
      api: openai-completions
      baseURL: https://caapi.top/v1
      models:
        - id: deepseek-flash
          name: DeepSeek V4.1 Flash
        - id: deepseek-flash-free
          name: DeepSeek V4.1 Flash Free
        - id: deepseek-v4-pro
          name: DeepSeek V4 Pro
        - id: deepseek-v4-flash
          name: DeepSeek V4 Flash
        - id: deepseek-v4-flash-free
          name: DeepSeek V4 Flash Free
        - id: gpt-6-astra
          name: GPT 6 Astra
        - id: gpt-5.6-sol
          name: GPT 5.6 Sol
        - id: gpt-5.6-luna
          name: GPT 5.6 Luna
        - id: gpt-5.5
          name: GPT 5.5
        - id: gpt-5.4
          name: GPT 5.4

agent-default-model:
  provider: ca
  model: deepseek-flash-free

修改 agent-default-model.model 可以更换新会话的默认模型。已经创建的会话可能继续沿用原模型，因此修改默认模型后，建议刷新页面并新建会话；也可以在界面的模型选择器中手动切换。

CA云上创造 的模型列表会持续更新。需要确认实时模型 ID 时，可调用：

bash
curl https://caapi.top/v1/models \
  -H "Authorization: Bearer sk-xxxxxx"

5. 常见问题

返回 `401` 或 `invalid_bearer_token`。 请确认 API Key 完整、没有多余空格、尚未被删除，并确认它以 sk- 开头。如仍失败，请在 CA云上创造 控制台新建 Key 后重试。

提示 `MISSING_CREDENTIAL`。 DSH 没有读取到 CA_API_KEY。请在设置环境变量的同一个终端窗口中运行 dsh web，不要先关闭窗口再从其他位置启动。

提示未知模型或模型不在列表中。 请确认模型 ID 已写入 settings.yaml 的 models 列表，并通过 GET /v1/models 核对当前模型 ID。

修改默认模型后仍在使用旧模型。 默认模型只保证用于新会话。请新建会话，或在当前会话中手动切换模型。

端口 3080 已被占用。 可以改用其他端口：

bash
dsh web --port 3081

GPT 的推理参数表现异常。 GPT 接入时不要在 CA云上创造 provider 上配置 compat.thinkingFormat: deepseek。该字段用于 DeepSeek 模型的推理格式，不适用于 GPT。若同一 provider 同时配置 GPT 和 DeepSeek，应仅将该字段写在对应的 DeepSeek 模型条目下。

6. Key 安全

不要把真实 API Key 写入项目源码、提交到 Git、打包进前端应用或发送到公开聊天中。推荐通过 CA_API_KEY 环境变量传入。若怀疑 Key 已泄露，请立即在 CA云上创造 控制台删除旧 Key 并创建新 Key。

相关文档：CA云上创造 API 接入文档。

上一篇Gemini CLI下一篇API 接入总览

共 50 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。