Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

fix(opper): use documented embedding model and verify HTTP contract

Bingxi Zhao (Frank)b75ef2c91e54
diff --git a/deeptutor/services/config/provider_runtime.py b/deeptutor/services/config/provider_runtime.py
index 7b5cd4bc7..692a3f468 100644
--- a/deeptutor/services/config/provider_runtime.py
+++ b/deeptutor/services/config/provider_runtime.py
@@ -299,7 +299,7 @@ EMBEDDING_PROVIDERS: dict[str, EmbeddingProviderSpec] = {
default_api_base=EMBEDDING_PROVIDER_DEFAULT_ENDPOINTS["opper"],
keywords=("opper",),
is_local=False,
- default_model="text-embedding-3-large",
+ default_model="openai/text-embedding-3-large",
default_dim=3072,
),
}
diff --git a/tests/services/config/test_embedding_runtime.py b/tests/services/config/test_embedding_runtime.py
index 6d89e822d..7f8424604 100644
--- a/tests/services/config/test_embedding_runtime.py
+++ b/tests/services/config/test_embedding_runtime.py
@@ -296,7 +296,7 @@ def test_embedding_opper_binding_uses_default_endpoint() -> None:
{
"id": "embedding-m",
"name": "opper",
- "model": "text-embedding-3-large",
+ "model": "openai/text-embedding-3-large",
"dimension": "3072",
}
],
diff --git a/tests/services/embedding/test_opper_contract.py b/tests/services/embedding/test_opper_contract.py
new file mode 100644
index 000000000..00da5df50
--- /dev/null
+++ b/tests/services/embedding/test_opper_contract.py
@@ -0,0 +1,74 @@
+"""Exercise the Opper catalog-to-HTTP path without paid provider calls.
+
+The qualified model ID is documented at
+https://opper.ai/openai/text-embedding-3-large. Transport stubbing validates
+our wire contract, not live availability or whether aliases are accepted.
+"""
+
+from __future__ import annotations
+
+import json
+
+import httpx
+import pytest
+
+from deeptutor.services.config.provider_runtime import EMBEDDING_PROVIDERS
+from deeptutor.services.embedding.client import EmbeddingClient
+from deeptutor.services.embedding.config import get_embedding_config
+
+
+async def test_opper_default_embedding_posts_qualified_model_and_reads_vectors(monkeypatch):
+ spec = EMBEDDING_PROVIDERS["opper"]
+ profile = {
+ "id": "opper-profile",
+ "binding": "opper",
+ "base_url": "",
+ "api_key": "test-opper-key",
+ "models": [
+ {"id": "embedding-model", "model": spec.default_model, "dimension": spec.default_dim}
+ ],
+ }
+ catalog = {
+ "version": 1,
+ "services": {
+ "embedding": {
+ "active_profile_id": profile["id"],
+ "active_model_id": "embedding-model",
+ "profiles": [profile],
+ }
+ },
+ }
+ requests = []
+
+ def respond(request: httpx.Request) -> httpx.Response:
+ requests.append(request)
+ assert request.method == "POST"
+ assert str(request.url) == "https://api.opper.ai/v3/compat/embeddings"
+ assert request.headers["Authorization"] == "Bearer test-opper-key"
+ assert json.loads(request.content) == {
+ "model": "openai/text-embedding-3-large",
+ "input": ["first", "second"],
+ }
+ return httpx.Response(
+ 200,
+ json={
+ "object": "list",
+ "model": "openai/text-embedding-3-large",
+ "data": [
+ {"object": "embedding", "index": 0, "embedding": [0.1] * 3072},
+ {"object": "embedding", "index": 1, "embedding": [0.2] * 3072},
+ ],
+ "usage": {"prompt_tokens": 2, "total_tokens": 2},
+ },
+ )
+
+ real_client = httpx.AsyncClient
+ monkeypatch.setattr(
+ httpx,
+ "AsyncClient",
+ lambda **kwargs: real_client(transport=httpx.MockTransport(respond), **kwargs),
+ )
+ result = await EmbeddingClient(get_embedding_config(catalog=catalog)).embed(["first", "second"])
+ assert result == [[0.1] * 3072, [0.2] * 3072]
+ assert len(requests) == 1