配置 / Configuration

- id: free-vision
  name: 'dsh-free-vision'
  config:
    apiKey: 'sk-xxxx'        # 可选：缺省回退到提供商环境变量
    baseURLs: {}             # 可选：按 Provider 覆盖 API Base URL，例如 { qwen: 'https://my-proxy.example.com/v1' }
    modelProvider: qwen      # qwen | volcengine | siliconflow | zhipu | hunyuan | custom
    modelName: qwen3-vl-flash # 可选模型覆盖
    toolName: image_understand # 工具公开名（冲突时可改名）
    maxTokens: 8192
    temperature: 0.7
    multiCrop: true
    toolCallTimeoutMs: 200000
    lumaEnv: {}              # 传递给视觉引擎的额外环境变量

也可以只设置对应的环境变量（如 DASHSCOPE_API_KEY）。 Or just set the matching environment variable (e.g. DASHSCOPE_API_KEY).

覆盖 API 地址 / Base URL override

当 baseURLs 缺失或值为空时，继续使用该 Provider 的官方默认地址。

Provider	默认 Base URL
qwen	`https://dashscope.aliyuncs.com/compatible-mode/v1`
volcengine	`https://ark.cn-beijing.volces.com/api/v3`
siliconflow	`https://api.siliconflow.cn/v1`
zhipu	`https://open.bigmodel.cn/api/paas/v4`
hunyuan	`https://api.hunyuan.cloud.tencent.com/v1`

引擎会自动拼接 /chat/completions 并避免重复路径，因此以下写法都可用：

https://my-proxy.example.com/v1
https://my-proxy.example.com/v1/chat/completions

也可以使用环境变量：QWEN_BASE_URL、VOLCENGINE_BASE_URL、 SILICONFLOW_BASE_URL、ZHIPU_BASE_URL、HUNYUAN_BASE_URL （以及 custom 的 CUSTOM_BASE_URL）。

免费 Key 申请 / Free API keys

提供商	免费 Key 获取
qwen	阿里云百炼 bailian.console.aliyun.com — 开通即送免费额度，模型选 qwen3-vl-flash（限免）
volcengine	火山引擎 volcengine.com — 豆包新用户送免费 token（20万起，可申请 50万）
siliconflow	硅基流动 siliconflow.cn — DeepSeek-OCR 免费调用

用法 / Usage

模型调用 image_understand 时传入：

image_source（必填）：本地路径、HTTP(S) URL 或 data URI（PNG/JPG/WebP/GIF，≤10MB）
prompt（必填）：对图片的问题 — 中英文均可
task_type（可选）：auto | general | ocr | ui | debug | describe

dsh-free-vision

安裝

說明文件

配置 / Configuration

覆盖 API 地址 / Base URL override

免费 Key 申请 / Free API keys

用法 / Usage