Smallice AI 使用说明

Smallice2026/5/12使用说明Smallice AISub2APIAPI大约 4 分钟

Smallice AI 使用说明

Smallice AI 是一个基于 Sub2API 搭建的 AI API 网关服务。你可以在主站生成自己的 API Key，然后把它配置到 Codex、Claude Code、Cherry Studio、OpenAI SDK 或其他兼容工具中使用。

主站地址：https://smallice.chat

提示

本文面向普通用户，介绍如何获取密钥、配置调用地址和排查常见问题。具体可用模型、额度、价格和分组权限，以主站后台显示为准。

基本概念

使用 Smallice AI 时，通常只需要关注三个信息：

项目	内容
Base URL	`https://api.smallice.chat`
API Key	在主站后台创建，用作请求鉴权
模型名称	在主站后台或工具的模型列表中查看

Sub2API 会在后台负责鉴权、用量统计、账号调度和请求转发。用户侧只需要像使用普通 API 服务一样配置地址和密钥。

获取 API Key

打开 https://smallice.chat。
登录你的账号。
进入 API Key 或密钥管理页面。
创建一个新的 API Key。
复制并妥善保存该密钥。

API Key 只会在创建时完整展示一次。不要把它公开到 GitHub、群聊、截图或日志里。

通用调用方式

大多数兼容 OpenAI 格式的工具可以使用下面的配置：

Base URL: https://api.smallice.chat
API Key: 你的 API Key

如果工具要求填写完整接口前缀，可以按工具类型尝试：

OpenAI 兼容接口: https://api.smallice.chat/v1
Anthropic 兼容接口: https://api.smallice.chat
Gemini 兼容接口: https://api.smallice.chat

不同客户端对 Base URL 的拼接方式不完全相同。如果出现 404，优先检查工具是否自动追加了 /v1。

Codex 配置

Codex 使用 OpenAI 兼容接口时，通常配置：

export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://api.smallice.chat/v1"

然后正常启动 Codex。模型名称请填写主站后台可用的模型名。

如果你的 Codex 配置文件支持自定义 provider，可以把 Base URL 写成：

https://api.smallice.chat/v1

Claude Code 配置

Claude Code 走 Anthropic 兼容接口时，通常需要：

export ANTHROPIC_API_KEY="你的 API Key"
export ANTHROPIC_BASE_URL="https://api.smallice.chat"

如果客户端要求填写 endpoint，请优先使用：

https://api.smallice.chat

模型名以主站后台展示为准。

OpenAI SDK 示例

Node.js 示例：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://api.smallice.chat/v1",
});

const response = await client.chat.completions.create({
  model: "你的模型名",
  messages: [
    {
      role: "user",
      content: "你好，介绍一下 Smallice AI。",
    },
  ],
});

console.log(response.choices[0]?.message?.content);

Python 示例：

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://api.smallice.chat/v1",
)

response = client.chat.completions.create(
    model="你的模型名",
    messages=[
        {"role": "user", "content": "你好，介绍一下 Smallice AI。"}
    ],
)

print(response.choices[0].message.content)