Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
认证方式

项目里同时存在 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": "无效的令牌"
}

​
相关页面