AI-Labs 使用指南

适用于 labs.miaoss.ai 用户 · 最后更新：2026-02-17

一、快速开始

访问地址

Web 管理后台：https://labs.miaoss.ai
API 基址：https://labs.miaoss.ai/v1

首次使用流程

打开 https://labs.miaoss.ai
注册 / 登录账号
进入「令牌」→ 创建 API Key
将模型基址替换为 https://labs.miaoss.ai/v1 即可调用

二、获取 API Key

在 Web 端获取

登录 https://labs.miaoss.ai
左侧菜单 → 令牌（Token）
点击「创建令牌」
设置名称、额度、有效期等
创建成功后复制 sk-xxx 开头的密钥（仅首次显示，请妥善保存）

使用 API Key

调用接口时，在请求头中加入：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

三、API 调用示例

3.1 聊天对话（Chat Completions）

接口：POST /v1/chat/completions

cURL 示例：

curl -X POST "https://labs.miaoss.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-oss-120b-medium",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "你好，请介绍一下自己"}
    ]
  }'

Python 示例：

import openai

client = openai.OpenAI(
    api_key="sk-your-api-key",
    base_url="https://labs.miaoss.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-oss-120b-medium",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "你好"}
    ]
)
print(response.choices[0].message.content)

JavaScript 示例：

const response = await fetch("https://labs.miaoss.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-your-api-key"
  },
  body: JSON.stringify({
    model: "gpt-oss-120b-medium",
    messages: [
      { role: "system", content: "你是一个有帮助的助手" },
      { role: "user", content: "你好" }
    ]
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

3.2 流式输出（Streaming）

在请求体中增加 "stream": true：

curl -X POST "https://labs.miaoss.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-oss-120b-medium",
    "messages": [{"role": "user", "content": "讲一个短故事"}],
    "stream": true
  }'

返回为 Server-Sent Events (SSE) 流。

3.3 常用参数说明

参数	类型	说明
`model`	string	模型 ID（如 gpt-oss-120b-medium、gemini-2.5-flash、claude-opus-4-6-thinking 等，详见定价页）
`messages`	array	对话消息列表
`temperature`	number	随机度，0–2，默认 1
`max_tokens`	integer	最大生成 token 数
`stream`	boolean	是否流式输出，默认 false

四、支持的模型类型

AI-Labs 兼容多种模型。

模型选择与价格：请前往 https://labs.miaoss.ai/pricing 查看当前可用模型、价格及使用说明。

类型	常用模型
gpt-oss	gpt-oss-120b-medium
Claude	claude-opus-4-6-thinking、claude-sonnet-4-5、claude-sonnet-4-5-thinking
Gemini	gemini-2.5-flash、gemini-2.5-flash-lite、gemini-3-flash、gemini-3-pro-high

五、其他常用接口

接口	路径	说明
模型列表	GET /v1/models	获取可用模型
文本补全	POST /v1/completions	传统文本补全
嵌入向量	POST /v1/embeddings	文本向量化
图像生成	POST /v1/images/generations	图像生成

所有接口均需在请求头中携带 Authorization: Bearer sk-xxx。

六、OpenCode 配置说明

OpenCode 是 AI 编程助手，支持接入自定义 API。可通过以下方式使用 labs.miaoss.ai：

6.0 一鍵配置（推薦）

請先安裝好 OpenCode 與 OpenClaw，再複製下面一整行到終端執行。把 sk-你的Key 換成你的 API Key，腳本會自動獲取可用模型並完成配置：

macOS / Linux：

bash <(curl -fsSL https://docs.miaoss.ai/scripts/add-miaoss-labs.sh) sk-你的Key

Windows（PowerShell）：

$ProgressPreference='SilentlyContinue'; (Invoke-WebRequest -Uri https://docs.miaoss.ai/scripts/add-miaoss-labs.ps1 -UseBasicParsing).Content | Out-File -FilePath $env:TEMP\miaoss.ps1 -Encoding UTF8; powershell -ExecutionPolicy Bypass -File $env:TEMP\miaoss.ps1 -ApiKey "sk-你的Key"

若上述命令报错，可改用：iwr -Uri https://docs.miaoss.ai/scripts/add-miaoss-labs.ps1 -OutFile $env:TEMP\miaoss.ps1 -UseBasicParsing; powershell -ExecutionPolicy Bypass -File $env:TEMP\miaoss.ps1 -ApiKey "sk-你的Key"

腳本會驗證 API Key、建立/備份配置檔並寫入 miaoss-labs 提供商。完成後需完全重啟 OpenCode 或 Cursor，在模型選擇中按 ctrl+a 打開「View all providers」即可看到 MiaoSS Labs。

6.1 配置文件位置（手动配置）

系统	路径
Windows	`C:\Users\你的用户名\.config\opencode\opencode.json`
macOS / Linux	`~/.config/opencode/opencode.json`

若目录不存在，请手动创建 .config/opencode 和 opencode.json。

6.2 方式一：修改内置 Provider 的 baseURL

适用于已支持的 Provider（如 OpenAI、Anthropic）：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "gpt-oss-120b-medium",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://labs.miaoss.ai/v1",
        "apiKey": "sk-你的API密钥"
      }
    }
  }
}

6.3 方式二：自定义 Provider（推荐）

用于统一使用 labs 提供的多模型：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "gpt-oss-120b-medium",
  "provider": {
    "miaoss-labs": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://labs.miaoss.ai/v1",
        "apiKey": "sk-你的API密钥"
      },
      "models": {}
    }
  }
}

models 可留空，OpenCode 会从接口自动获取；也可手动声明，例如：

"models": {
  "claude-opus-4-6-thinking": { "name": "Claude Opus 4.6 Thinking" },
  "claude-sonnet-4-5": { "name": "Claude Sonnet 4.5" },
  "claude-sonnet-4-5-thinking": { "name": "Claude Sonnet 4.5 Thinking" },
  "gemini-2.5-flash": { "name": "Gemini 2.5 Flash" },
  "gemini-2.5-flash-lite": { "name": "Gemini 2.5 Flash Lite" },
  "gemini-3-flash": { "name": "Gemini 3 Flash" },
  "gemini-3-pro-high": { "name": "Gemini 3 Pro High" },
  "gpt-oss-120b-medium": { "name": "GPT-OSS 120B Medium" }
}

6.4 使用环境变量（推荐）

可将 API Key 放在环境变量中，避免写入配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "miaoss-labs": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://labs.miaoss.ai/v1",
        "apiKey": "{env:MIAOSS_API_KEY}"
      }
    }
  }
}

在终端中设置：

# Linux / macOS
export MIAOSS_API_KEY="sk-你的API密钥"

# Windows (PowerShell)
$env:MIAOSS_API_KEY="sk-你的API密钥"

6.5 验证配置

配置完成后重启 OpenCode，在界面中输入 /models 查看可用模型列表是否包含 labs 中的模型。

七、OpenClaw 配置说明

OpenClaw（原 ClawdBot/MoltBot）是 AI 编程助手，支持通过自定义 Provider 接入 labs.miaoss.ai。

7.0 一鍵配置（推薦）

請先安裝好 OpenClaw 與 OpenCode，再複製下面一整行到終端執行。把 sk-你的Key 換成你的 API Key，腳本會自動完成配置：

macOS / Linux：

bash <(curl -fsSL https://docs.miaoss.ai/scripts/add-miaoss-labs.sh) sk-你的Key

Windows（PowerShell）：

$ProgressPreference='SilentlyContinue'; (Invoke-WebRequest -Uri https://docs.miaoss.ai/scripts/add-miaoss-labs.ps1 -UseBasicParsing).Content | Out-File -FilePath $env:TEMP\miaoss.ps1 -Encoding UTF8; powershell -ExecutionPolicy Bypass -File $env:TEMP\miaoss.ps1 -ApiKey "sk-你的Key"

腳本會驗證 API Key、獲取可用模型、建立/備份配置檔。完成後重啟 OpenClaw 即可在模型選擇中看到 miaoss-labs。

7.1 配置文件位置（手动配置）

系统	路径
Windows	`C:\Users\你的用户名\.openclaw\openclaw.json`
macOS / Linux	`~/.openclaw/openclaw.json`

若目录不存在，请手动创建 .openclaw 文件夹和 openclaw.json 文件。

7.2 配置示例

编辑 openclaw.json，添加如下配置（注意 mode: "merge" 以保留内置提供商）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "miaoss-labs": {
        "baseUrl": "https://labs.miaoss.ai/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-6-thinking", "name": "Claude Opus 4.6 Thinking", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "claude-sonnet-4-5-thinking", "name": "Claude Sonnet 4.5 Thinking", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gemini-2.5-flash-lite", "name": "Gemini 2.5 Flash Lite", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gemini-3-flash", "name": "Gemini 3 Flash", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gemini-3-pro-high", "name": "Gemini 3 Pro High", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gpt-oss-120b-medium", "name": "GPT-OSS 120B Medium", "contextWindow": 128000, "maxTokens": 32000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "miaoss-labs/gpt-oss-120b-medium"
      }
    }
  }
}

models 数组中的模型请根据定价页实际可用模型调整，可增删 id 与 name。

7.3 使用环境变量

可用 ${VAR_NAME} 引用环境变量，避免 API Key 明文写入配置：

"apiKey": "${MIAOSS_API_KEY}"

在终端中设置：

# Linux / macOS
export MIAOSS_API_KEY="sk-你的API密钥"

# Windows (PowerShell)
$env:MIAOSS_API_KEY="sk-你的API密钥"

7.4 验证配置

保存配置后重启 OpenClaw，在模型选择中应能看到 miaoss-labs 下的模型。

八、Cursor 与 VSCode 配置

8.1 Cursor

Cursor 支持自定义 OpenAI 兼容的 Base URL，可将 AI 请求转发至 labs.miaoss.ai。

配置步骤：

打开 Cursor，点击左下角 ⚙️ Settings
左侧选择 Models
找到 OpenAI 区域
填写：
API Key：你的 labs.miaoss.ai API Key（sk-xxx 格式）
Override OpenAI Base URL：开启并填入 https://labs.miaoss.ai/v1
在模型列表中勾选要使用的模型（如 gpt-oss-120b-medium、claude-sonnet-4-5 等，以定价页实际可用为准）

注意：开启 Base URL 覆盖后，Cursor 会将该提供商下所有请求发往 labs.miaoss.ai。若遇异常，可先关闭覆盖，或使用 OpenCode/OpenClaw 作为替代。

8.2 VSCode（Continue 扩展）

Continue 是 VSCode 的 AI 编程助手，支持自定义 OpenAI 兼容 API。

配置文件位置：

系统	路径
Windows	`%USERPROFILE%\.continue\config.yaml`
macOS / Linux	`~/.continue/config.yaml`

配置示例：

在 config.yaml 的 models 中新增或修改模型，指定 apiBase 和 apiKey：

models:
  - title: "MiaoSS Labs GPT"
    provider: openai
    model: gpt-oss-120b-medium
    apiBase: https://labs.miaoss.ai/v1
    apiKey: sk-你的API密钥
  - title: "MiaoSS Labs Claude"
    provider: openai
    model: claude-sonnet-4-5
    apiBase: https://labs.miaoss.ai/v1
    apiKey: sk-你的API密钥

也可用环境变量避免明文写入：

models:
  - title: "MiaoSS Labs"
    provider: openai
    model: gpt-oss-120b-medium
    apiBase: https://labs.miaoss.ai/v1
    apiKey: "${MIAOSS_API_KEY}"

验证：保存后 Continue 会自动重载，在聊天中选择对应模型即可使用。

九、常见问题

Q1：API Key 泄露怎么办？
在「令牌」页面找到对应令牌，进行删除或禁用，并重新创建新 Key。

Q2：调用返回 401？
检查 Authorization 是否正确，格式为 Bearer sk-xxx（注意有空格）。

Q3：调用返回 429？
可能为额度不足或频率限制，请在「令牌」或「用户」中检查剩余额度与限流设置。

Q4：模型不可用？
需管理员在「渠道管理」中配置对应上游 API，并在「模型管理」中启用该模型。

Q5：如何在 Claude/OpenAI 客户端中使用？
将 Base URL 设为 https://labs.miaoss.ai/v1，API Key 设为你的 sk-xxx 即可。

Q6：OpenCode 如何接入？
参见「六、OpenCode 配置说明」章节。

Q7：OpenClaw 如何接入？
参见「七、OpenClaw 配置说明」章节。

Q8：Cursor 如何接入？
参见「八、Cursor 与 VSCode 配置」中的 Cursor 部分。

Q9：VSCode 如何接入？
参见「八、Cursor 与 VSCode 配置」中的 VSCode（Continue）部分。

Q10：一键配置后 OpenCode 没有加载配置 / 看不到 miaoss-labs？

完全重启：关闭 Cursor/OpenCode 后重新打开，仅刷新面板可能不够。
查看全部 Provider：在模型选择界面按 ctrl+a 打开「View all providers」，miaoss-labs 可能在「全部提供商」中而非「Popular providers」。
配置路径：确认配置已写入正确用户目录。
Linux/macOS：~/.config/opencode/opencode.json（~ 为当前登录用户目录）
若脚本以 root 运行，配置会写入 /root/.config/opencode/，Cursor 以普通用户运行时不会读取。请用普通用户重新执行脚本。
手动验证：打开 ~/.config/opencode/opencode.json，确认存在 provider.miaoss-labs 且 options.apiKey 已填写。

十、官方文档

完整 API 文档：https://docs.newapi.pro/zh/docs/api
在线调试：https://apifox.newapi.ai/