From 52d85ddd434ab63c8446768c7d0f09ce287a3bc0 Mon Sep 17 00:00:00 2001
From: theQuert <ga11004@cs.nccu.edu.tw>
Date: Mon, 19 Jan 2026 14:35:00 +0800
Subject: [PATCH 1/3] feat: add Apertis provider loader

Add custom loader for Apertis AI provider with standard headers.
Apertis uses OpenAI-compatible API at https://api.apertis.ai/v1

Fixes #9354
---
 packages/opencode/src/provider/provider.ts | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/opencode/src/provider/provider.ts b/packages/opencode/src/provider/provider.ts
index bcb115edf41..a7f10afe514 100644
--- a/packages/opencode/src/provider/provider.ts
+++ b/packages/opencode/src/provider/provider.ts
@@ -498,6 +498,17 @@ export namespace Provider {
         },
       }
     },
+    apertis: async () => {
+      return {
+        autoload: false,
+        options: {
+          headers: {
+            "HTTP-Referer": "https://opencode.ai/",
+            "X-Title": "opencode",
+          },
+        },
+      }
+    },
   }
 
   export const Model = z

From 39cf6f16ac32ed816e4273579fe1c981c0f6b544 Mon Sep 17 00:00:00 2001
From: theQuert <ga11004@cs.nccu.edu.tw>
Date: Mon, 19 Jan 2026 15:46:25 +0800
Subject: [PATCH 2/3] docs: add Apertis to provider documentation

---
 packages/web/src/content/docs/providers.mdx | 27 +++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx
index 6022d174a7d..d090e2cccc2 100644
--- a/packages/web/src/content/docs/providers.mdx
+++ b/packages/web/src/content/docs/providers.mdx
@@ -122,6 +122,33 @@ Don't see a provider here? Submit a PR.
 
 ---
 
+### Apertis
+
+1. Head over to [Apertis](https://apertis.ai/), create an account, and generate an API key.
+
+2. Run the `/connect` command and search for **Apertis**.
+
+   ```txt
+   /connect
+   ```
+
+3. Enter your Apertis API key.
+
+   ```txt
+   ┌ API key
+   │
+   │
+   └ enter
+   ```
+
+4. Run the `/models` command to select a model.
+
+   ```txt
+   /models
+   ```
+
+---
+
 ### Amazon Bedrock
 
 To use Amazon Bedrock with OpenCode:

From 515bb25c0c307de31fc89506765191e897db5cc0 Mon Sep 17 00:00:00 2001
From: theQuert <ga11004@cs.nccu.edu.tw>
Date: Mon, 19 Jan 2026 15:59:20 +0800
Subject: [PATCH 3/3] docs: enhance Apertis provider documentation with
 advanced features

- Add comprehensive model list with descriptions (12+ models)
- Include advanced configuration examples
- Document thinking models and their use cases
- Add troubleshooting section for common issues
- Provide guidance on model selection and customization
---
 packages/web/src/content/docs/providers.mdx | 73 +++++++++++++++++++++
 1 file changed, 73 insertions(+)

diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx
index d090e2cccc2..b53839d1c8c 100644
--- a/packages/web/src/content/docs/providers.mdx
+++ b/packages/web/src/content/docs/providers.mdx
@@ -124,6 +124,8 @@ Don't see a provider here? Submit a PR.
 
 ### Apertis
 
+Apertis provides access to 12+ state-of-the-art models including Claude Opus 4.5, GPT-5.2, Gemini 3 Pro, and specialized thinking models for enhanced reasoning capabilities.
+
 1. Head over to [Apertis](https://apertis.ai/), create an account, and generate an API key.
 
 2. Run the `/connect` command and search for **Apertis**.
@@ -147,6 +149,77 @@ Don't see a provider here? Submit a PR.
    /models
    ```
 
+   Available models include:
+   - **Claude Opus 4.5** & **Claude Sonnet 4.5** - Latest Anthropic models with extended thinking variants
+   - **GPT-5.2** series - Including Pro, standard, and Codex variants for code generation
+   - **Gemini 3 Pro Preview** - Google's next-generation multimodal model
+   - **GLM-4.7** - Advanced multilingual model with thinking mode
+   - **Grok Code Fast 1** - Speed-optimized code generation
+   - **Minimax M2.1** - High-performance general-purpose model
+
+#### Advanced Configuration
+
+You can customize Apertis models through your opencode config:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "apertis": {
+      "models": {
+        "claude-opus-4-5-20251101-thinking": {
+          "options": {
+            "maxTokens": 8192,
+            "temperature": 0.7
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### Using Thinking Models
+
+Apertis offers specialized thinking models (indicated by `-thinking` suffix) that provide enhanced reasoning capabilities:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "apertis": {
+      "models": {
+        "claude-sonnet-4.5-20250929-thinking": {},
+        "glm-4.7-thinking": {}
+      }
+    }
+  }
+}
+```
+
+These models excel at:
+- Complex problem-solving and multi-step reasoning
+- Mathematical and logical analysis
+- Code architecture and design decisions
+- Detailed technical explanations
+
+#### Troubleshooting
+
+**Connection Issues:**
+- Verify your API key is valid at [Apertis Dashboard](https://apertis.ai/)
+- Check that the API key has not expired or been revoked
+- Ensure your account has sufficient credits
+
+**Model Not Available:**
+- Some models may require specific account tiers or permissions
+- Visit the Apertis dashboard to check model availability for your account
+- Try selecting a different model from the `/models` command
+
+**Rate Limiting:**
+- Apertis implements rate limits to ensure fair usage
+- If you encounter rate limit errors, wait a few moments before retrying
+- Consider upgrading your account tier for higher rate limits
+
 ---
 
 ### Amazon Bedrock