302API
接入文档 · 客户端教程 / DSH

DSH 接入 302API：模型配置与图片输入

维护：302API · 更新于 2026-10-19

适用于 DeepSeek Harness（DSH）桌面版的 @deepseek-ai/dsh-llm-pi-ai 插件。通过 OpenAI 兼容接口接入本站，并为支持看图的模型声明图片输入能力。

本文已核对当前 DSH 插件的配置字段及本地报错逻辑，尚未完成图片请求的端到端实测。input: [text, image] 是客户端能力声明，不会让一个不支持图片的模型获得看图能力；实际上游支持情况以请求返回为准。不同版本的设置入口可能不同。

1. 准备地址、密钥与模型

  • 在 302API 控制台创建 API Key，建议单独设置消费限额。
  • 接口类型：openai-completions；本例 Base URL：https://api.302api.com。
  • 模型 ID 必须与本站模型列表一致。本例使用 claude-haiku-5-5。

在 DSH 的密钥或环境变量配置入口设置 ZH_API_KEY，让运行 DSH 的进程能读取它。apiKeyEnv 填的是变量名称，不是真实 Key。macOS 从图标启动的应用不一定继承终端里临时设置的环境变量。

2. 合并到 Profile 的 Patch 配置

在 DSH 当前 Profile 的 Patch 编辑器中，按下面示例配置。最外层是 YAML 数组，缩进用空格。

已有 llm-pi-ai、providers.zh 或 agent-default-model 时，修改对应条目，不要重复追加同名条目，也不要用整段示例覆盖原有 Profile。其他服务商、模型和权限设置保持原样。

最小配置 · YAML
- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      zh:
        displayName: 302API
        apiKeyEnv: ZH_API_KEY
        api: openai-completions
        baseURL: https://api.302api.com
        models:
          - id: claude-haiku-5-5
            name: claude-haiku-5-5
            input: [text, image]
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: zh
    model: claude-haiku-5-5

只想修复现有 Haiku 配置时，在该模型的 id 和 name 下增加这一行即可：

input: [text, image]

这行应与 id、name 保持相同缩进。不要把它放到 providers.zh 的顶层，也不要与生图请求的 modalities 参数混用。

3. 应用配置并重新添加图片

  1. 保存并应用当前 Profile。若客户端没有重新加载入口，退出并重新打开 DSH。
  2. 确认当前会话选择的是 302API 服务商下的 Haiku；模型名称相同不代表服务商相同。
  3. 移除之前添加失败的图片，重新添加一张不含隐私信息的 PNG 或 JPG，发送“请简要描述这张图片”。
  4. 核对回复内容、生成结束状态，以及控制台相同时间和模型的调用记录。

接口检测、图片理解和后台辅助任务可能消耗额度。客户端解除拦截不代表请求成功，也不代表免费。不要将客户私密图片用于排错。

4. 常见问题

现象检查方式
“当前模型不支持图片，请切换支持图片的模型”DSH 在发送前检查到模型能力列表不含 image。核对当前模型的 input 字段、所用插件与 Profile 是否已应用。
配置了 image，仍提示不支持确认改的是 Pi AI 插件下实际选中的服务商和模型；检查是否有重复配置条目或后续覆盖。本文的 input 写法不能直接用于其他插件。
没有本地提示，但接口返回 400／不支持图片请求可能已发到服务端。保留报错、时间、模型和请求编号，核对当前渠道的图片输入支持及格式；不要仅靠修改客户端能力声明绕过。
认证失败检查 ZH_API_KEY 是否对 DSH 进程可见、本站 Key 是否有效；不要在截图中展示密钥。
文字可用，图片失败文本成功不等于图片路径可用。分别排查客户端声明、图片格式和大小、模型及渠道支持。

5. 添加其他模型

在 models 列表里追加本站当前可用的模型 ID。只有确认模型及所用渠道支持图片输入时，才为该模型增加 input: [text, image]；不要批量为所有模型开启。

本文讲的是发送图片让模型理解，不包含生成或编辑图片。后者使用不同的模型和接口，请阅读图片生成与编辑文档。

继续阅读