ff

content/models/_meta.js

@@ -0,0 +1,5 @@
+export default {
+  openai: "OpenAI",
+  claude: "Claude (Anthropic)",
+  deepseek: "DeepSeek",
+};

content/models/claude.mdx

@@ -0,0 +1,42 @@
+---
+title: Claude 接入
+sidebarTitle: Claude
+description: Anthropic Claude 系列模型接入说明
+---
+
+# Claude (Anthropic) 接入
+
+Claude 模型可通过 **OpenAI 兼容接口** 或 **Anthropic Messages API** 接入（以控制台开通能力为准）。
+
+## OpenAI 兼容方式（推荐迁移）
+
+```bash
+curl https://api.haiyushuke.com/v1/chat/completions \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4-20250514",
+    "messages": [{"role": "user", "content": "总结以下三点：安全、成本、延迟"}]
+  }'
+```
+
+将 `model` 替换为控制台提供的 Claude 模型 ID。
+
+## 系统提示与多轮对话
+
+与 OpenAI 相同，使用 `messages` 数组：
+
+```json
+{
+  "model": "claude-sonnet-4-20250514",
+  "messages": [
+    { "role": "system", "content": "你是企业知识库助手，回答需简洁。" },
+    { "role": "user", "content": "什么是 RAG？" }
+  ]
+}
+```
+
+## 注意事项
+
+- 部分 Claude 特性（如扩展思考、工具调用）需使用对应 API 形态，请参考控制台该模型的「能力标签」。
+- 长上下文模型请留意单次请求的 `max_tokens` 与账单中的输入 token 统计。

content/models/deepseek.mdx

@@ -0,0 +1,32 @@
+---
+title: DeepSeek 接入
+sidebarTitle: DeepSeek
+description: DeepSeek 系列模型接入说明
+---
+
+# DeepSeek 接入
+
+DeepSeek 模型通过统一网关暴露，协议为 **OpenAI Chat Completions 兼容**。
+
+## 示例
+
+```bash
+curl https://api.haiyushuke.com/v1/chat/completions \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "deepseek-chat",
+    "messages": [{"role": "user", "content": "用列表说明大模型网关的三项优势"}]
+  }'
+```
+
+## 模型选择建议
+
+| 场景 | 建议 |
+| --- | --- |
+| 通用对话 / 代码 | `deepseek-chat` |
+| 复杂推理（若已开通） | 控制台标注的 Reasoner 类模型 ID |
+
+## 与 OpenAI SDK 共用配置
+
+仅需修改 `model` 字段，无需更换 SDK；`baseURL` 与 API Key 与 [OpenAI 接入](/docs/models/openai) 相同。

content/models/openai.mdx

@@ -0,0 +1,62 @@
+---
+title: OpenAI 接入
+sidebarTitle: OpenAI
+description: 通过 OpenAI 兼容协议接入 GPT 系列模型
+---
+
+# OpenAI 兼容接入
+
+海宇数科对 OpenAI 官方 SDK 及 HTTP API 提供兼容层，便于现有应用零改造迁移。
+
+## 端点
+
+| 项目 | 值 |
+| --- | --- |
+| Base URL | `https://api.haiyushuke.com/v1` |
+| Chat Completions | `POST /chat/completions` |
+| 鉴权 | `Authorization: Bearer <API_KEY>` |
+
+## Node.js（官方 SDK）
+
+```ts
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  apiKey: process.env.HAIYUSHUKE_API_KEY,
+  baseURL: "https://api.haiyushuke.com/v1",
+});
+
+const completion = await client.chat.completions.create({
+  model: "gpt-4o-mini",
+  messages: [{ role: "user", content: "Hello" }],
+});
+
+console.log(completion.choices[0]?.message?.content);
+```
+
+## Python
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="YOUR_API_KEY",
+    base_url="https://api.haiyushuke.com/v1",
+)
+
+resp = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(resp.choices[0].message.content)
+```
+
+## 常用参数
+
+- `temperature`：0–2，控制随机性
+- `max_tokens`：最大生成 token
+- `stream: true`：开启流式，见 [流式调用](/docs/guides/streaming)
+
+## 模型 ID
+
+请在控制台 **模型广场** 查看当前可用 ID；名称可能随供应商更新，以控制台为准。