认证方式

项目里同时存在 API Key 认证、原生兼容认证头和浏览器登录态三种访问方式。要先分清你访问的是 relay 路由还是 /api/* 管理路由。

Bearer Token

用于大多数 relay 路由，包括：

/v1/*
/v1beta/*
/mj/*
/suno/*
/kling/v1/*
/dashboard/billing/*

请求头：

Authorization: Bearer YOUR_API_KEY

Claude 原生兼容头

用于 POST /v1/messages 等 Claude 原生格式页面：

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01

Gemini 原生兼容头

用于 GET /v1beta/models 与 POST /v1beta/models/{model}:{action}：

x-goog-api-key: YOUR_API_KEY

也兼容 ?key=YOUR_API_KEY 的查询参数风格。

用户登录态

用于 /api/user/*、后台管理和部分前端仪表盘接口。典型特征：

认证由 UserAuth、AdminAuth、RootAuth 等中间件控制。
失败时很多接口仍返回 HTTP 200，但 success 为 false。

OAuth 浏览器流

1. 生成 `state`

GET /api/oauth/state

成功响应：

{
  "success": true,
  "message": "",
  "data": "a1b2c3d4e5f6"
}

2. 跳转到标准 OAuth 提供商

GET /api/oauth/{provider}

这个路由由浏览器回调使用，服务端会校验 state、拉取用户信息、绑定或创建账户，然后建立登录态。常见 provider 由实际启用的 OAuth 配置决定，例如：

github
discord
oidc
linuxdo

认证失败时的常见返回

Relay 路由

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_api_key"
  }
}

`/api/*` 路由

{
  "success": false,
  "message": "无效的令牌"
}

概览

文本系列

图像系列

视频系列

上传管理

任务管理

账户管理

认证方式

认证方式

Bearer Token

Claude 原生兼容头

Gemini 原生兼容头

用户登录态

OAuth 浏览器流

1. 生成 `state`

2. 跳转到标准 OAuth 提供商

认证失败时的常见返回

Relay 路由

`/api/*` 路由

相关页面

​认证方式

​Bearer Token

​Claude 原生兼容头

​Gemini 原生兼容头

​用户登录态

​OAuth 浏览器流

​1. 生成 state

​2. 跳转到标准 OAuth 提供商

​认证失败时的常见返回

​Relay 路由

​/api/* 路由

​相关页面

认证方式

Bearer Token

Claude 原生兼容头

Gemini 原生兼容头

用户登录态

OAuth 浏览器流

1. 生成 `state`

2. 跳转到标准 OAuth 提供商

认证失败时的常见返回

Relay 路由

`/api/*` 路由

相关页面