feat: add Qiniu provider support (#172)

Co-authored-by: JiangZhuo <jiangzhuo@qiniu.com>

Author: JackChiang233

openjudge/models/__init__.py

@@ -6,11 +6,13 @@
 from openjudge.models.base_chat_model import BaseChatModel
 from openjudge.models.minimax_chat_model import MiniMaxChatModel
 from openjudge.models.openai_chat_model import OpenAIChatModel
+from openjudge.models.qiniu_chat_model import QiniuChatModel
 from openjudge.models.qwen_vl_model import QwenVLModel
 
 __all__ = [
     "BaseChatModel",
     "MiniMaxChatModel",
     "OpenAIChatModel",
+    "QiniuChatModel",
     "QwenVLModel",
 ]

openjudge/models/qiniu_chat_model.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+"""Qiniu Chat Model."""
+
+import os
+from typing import Any, Dict
+
+from openjudge.models.openai_chat_model import OpenAIChatModel
+
+# Qiniu-supported default model list
+QINIU_MODELS = [
+    "deepseek-v3",
+]
+
+
+class QiniuChatModel(OpenAIChatModel):
+    """Qiniu chat model using the OpenAI-compatible API gateway."""
+
+    QINIU_BASE_URL = "https://api.qnaigc.com/v1"
+
+    def __init__(
+        self,
+        model: str = "deepseek-v3",
+        api_key: str | None = None,
+        base_url: str | None = None,
+        stream: bool = False,
+        client_args: Dict[str, Any] | None = None,
+        max_retries: int | None = None,
+        timeout: float | None = None,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize the qiniu chat model."""
+        resolved_api_key = api_key or os.getenv("QINIU_API_KEY")
+        resolved_base_url = base_url or self.QINIU_BASE_URL
+
+        super().__init__(
+            model=model,
+            api_key=resolved_api_key,
+            base_url=resolved_base_url,
+            stream=stream,
+            client_args=client_args,
+            max_retries=max_retries,
+            timeout=timeout,
+            **kwargs,
+        )
+
+
+__all__ = ["QiniuChatModel", "QINIU_MODELS"]

tests/models/test_qiniu_chat_model.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Unit tests for QiniuChatModel."""
+
+import pytest
+
+from openjudge.models import QiniuChatModel
+from openjudge.models.qiniu_chat_model import QINIU_MODELS
+
+
+@pytest.mark.unit
+class TestQiniuChatModelInit:
+    """Verify constructor defaults and argument handling."""
+
+    def test_default_base_url(self):
+        model = QiniuChatModel(api_key="test-key")
+        assert model.client.base_url is not None
+        assert "qnaigc.com" in str(model.client.base_url)
+
+    def test_default_model(self):
+        model = QiniuChatModel(api_key="test-key")
+        assert model.model == "deepseek-v3"
+
+    def test_qiniu_models_contains_deepseek_v3(self):
+        assert "deepseek-v3" in QINIU_MODELS
+
+    def test_api_key_from_env(self, monkeypatch):
+        monkeypatch.setenv("QINIU_API_KEY", "env-key-123")
+        model = QiniuChatModel()
+        assert model.client.api_key == "env-key-123"
+
+    def test_explicit_api_key_overrides_env(self, monkeypatch):
+        monkeypatch.setenv("QINIU_API_KEY", "env-key")
+        model = QiniuChatModel(api_key="explicit-key")
+        assert model.client.api_key == "explicit-key"
+
+    def test_custom_base_url(self):
+        model = QiniuChatModel(api_key="k", base_url="https://custom.qnaigc.com/v1")
+        assert "custom.qnaigc.com" in str(model.client.base_url)
+
+
+@pytest.mark.unit
+class TestQiniuChatModelInheritance:
+    """Verify class hierarchy and exported symbols."""
+
+    def test_inherits_from_openai_chat_model(self):
+        from openjudge.models.openai_chat_model import OpenAIChatModel
+
+        assert issubclass(QiniuChatModel, OpenAIChatModel)
+
+    def test_exported_from_models_package(self):
+        from openjudge.models import QiniuChatModel as Imported
+
+        assert Imported is QiniuChatModel

ui/shared/constants.py

@@ -20,6 +20,7 @@
     "DashScope": "https://dashscope.aliyuncs.com/compatible-mode/v1",
     "OpenAI": "https://api.openai.com/v1",
     "DeepSeek": "https://api.deepseek.com/v1",
+    "Qiniu": "https://api.qnaigc.com/v1",
     "Custom": "",
 }
 
@@ -39,6 +40,7 @@
     "o3-mini",
     "o4-mini",
     # DeepSeek
+    "deepseek-v3",
     "deepseek-v3.2",
     "deepseek-r1",
 ]