SubAPI 快速开始

本页用于第一次调用 SubAPI。最终 API 地址是：

https://api.onemini.top/

SubAPI 会根据 API Key 所属分组的平台和账号能力进行调度。模型是否可用、模型 ID 如何填写，以接口实时返回为准。

1. 准备 API Key

在站点后台创建 API Key，并确认所属分组有可用额度。请求时优先使用以下任一请求头：

也兼容：

不要把真实 Key 写入前端代码、公开仓库或日志。查询参数 key、api_key 已弃用。

公网使用 HTTPS 443 端口，通常不需要在 URL 中写端口。不要使用容器内部地址或宿主机 8080 作为用户端 Base URL。

OpenAI 兼容模型列表：

Gemini 原生模型列表：

后续请求中的 model 必须使用返回结果中的实际 ID。模型名不代表一定可用，API Key 分组没有该模型时会返回模型不可用或路由错误。

需要 Claude Code、Claude 原生消息、Gemini 原生协议、OpenCode 或图片接口：阅读《开发者 API 接入指南》。

只需要 OpenAI 兼容客户端：使用 https://api.onemini.top/v1，再填写 /v1/models 返回的模型 ID。

遇到 401：检查请求头和 Key 状态；遇到 404：检查是否重复拼接 /v1，以及 Gemini 是否误用了 /v1。