Skip to content

dsh-sub2api

⭐ 2 · ✅ active · plugin
Type plugin Category Vision & multimodal
Stars ⭐ 2 Status ✅ active
Author GodD6366 Updated —
Subcategory 👁️ Vision tools Capabilities coding

One-liner

Connect your sub2api gateway to DeepSeek Harness: OpenAI-compatible multi-provider routes (OpenAI / Claude / Grok / Gemini) behind one base URL, with per-key model discovery, usage lookup, and a settings page.

About

中文文档 Connect your sub2api gateway to DeepSeek Harness as model providers. Sub2API is an AI API gateway that turns subscription quota into OpenAI-compatible endpoints. In its model, each API key is bound to a group, and the group decides the platform (OpenAI / Claude / Grok / Gemini) and the models that key can serve. The four provider routes (sub2api-openai, sub2api-claude, sub2api-grok, sub2api-gemini) are served by the harness's own pi-ai adapter (dsh-llm-pi-ai): this plugin translates its llm-sub2api: settings into llm-pi-ai: provider profiles (all sharing one bare-host base URL, no /v1), and protocol serialization, streaming, and usage accounting all live in pi-ai. The

✨ Key Features

  • One base URL, four provider routes: sub2api-openai, sub2api-claude, sub2api-grok, sub2api-gemini — each configured with its own key, registered as a
  • Streaming chat (backed by pi-ai): SSE streaming, tool calls, reasoning deltas, and token usage are mapped to the harness protocol by dsh-llm-pi-ai, which
  • Model discovery: one-click "fetch models" calls GET {baseURL}/models with the key, so each route's catalog matches exactly what the sub2api group serves.
  • Reasoning effort (thinking mode): reasoning_effort is passed straight through to the gateway and adjustable right in the chat model selector; the settings
  • Usage lookup: "view usage" calls GET {baseURL}/usage and summarizes quota, balance, rate limits, and subscription windows.
  • Standards-based config: base URL and model catalogs live in the llm-sub2api: settings section ($DSH_HOME/settings.yaml, written by the web Models page);
  • Global vision / image tools: analyze_image and generate_image stay available even when the current chat model cannot see or create images. They call a d
  • Auto Vision wrapper: image capability for text-only models. Every registered text-only provider route gets a same-name twin (<route>-vision, shown as "… +

📦 Install

dsh plugin --profile web add @godd6366/dsh-sub2api

🚀 Quick Start

dsh plugin --profile web add .

📚 Learn more

Install

dsh plugin --profile web add @godd6366/dsh-sub2api or, from this repository: dsh plugin --profile web add .

Configure

Open Settings → Sub2API 模型 (or edit $DSH_HOME/settings.yaml directly): llm-sub2api: baseURL: http://localhost:8080 providers: openai: apiKeyEnv: SUB2API_OPENAI_API_KEY models: - id: gpt-4o claude: apiKeyEnv: SUB2API_CLAUDE_API_KEY grok: apiKeyEnv: SUB2API_GROK_API_KEY gemini: apiKeyEnv: SUB2API_GEMINI_API_KEY tools: analyze: provider: openai model: gpt-4o generate: provider: openai model: gp