MiaoSS Labs 使用指南

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

一、快速开始

访问地址

管理后台：https://labs.miaoss.ai
API 基址：https://labs.miaoss.ai/v1
模型与定价：https://labs.miaoss.ai/pricing

首次使用流程

打开 https://labs.miaoss.ai
使用 MiaoSS 账号登录（点击「MiaoSS 登录」按钮，跳转 MiaoSS 主站授权）
进入左侧「令牌」→ 创建 API Key
在任何支持 OpenAI 格式的软件中，将 Base URL 设为 https://labs.miaoss.ai/v1，填入 API Key 即可使用

提示：如果还没有 MiaoSS 账号，请先在 d.miaosu.bid 注册。

二、获取 API Key

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

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

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

三、支持的模型

MiaoSS Labs 提供 49+ 款模型，涵盖主流 AI 厂商。完整列表与实时价格请看定价页。

厂商	热门模型	说明
OpenAI	`gpt-5-codex`、`gpt-5.2`、`gpt-5.4`	GPT-5 系列，含多款 Codex 编程模型
Anthropic	`claude-sonnet-4-5`、`claude-opus-4-5`、`claude-opus-4-6-thinking`	Claude 全系列，支持 thinking 模式
Google	`gemini-2.5-flash`、`gemini-3-flash`、`gemini-3.1-pro-high`	Gemini 全系列，Flash 性价比高
xAI	`grok-4`、`grok-4-heavy`、`grok-4-thinking`	Grok 全系列，含推理/图像生成
Meta	`llama3.1-8B`	开源模型

模型 ID 就是调用时 model 参数的值，如 "model": "gpt-5-codex"。

四、API 调用示例

4.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-你的API密钥" \
  -d '{
    "model": "gpt-5-codex",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "你好，请介绍一下自己"}
    ]
  }'

Python：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://labs.miaoss.ai/v1"
)

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

Node.js：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的API密钥",
  baseURL: "https://labs.miaoss.ai/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5-codex",
  messages: [
    { role: "system", content: "你是一个有帮助的助手" },
    { role: "user", content: "你好" },
  ],
});
console.log(response.choices[0].message.content);

4.2 流式输出（Streaming）

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

curl -X POST "https://labs.miaoss.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -d '{
    "model": "gpt-5-codex",
    "messages": [{"role": "user", "content": "讲一个短故事"}],
    "stream": true
  }'

4.3 常用参数

参数	类型	说明
`model`	string	模型 ID，如 `gpt-5-codex`、`claude-sonnet-4-5`
`messages`	array	对话消息列表
`temperature`	number	随机度，0–2，默认 1
`max_tokens`	integer	最大生成 token 数
`stream`	boolean	是否流式输出，默认 false

4.4 其他接口

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

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

五、一键配置脚本

适用于 OpenCode 和 OpenClaw。脚本会自动验证 API Key、获取最新模型列表、备份并更新配置文件。不会覆盖你的其他配置，只添加 miaoss-labs 提供商。

macOS / Linux：

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

Windows PowerShell：

iwr -Uri https://docs.miaoss.ai/scripts/add-miaoss-labs.ps1 -OutFile $env:TEMP\miaoss.ps1; powershell -ExecutionPolicy Bypass -File $env:TEMP\miaoss.ps1 -ApiKey "sk-你的Key"

不带 API Key 直接运行也可以，脚本会交互式提示输入。

运行完成后重启软件即可在模型选择中看到 MiaoSS Labs。

六、OpenCode

OpenCode 是终端 AI 编程助手。安装：npm i -g opencode

6.1 一键配置（推荐）

见上方「五、一键配置脚本」，运行后重启 OpenCode，在模型选择界面按 Ctrl+A 打开「View all providers」即可看到 MiaoSS Labs。

6.2 手动配置

配置文件位置：

系统	路径
macOS / Linux	`~/.config/opencode/opencode.json`
Windows	`%USERPROFILE%\.config\opencode\opencode.json`

编辑配置文件，在 provider 中添加 miaoss-labs：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "miaoss-labs": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MiaoSS Labs",
      "options": {
        "baseURL": "https://labs.miaoss.ai/v1",
        "apiKey": "sk-你的API密钥"
      },
      "models": {
        "gpt-5-codex": { "name": "GPT 5 Codex" },
        "claude-sonnet-4-5": { "name": "Claude Sonnet 4.5" },
        "gemini-2.5-flash": { "name": "Gemini 2.5 Flash" }
      }
    }
  }
}

提示：models 留空 {} 也可以，OpenCode 会自动从 API 获取模型列表。

6.3 环境变量（避免明文存储 Key）

"apiKey": "{env:MIAOSS_API_KEY}"

# Linux / macOS — 加到 ~/.bashrc 或 ~/.zshrc 持久化
export MIAOSS_API_KEY="sk-你的API密钥"

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

七、OpenClaw

OpenClaw 是 AI 编程助手（原 ClawdBot），支持自定义 Provider。

7.1 一键配置（推荐）

见上方「五、一键配置脚本」，运行后重启 OpenClaw，在模型选择中找到 miaoss-labs。

7.2 手动配置

配置文件位置：

系统	路径
macOS / Linux	`~/.openclaw/openclaw.json`
Windows	`%USERPROFILE%\.openclaw\openclaw.json`

编辑 openclaw.json，添加以下内容。mode: "merge" 会保留内置提供商：

{
  "models": {
    "mode": "merge",
    "providers": {
      "miaoss-labs": {
        "baseUrl": "https://labs.miaoss.ai/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5-codex", "name": "GPT 5 Codex", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5", "contextWindow": 128000, "maxTokens": 32000 },
          { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash", "contextWindow": 128000, "maxTokens": 32000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "miaoss-labs/gpt-5-codex"
      }
    }
  }
}

更多模型请参考定价页，按同样格式添加即可。

7.3 环境变量

"apiKey": "${MIAOSS_API_KEY}"

八、Claude Code

Claude Code 是 Anthropic 官方终端编程助手。可通过环境变量指向 MiaoSS Labs。

配置方法

在终端中设置环境变量后启动 Claude Code：

# Linux / macOS
export ANTHROPIC_BASE_URL="https://labs.miaoss.ai"
export ANTHROPIC_API_KEY="sk-你的API密钥"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://labs.miaoss.ai"
$env:ANTHROPIC_API_KEY="sk-你的API密钥"
claude

提示：将 export 行加到 ~/.bashrc 或 ~/.zshrc 中可持久化，无需每次手动设置。

九、Cursor

Cursor 是基于 VSCode 的 AI 编辑器，支持自定义 OpenAI Base URL。

配置步骤

打开 Cursor → 左下角 ⚙️ Settings
左侧选择 Models
找到 OpenAI API Key 区域
填写：
API Key：你的 sk-xxx 密钥
Override OpenAI Base URL：https://labs.miaoss.ai/v1
在模型列表中添加要使用的模型名（如 gpt-5-codex、claude-sonnet-4-5）
保存并重启 Cursor

注意：开启 Base URL 覆盖后，Cursor 会将该提供商下所有请求发往 MiaoSS Labs。

十、Windsurf

Windsurf（原 Codeium）是 AI 编辑器，支持自定义 Provider。

配置方法

打开 Windsurf → Settings → 搜索 openai
找到 Windsurf: Custom Model Providers
点击 Edit in settings.json，添加：

{
  "windsurf.customModelProviders": [
    {
      "name": "MiaoSS Labs",
      "baseUrl": "https://labs.miaoss.ai/v1",
      "apiKey": "sk-你的API密钥",
      "models": ["gpt-5-codex", "claude-sonnet-4-5", "gemini-2.5-flash"]
    }
  ]
}

保存后在模型选择中即可看到 MiaoSS Labs 的模型。

十一、VSCode 扩展

11.1 Continue

Continue 是 VSCode / JetBrains 的开源 AI 编程助手。

配置文件：~/.continue/config.yaml（Windows: %USERPROFILE%\.continue\config.yaml）

models:
  - title: "GPT 5 Codex (MiaoSS)"
    provider: openai
    model: gpt-5-codex
    apiBase: https://labs.miaoss.ai/v1
    apiKey: sk-你的API密钥
  - title: "Claude Sonnet 4.5 (MiaoSS)"
    provider: openai
    model: claude-sonnet-4-5
    apiBase: https://labs.miaoss.ai/v1
    apiKey: sk-你的API密钥

保存后 Continue 自动重载。

11.2 Cline

Cline 是 VSCode 的自主 AI 编程助手。

安装 Cline 扩展
打开 Cline 侧边栏 → 点击 ⚙️ 设置
API Provider 选择 OpenAI Compatible
填写：
Base URL：https://labs.miaoss.ai/v1
API Key：sk-你的API密钥
Model ID：gpt-5-codex（或其他模型）

十二、桌面客户端

以下客户端均支持 OpenAI 兼容 API，配置方式大同小异：填入 Base URL 和 API Key 即可。

12.1 Cherry Studio

Cherry Studio 是跨平台 AI 桌面客户端。

打开 Cherry Studio → 设置 → 模型服务商
点击 添加服务商 → 选择 OpenAI
填写：
名称：MiaoSS Labs
API 地址：https://labs.miaoss.ai（不加 /v1，Cherry Studio 会自动补）
API Key：sk-你的API密钥
点击「获取模型」自动加载可用模型列表

12.2 Chatbox

Chatbox 是简洁的跨平台 AI 桌面客户端。

打开 Chatbox → 设置 → AI 模型提供方
选择 OpenAI API Compatible
填写：
API Host：https://labs.miaoss.ai
API Key：sk-你的API密钥
Model：输入模型名，如 gpt-5-codex

12.3 NextChat（ChatGPT-Next-Web）

NextChat 是流行的 Web/桌面 AI 客户端。

桌面版：设置 → 自定义接口地址 → https://labs.miaoss.ai

自部署版：设置环境变量：

BASE_URL=https://labs.miaoss.ai
OPENAI_API_KEY=sk-你的API密钥

12.4 LobeChat

LobeChat 是开源 AI 聊天平台。

设置 → 语言模型 → OpenAI
开启「使用自定义 API Key」
填写：
API Key：sk-你的API密钥
API 代理地址：https://labs.miaoss.ai/v1
在模型列表中添加需要的模型

十三、通用配置原则

MiaoSS Labs 兼容 OpenAI API 格式。任何支持自定义 OpenAI Base URL 的软件都可以接入：

配置项	值
API Base URL	`https://labs.miaoss.ai/v1`
API Key	你的 `sk-xxx` 密钥
Model	模型 ID，如 `gpt-5-codex`

部分软件 Base URL 不需要 /v1 后缀（如 Cherry Studio），请根据软件提示调整。

环境变量方式（适用于命令行工具）：

export OPENAI_API_KEY="sk-你的API密钥"
export OPENAI_BASE_URL="https://labs.miaoss.ai/v1"

许多工具（如 openai Python/Node.js SDK）会自动读取这两个环境变量，无需额外配置。

十四、常见问题

Q：API Key 泄露了怎么办？ 在令牌页面删除或禁用泄露的令牌，重新创建一个。

Q：调用返回 401 Unauthorized？ 检查 Authorization 头格式：Bearer sk-xxx（Bearer 后有空格）。确认 Key 没有过期或被禁用。

Q：调用返回 429 Too Many Requests？ 额度不足或触发频率限制。在令牌页面检查剩余额度。

Q：调用返回模型不存在？ 确认模型 ID 拼写正确。可调用 GET /v1/models 查看当前可用模型列表。

Q：一键配置后看不到 MiaoSS Labs？

完全重启软件（关闭再打开，不是刷新面板）
OpenCode：在模型选择界面按 Ctrl+A 打开「View all providers」
确认配置文件路径正确（Linux: ~/.config/opencode/opencode.json）
如果用 root/sudo 运行脚本，配置会写入 root 目录。请用普通用户重新运行

Q：脚本会覆盖我的已有配置吗？ 不会。脚本只添加/更新 miaoss-labs 提供商，你的其他设置（模型、主题、其他 Provider）全部保留。运行前会自动备份原配置文件。

Q：如何注册账号？ MiaoSS Labs 使用 MiaoSS 统一账号登录。请先在 d.miaosu.bid 注册 MiaoSS 账号，然后在 Labs 页面点击「MiaoSS 登录」。

十五、相关链接

链接	说明
labs.miaoss.ai	管理后台（令牌/额度/日志）
labs.miaoss.ai/pricing	模型列表与定价
d.miaosu.bid	MiaoSS 主站（注册/充值）
docs.miaoss.ai	本文档站