# Quick Start

import {
  Server,
  Network,
  Code2,
  Headphones,
  Bot,
  Handshake,
  Container,
  Boxes,
} from 'lucide-react';

## Deployment Method Selection

Choose the appropriate deployment method based on your environment and technical requirements.

<Cards>
  <Card icon={<Boxes />} title="Docker Compose Deployment" description="Orchestrate multiple services with Docker Compose, suitable for production environments or scenarios requiring dependencies like MySQL and Redis." href="/en/docs/installation/deployment-methods/docker-compose-installation" />

  <Card icon={<Container />} title="Docker Single Container Deployment" description="Quickly deploy New API using a Docker image, suitable for personal use or small-scale applications." href="/en/docs/installation/deployment-methods/docker-installation" />

  <Card icon={<Server />} title="1Panel Deployment" description="Rapid deployment via the 1Panel graphical interface, suitable for users unfamiliar with the command line." href="/en/docs/installation/deployment-methods/1panel-installation" />

  <Card icon={<Server />} title="Baota Panel Deployment" description="Rapid deployment via the Baota Panel graphical interface, suitable for users unfamiliar with the command line." href="/en/docs/installation/deployment-methods/bt-docker-installation" />

  <Card icon={<Network />} title="Cluster Deployment Mode" description="Multi-node distributed deployment for high availability, load balancing, and horizontal scalability, suitable for large-scale applications and enterprise-level scenarios." href="/en/docs/installation/deployment-methods/cluster-deployment" />

  <Card icon={<Code2 />} title="Local Development Deployment" description="Suitable for developers contributing code and custom development, providing a complete guide to local development environment setup." href="/en/docs/installation/deployment-methods/local-development" />
</Cards>

## Browse Our Documentation

Explore comprehensive guides and resources to fully leverage the powerful features of New API.

<Cards>
  <Card icon={<Code2 />} title="API Documentation" description="Comprehensive API interface descriptions and call examples." href="/en/docs/api" />

  <Card icon={<Bot />} title="AI Applications" description="Explore various AI application examples developed based on New API." href="/en/docs/apps" />

  <Card icon={<Headphones />} title="Help & Support" description="Frequently asked questions and community communication." href="/en/docs/support" />

  <Card icon={<Handshake />} title="Business Cooperation" description="Partner with us to jointly explore the AI ecosystem and business opportunities." href="/en/docs/business" />
</Cards>


# API Reference

import { Card, Cards } from 'fumadocs-ui/components/card';
import {
  List,
  MessageSquare,
  FileText,
  Database,
  Search,
  ShieldCheck,
  Headphones,
  Radio,
  Image,
  Video,
  FileQuestion,
  Server,
  SlidersHorizontal,
  UserCheck,
  Users,
  KeyRound,
  Link2,
  Network,
  Blocks,
  Key,
  Ticket,
  CreditCard,
  ScrollText,
  ChartBar,
  ListTodo,
  FolderKanban,
  Store,
  ShieldAlert,
} from 'lucide-react';

## Overview

New API provides a complete set of RESTful API interfaces, categorized into two main types: **AI Model APIs** and **Management APIs**. You can use these interfaces to invoke AI capabilities and perform system management functions.

<Callout title="Online Debugging">
  You can visit [Apifox Playground](https://apifox.newapi.ai/) to test and debug API interfaces online, or browse the API documentation below.
</Callout>

## AI Model APIs

AI Model APIs provide calls for various AI capabilities, compatible with the OpenAI API format.

<Cards>
  <Card icon={<List />} title="Model List" description="Get a list of available models." href="/en/docs/api/ai-model/models/list/listmodels" />

  <Card icon={<MessageSquare />} title="Chat" description="Conversation completion API." href="/en/docs/api/ai-model/chat/openai/createchatcompletion" />

  <Card icon={<FileText />} title="Completions" description="Traditional text completion API." href="/en/docs/api/ai-model/completions/createcompletion" />

  <Card icon={<Database />} title="Embeddings" description="Text embedding vector generation API." href="/en/docs/api/ai-model/embeddings/createembedding" />

  <Card icon={<Search />} title="Rerank" description="Document reranking API." href="/en/docs/api/ai-model/rerank/creatererank" />

  <Card icon={<ShieldCheck />} title="Moderations" description="Content safety moderation API." href="/en/docs/api/ai-model/moderations/createmoderation" />

  <Card icon={<Headphones />} title="Audio" description="Speech recognition and speech synthesis API." href="/en/docs/api/ai-model/audio/openai/createspeech" />

  <Card icon={<Radio />} title="Real-time Audio" description="Real-time audio streaming API." href="/en/docs/api/ai-model/realtime/createrealtimesession" />

  <Card icon={<Image />} title="Images" description="AI image generation API." href="/en/docs/api/ai-model/images/openai/post-v1-images-generations" />

  <Card icon={<Video />} title="Videos" description="AI video generation API." href="/en/docs/api/ai-model/videos/sora/createvideo" />

  <Card icon={<FileQuestion />} title="Unimplemented" description="Placeholder API, not yet implemented." href="/en/docs/api/ai-model/unimplemented/files/listfiles" />
</Cards>

## Management APIs

Management APIs are used for backend operations such as system configuration, user management, and business management.

<Cards>
  <Card icon={<Server />} title="System" description="System information and status API." href="/en/docs/api/management/system/status-get" />

  <Card icon={<SlidersHorizontal />} title="System Settings" description="System configuration management API." href="/en/docs/api/management/system-settings/option-get" />

  <Card icon={<UserCheck />} title="User Authentication" description="User login, registration, password management, and other APIs." href="/en/docs/api/management/user-auth/user-login-post" />

  <Card icon={<Users />} title="User Management" description="User information management API." href="/en/docs/api/management/user-management/user-self-get" />

  <Card icon={<KeyRound />} title="Two-Factor Authentication" description="2FA Two-Factor Authentication API." href="/en/docs/api/management/two-factor-auth/user-2fa-status-get" />

  <Card icon={<Link2 />} title="OAuth" description="Third-party OAuth login API." href="/en/docs/api/management/oauth/oauth-github-get" />

  <Card icon={<Network />} title="Channel Management" description="API channel configuration management API." href="/en/docs/api/management/channel-management/channel-get" />

  <Card icon={<Blocks />} title="Model Management" description="Model configuration management API." href="/en/docs/api/management/model-management/models-get" />

  <Card icon={<Key />} title="Token Management" description="API token management API." href="/en/docs/api/management/token-management/token-get" />

  <Card icon={<Ticket />} title="Redemption Codes" description="Redemption code management API." href="/en/docs/api/management/redemption/redemption-get" />

  <Card icon={<CreditCard />} title="Payment" description="Payment and top-up API." href="/en/docs/api/management/payment/user-topup-info-get" />

  <Card icon={<ScrollText />} title="Logs" description="Usage log query API." href="/en/docs/api/management/logs/log-get" />

  <Card icon={<ChartBar />} title="Statistics" description="Data statistics API." href="/en/docs/api/management/statistics/data-get" />

  <Card icon={<ListTodo />} title="Tasks" description="Asynchronous task management API." href="/en/docs/api/management/tasks/task-get" />

  <Card icon={<FolderKanban />} title="Groups" description="User group management API." href="/en/docs/api/management/groups/group-get" />

  <Card icon={<Store />} title="Vendors" description="Vendor management API." href="/en/docs/api/management/vendors/vendors-get" />

  <Card icon={<ShieldAlert />} title="Security Verification" description="Security verification related APIs." href="/en/docs/api/management/security-verification/verify-status-get" />
</Cards>


# AionUi - Free, Open-Source Desktop Office Agent









<Callout type="info">
  🚀 AionUi is a free, local, open-source Cowork that supports multiple AI agents such as Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more. It provides a complete GUI interface and WebUI remote access functionality, serving as an open-source alternative to Cowork.
</Callout>

* Official Website: [https://www.aionui.com](https://www.aionui.com)
* GitHub Repository: [https://github.com/iOfficeAI/AionUi](https://github.com/iOfficeAI/AionUi)
* Download Address: [https://github.com/iOfficeAI/AionUi/releases](https://github.com/iOfficeAI/AionUi/releases)

<img alt="AionUi Logo" src={__img0} placeholder="blur" />

## Core Features

### 💬 Multi-Session Chat

* **Multi-Session + Independent Context** - Open multiple chat sessions simultaneously, each session has independent context memory
* **Local Storage** - All conversation data is saved in a local SQLite database and will not be lost

### 🤖 Multi-Model Support

* **Multi-Platform Support** - Supports mainstream models like Gemini, OpenAI, Claude, Qwen, flexible switching
* **Local Model Support** - Supports local model deployment like Ollama, LM Studio

### 🤝 Multi-Agent Mode

* **Run Multiple AI Agents Simultaneously** - Can run multiple AI agents simultaneously (such as Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, etc.)
* **MCP Unified Management** - Unified management and configuration of all agents through Model Context Protocol (MCP), simplifying operations
* **Skills Configuration** - Support configuring dedicated Skills for different agents to extend agent capabilities
* **Assistant Customization** - Support custom assistant configuration to create personalized AI workflows
* **Independent Configuration** - Each agent can be configured and used independently without interference
* **Flexible Switching** - Flexibly switch between different agents to meet various scenario needs

### 🗂️ File Management

* **File Tree Browsing + Drag & Drop Upload** - Browse files like folders, support drag and drop files or folders for one-click import
* **Smart Organization** - Let AI help organize folders with automatic classification

### 📄 Preview Panel

* **9+ Format Preview** - Supports PDF, Word, Excel, PPT, code, Markdown, images, and other formats
* **Real-time Tracking + Editable** - Automatically tracks file changes, supports real-time editing and debugging of Markdown, code, HTML

### 🎨 AI Image Generation & Editing

* **Intelligent Image Generation** - Supports multiple image generation models like Gemini 2.5 Flash Image Preview, Nano, Banana
* **Image Recognition & Editing** - AI-driven image analysis and editing features

### 🌐 Multi-Channel Access

* **WebUI Remote Access** - Access from any device on the network via browser, supports mobile devices
* **Telegram Integration** - Support interaction through Telegram bot
* **Feishu Integration** - Support access and interaction through Feishu
* **Local Data Security** - All data stored in local SQLite database, suitable for server deployment

## NewAPI Configuration Steps

1. **Copy API key in NewAPI**
   <img alt="Copy API Key" src={__img1} placeholder="blur" />

2. **Open AionUi Settings**
   * Enter the settings page in AionUi
   * Find the Model Configuration Tab
   * Click "Add Model"
     <img alt="Open Settings" src={__img2} placeholder="blur" />

3. **Add New Provider**
   * Click "Add Model"
   * Select NewAPI
     <img alt="Add NewAPI Provider" src={__img3} placeholder="blur" />

4. **Configure API Information**
   * API Address: Fill in your NewAPI site address (format: `https://<your-newapi-domain>/v1`)
   * API Key: Paste the API Key copied from NewAPI console

5. **Add Models**
   * Select the model to add from the dropdown
   * Model name should match the model name configured in NewAPI
   * Select the appropriate request protocol

6. **Start Using**
   * Return to the chat page
   * Select the configured NewAPI model to start a conversation

## Related Links

* [GitHub Repository](https://github.com/iOfficeAI/AionUi)
* [Complete Usage Guide](https://github.com/iOfficeAI/AionUi#-detailed-usage-guide)
* [FAQ](https://github.com/iOfficeAI/AionUi#-support--help)


# AstrBot - Agent Chatbot









<Callout type="info">
  AstrBot is an open-source, all-in-one Agent chatbot platform that seamlessly
  integrates large model capabilities into mainstream instant messaging software
  such as QQ, Feishu, DingTalk, and WeChat Work, building reliable and scalable
  conversational AI infrastructure for individuals, developers, and teams.
  Whether it's a personal AI companion, smart customer service, automation
  assistant, or enterprise knowledge base, AstrBot can quickly build
  production-ready AI applications within your instant messaging software
  platform's workflow.
</Callout>

* Official Website: [https://astrbot.app](https://astrbot.app)
* Official Documentation: [https://docs.astrbot.app](https://docs.astrbot.app)
* Project Homepage: [https://github.com/astrbotdevs/astrbot](https://github.com/astrbotdevs/astrbot)

## NewAPI Integration Method

AstrBot supports integrating NewAPI as a model provider, allowing users to access and use various AI model services through NewAPI.

### Configuration Steps

#### Obtain NewAPI API Key

After registering and logging in to NewAPI, click 'Console' in the top navigation bar, click 'Token Management', then click the 'Add Token' button to create a new API Key, select appropriate permissions, and then click 'Create'.

<img alt="create-api-key" src={__img0} placeholder="blur" />

After successful creation, click the 'Copy Key' button to copy the generated API Key.

<img alt="copy-api-key" src={__img1} placeholder="blur" />

#### Configure NewAPI Service Provider in AstrBot

Open the AstrBot management panel, go to the 'Model Providers' page, then click the 'Add Model Provider' button.

NewAPI perfectly supports OpenAI Chat Completion and Responses interfaces. We click 'OpenAI' to enter the OpenAI provider's configuration page.

In the pop-up dialog box, set the API Base URL to NewAPI's interface address. If you have deployed NewAPI locally, fill in the local address, for example, `http://localhost:3000/v1`. If you are using NewAPI services provided by a third-party service provider, fill in the corresponding URL address, for example, `https://api.example.com/v1`.

Then, enter the API Key into the 'API Key' field and click the 'Save' button.

<img alt="astrbot-provider-config" src={__img2} placeholder="blur" />

Then click Save to complete the NewAPI provider configuration.

#### Apply Service Provider

Go to the 'Configuration File' page, find the 'Models' section, change 'Default Chat Model' to the NewAPI provider you just created, and click the 'Save' button.

<img alt="apply" src={__img3} placeholder="blur" />

At this point, you have successfully configured NewAPI as AstrBot's model provider. Now, you can access and use various AI model services provided by NewAPI through AstrBot.


# CC Switch - All-in-One AI CLI Management Tool



<Callout type="info" title="Chat Settings Option">
  In the New API console under System Settings -> Chat Settings, you can add the following shortcut to enable one-click fill for CC Switch from the token management page:
</Callout>

```json
{ "CC Switch": "ccswitch" }
```

<Callout type="info">
  🔀 CC Switch is an open-source, cross-platform all-in-one AI CLI management tool. It supports
  one-click provider switching for Claude Code, Codex and Gemini CLI, unified MCP server management,
  system prompts management, and Skills extension management — letting you freely switch between
  multiple AI coding assistants without manually editing config files.
</Callout>

* GitHub Repository: [https://github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)
* Download: [GitHub Releases](https://github.com/farion1231/cc-switch/releases)

## Key Features

### 🔌 Provider Management

* **One-click switching** — Switch between Claude Code, Codex, and Gemini API configs instantly, no manual env vars or config file editing
* **Multi-endpoint support** — Configure multiple endpoints per provider with API key management and latency speed tests
* **4-tier model config** — Granular model selection across Haiku / Sonnet / Opus / Custom tiers

### 🛠️ MCP Server Management

* **Unified cross-app management** — Manage MCP servers for Claude / Codex / Gemini from a single panel
* **Three transport types** — Supports stdio, HTTP, and SSE (Server-Sent Events)
* **Auto sync** — Unified import/export with bidirectional synchronization

### 💬 Prompts Management

* **Multi-preset system prompts** — Unlimited presets with quick switching
* **Cross-app support** — Claude (`CLAUDE.md`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`)
* **Markdown editor** — CodeMirror 6 with live preview

### 🌐 Multi-platform Support

* **Desktop app** — Native installers for Windows, macOS, and Linux
* **Web version** — Browser-accessible interface for headless servers / SSH environments
* **CLI version** — Both interactive menu-driven and command-line modes

## NewAPI Integration

CC Switch supports the `ccswitch://` Deep Link protocol, allowing one-click provider config import from the New API token management page.

### Configuration Steps

1. **On the New API token management page, click the dropdown menu for the corresponding token**
   Select the **CC Switch** option from the menu. The system will automatically launch CC Switch and open the configuration dialog.

2. **Complete the configuration in the dialog**
   <img alt="CC Switch Configuration Dialog" src={__img0} placeholder="blur" />

   Field descriptions:

   * **Application**: Switch app type at the top — **Claude** / **Codex** / **Gemini**, select the target application as needed
   * **Name**: Enter a name for this config (e.g. `My Claude`) to easily identify and switch in CC Switch later
   * **Main Model** (required) — The primary model to use by default
   * **Haiku Model** — Lightweight, fast model
   * **Sonnet Model** — Balanced model
   * **Opus Model** — Most capable model

   All models are dropdown selections; unselected fields show "Please select model".

3. **Finish**
   Click **"Open CC Switch"** to import the config into CC Switch and start using it; click **"Cancel"** to discard.

## Installation

### macOS (Homebrew recommended)

```shell
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

### Windows

Download the `.msi` installer or portable `.zip` from [Releases](https://github.com/farion1231/cc-switch/releases).

### Linux

Download the `.deb` package or `.AppImage` from [Releases](https://github.com/farion1231/cc-switch/releases).

ArchLinux users:

```shell
paru -S cc-switch-bin
```

### Web Version (Headless / SSH Servers)

```shell
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web
```

Default port `17666`, access via browser at `http://localhost:17666`.

## Related Links

* [GitHub Repository](https://github.com/farion1231/cc-switch)
* [Changelog](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md)
* [Web Version Repository](https://github.com/cp-yu/cc-switch-web)
* [CLI Version Repository](https://github.com/thomas-jack/cc-switch-cli)


# Cherry Studio - Desktop AI Client















<Callout type="info" title="Chat Settings Options">
  In the System Settings -> Chat Settings of the New API console, the following
  shortcut options can be added to easily populate Cherry Studio with a single
  click on the token management page:
</Callout>

```json
{ "Cherry Studio": "cherrystudio://providers/api-keys?v=1&data={cherryConfig}" }
```

<Callout type="info">
  🍒 Cherry Studio is a powerful desktop AI client designed for professional
  users, integrating 30+ industry-specific intelligent assistants to meet the
  needs of various work scenarios and significantly improve work efficiency.
</Callout>

* Official Website: [https://cherry-ai.com](https://cherry-ai.com/)
* Download Address: [https://cherry-ai.com/download](https://cherry-ai.com/download)
* Official Documentation: [https://docs.cherry-ai.com](https://docs.cherry-ai.com)

## NewAPI Integration Method

### Parameter Configuration

Provider Type: NewAPI supported types
API Key: Obtained from NewAPI
API Address: NewAPI site address

### Visual Guide

1. Copy API key in NewAPI
   <img alt="Copy API Key" src={__img0} placeholder="blur" />

2. Add Provider
   <img alt="Add Provider" src={__img1} placeholder="blur" />

3. Add Models
   <img alt="Add Models" src={__img2} placeholder="blur" />

4. Return to Chat Page
   <img alt="Switch to Chat Page" src={__img3} placeholder="blur" />

5. Switch NewAPI Model
   <img alt="Switch Model" src={__img4} placeholder="blur" />

## Drawing in Cherry Studio

1. First, add models that support drawing
   <img alt="Drawing Models" src={__img5} placeholder="blur" />

2. Draw
   <img alt="Draw" src={__img6} placeholder="blur" />


# Claude Code

















































































<Callout type="info" title="Project Introduction">
  Unleash Claude's raw power directly in your terminal. Search million-line codebases instantly. Turn hours-long workflows into a single command. Your tools. Your workflow. Your codebase, evolving at thought speed.

  * Official Homepage: [https://www.anthropic.com/claude-code](https://www.anthropic.com/claude-code)
</Callout>

## Demo

<img alt="introduce-01.webp" src={__img0} placeholder="blur" />

<img alt="introduce-02.webp" src={__img1} placeholder="blur" />

### Features

| **Category**                       | **Feature**                                                                                                      |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Code Understanding**             | Deep codebase analysis, utilizing intelligent agents to search and understand project structure and dependencies |
|                                    | Automatically generates high-level code overviews, quickly helping users understand the codebase                 |
| **Code Editing**                   | Supports multi-file collaborative editing, suitable for complex code modifications                               |
|                                    | Provides practical and usable code suggestions that align with project patterns and architecture                 |
| **Integration Capabilities**       | Supports direct execution in the terminal, eliminating context switching                                         |
|                                    | Seamless integration with VS Code and JetBrains IDEs, no copy-pasting required                                   |
| **Code Generation & Optimization** | Automatically generates code, creates tests, fixes bugs, supporting the complete process from concept to commit  |
|                                    | Optimized for code generation and understanding, combining advanced models like Claude Opus 4                    |
| **Security & Flexibility**         | Changes require explicit user authorization, ensuring safer file and command operations                          |
|                                    | Adapts to user code standards, supports custom configurations                                                    |
| **Toolchain Integration**          | Supports integration with tools like GitHub and GitLab to achieve automated workflows                            |
|                                    | Integrates with test suites and build systems, enhancing existing development tools                              |
| **Cross-Platform & Extensibility** | Supports Windows, macOS, and Linux operating systems                                                             |
|                                    | Configurable to run in SDKs or GitHub Actions, flexibly adapting to different needs                              |
| **Key Application Scenarios**      | Codebase onboarding and understanding, quick ramp-up for new members                                             |
|                                    | Code issue fixing and optimization processes, from problem analysis to PR submission                             |
|                                    | Project code refactoring and new feature implementation                                                          |
| **User Feedback Highlights**       | Improves daily development efficiency, saving time spent on routine tasks                                        |
|                                    | Excellent performance in handling complex multi-step tasks, expanding development possibilities                  |

## AI Model Configuration Method

### Windows Graphical Guide

#### 1. Install Node.js Environment

Claude Code requires a Node.js environment to run.

<Callout type="info" title="Node.js Environment Installation Steps">
  * Open your browser and visit [https://nodejs.org/](https://nodejs.org/)
  * Click the "LTS" version to download (Long Term Support version recommended)
  * After downloading, double-click the .msi file
  * Follow the installation wizard to complete the installation, keeping default settings
</Callout>

<Callout type="warn" title="Windows Notes">
  * It is recommended to use PowerShell instead of CMD
  * If you encounter permission issues, try running as administrator
  * Some antivirus software may report false positives; you may need to add an exception
</Callout>

<img alt="windows-img-01.webp" src={__img2} placeholder="blur" />

<img alt="windows-img-02.webp" src={__img3} placeholder="blur" />

<img alt="windows-img-03.webp" src={__img4} placeholder="blur" />

<img alt="windows-img-04.webp" src={__img5} placeholder="blur" />

<img alt="windows-img-05.webp" src={__img6} placeholder="blur" />

<Callout type="info" title="Verify Installation Success">
  After installation, open PowerShell or CMD and enter the following commands:

  ```bash
  node --version
  npm --version
  ```

  If version numbers are displayed, the installation was successful.
</Callout>

#### 2. Install Git Bash

<Callout type="warn" title="Windows Notes">
  In a Windows environment, Git Bash is required to install Claude Code. After installation, environment variable setup and using Claude Code will still be done in regular PowerShell or CMD.
</Callout>

<Callout type="info" title="Download and Install Git for Windows">
  * Visit [https://git-scm.com/downloads/win](https://git-scm.com/downloads/win)
  * Click "Download for Windows" to download the installer
  * Run the downloaded .exe installation file
  * Keep default settings during installation, and click "Next" to complete the installation
</Callout>

<img alt="windows-img-06.webp" src={__img7} placeholder="blur" />

<img alt="windows-img-07.webp" src={__img8} placeholder="blur" />

<img alt="windows-img-08.webp" src={__img9} placeholder="blur" />

<Callout type="info" title="Verify Git Bash Installation">
  After installation, open Git Bash and enter the following command to verify:

  ```bash
  git --version
  ```

  If a version number is displayed, the installation was successful.
</Callout>

#### 3. Install Claude Code

<Callout type="info" title="Install Claude Code">
  Open PowerShell and run the following command:

  ```bash
  npm install -g @anthropic-ai/claude-code
  ```

  This command will download and install the latest version of Claude Code from the official npm repository.
</Callout>

<img alt="windows-img-09.webp" src={__img10} placeholder="blur" />

<Callout type="info" title="Add ~/.local/bin to PATH (only if prompted)">
  ```powershell
  [Environment]::SetEnvironmentVariable('Path', ([Environment]::GetEnvironmentVariable('Path','User') + ";$HOME\.local\bin"), 'User')
  ```
</Callout>

<Callout type="info" title="Verify Claude Code Installation">
  After installation, enter the following command to check if it was successfully installed:

  ```bash
  claude --version
  ```

  If a version number is displayed, congratulations! Claude Code has been successfully installed.
</Callout>

#### 4. Set Environment Variables

<Callout type="info" title="One-Click Setup Command (Windows System)">
  To allow Claude Code to connect to your relay service, you need to set multiple environment variables:
</Callout>

```powershell
iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.ps1')
```

<img alt="windows-configure" src={__img11} placeholder="blur" />

#### 5. Start Using Claude Code

You can now start using Claude Code!

<Callout type="info" title="Launch Claude Code">
  Open PowerShell and launch Claude Code directly:

  ```bash
  claude
  ```

  To use in a specific project:

  ```bash
  # Navigate to your project directory
  cd C:\path\to\your\project

  # Launch Claude Code
  claude
  ```
</Callout>

<img alt="windows-img-11.webp" src={__img12} placeholder="blur" />

<img alt="windows-img-12.webp" src={__img13} placeholder="blur" />

<img alt="windows-img-13.webp" src={__img14} placeholder="blur" />

<img alt="windows-img-14.webp" src={__img15} placeholder="blur" />

<img alt="windows-img-15.webp" src={__img16} placeholder="blur" />

<Callout type="info" title="Select Model">
  Enter the command:

  ```bash
  /model
  ```

  Press Enter to select a model; usually, the default settings are sufficient.
</Callout>

<img alt="windows-img-16.webp" src={__img17} placeholder="blur" />

<img alt="windows-img-17.webp" src={__img18} placeholder="blur" />

> Note: After modifying environment variables, all models (including officially preset models) will call the custom access point instead of using official account quotas.

### macOS Graphical Guide

#### 1. Install Claude Code CLI

Open Terminal

<img alt="macos-img-01.webp" src={__img19} placeholder="blur" />

<Callout type="info" title="Install Claude Code">
  Open Terminal and run the following command:

  ```bash
  curl -fsSL https://claude.ai/install.sh | bash
  ```

  Optional: Run the provided command when prompted

  ```bash
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
  ```
</Callout>

<img alt="macos-img-02.webp" src={__img20} placeholder="blur" />

#### 2. Set Environment Variables

To allow Claude Code to connect to a third-party relay service, you need to set environment variables:

<Callout type="info" title="One-Click Setup for Claude Code Environment Variables">
  Enter the command:

  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img21} placeholder="blur" />

<Callout type="info" title="Verify Claude Code Installation">
  After installation, enter the following command to check if it was successfully installed:

  ```bash
  claude --version
  ```

  If a version number is displayed, congratulations! Claude Code has been successfully installed.
</Callout>

#### 3. Start Using Claude Code

You can now start using Claude Code!

<Callout type="info" title="Launch Claude Code">
  Launch Claude Code directly:

  ```bash
  claude
  ```

  To use in a specific project:

  ```bash
  # Navigate to your project directory
  cd /path/to/your/project

  # Launch Claude Code
  claude
  ```
</Callout>

<img alt="macos-img-04.webp" src={__img22} placeholder="blur" />

<img alt="macos-img-05.webp" src={__img23} placeholder="blur" />

<img alt="macos-img-06.webp" src={__img24} placeholder="blur" />

<img alt="macos-img-07.webp" src={__img25} placeholder="blur" />

<img alt="macos-img-08.webp" src={__img26} placeholder="blur" />

<Callout type="info" title="Select Model (Optional)">
  Enter the command:

  ```bash
  /model
  ```

  Press Enter to select an official model; usually, the default model is sufficient.
</Callout>

<img alt="macos-img-09.webp" src={__img27} placeholder="blur" />

<img alt="macos-img-10.webp" src={__img28} placeholder="blur" />

<img alt="macos-img-11.webp" src={__img29} placeholder="blur" />

> Note: After modifying the `ANTHROPIC_BASE_URL` environment variable, all models (including officially preset models) will call the custom access point instead of using official account quotas.

#### 4. macOS Common Issues

<Callout type="info" title="macOS Security Settings Preventing Execution">
  If the system prevents Claude Code from running:

  * Open "System Preferences" → "Security & Privacy"
  * Click "Open Anyway" or "Allow"
  * Or run in Terminal: `sudo spctl --master-disable`
</Callout>

### Linux Graphical Guide

#### 1. Install Claude Code

<img alt="linux-img-01.webp" src={__img30} placeholder="blur" />

<Callout type="info" title="Install Claude Code">
  Open Terminal and run the following command:

  ```bash
  curl -fsSL https://claude.ai/install.sh | bash
  ```

  If you encounter permission issues, you can use sudo:

  ```bash
  sudo curl -fsSL https://claude.ai/install.sh | bash
  ```
</Callout>

<img alt="linux-img-03.webp" src={__img31} placeholder="blur" />

<Callout type="info" title="Verify Claude Code Installation">
  After installation, enter the following command to check if it was successfully installed:

  ```bash
  claude --version
  ```

  If a version number is displayed, congratulations! Claude Code has been successfully installed.
</Callout>

#### 2. Set Environment Variables

To allow Claude Code to connect to your relay service, you need to set two environment variables:

<Callout type="info" title="One-Click Environment Variable Modification">
  Enter the command:

  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img32} placeholder="blur" />

#### 3. Start Using Claude Code

You can now start using Claude Code!

<Callout type="info" title="Launch Claude Code">
  Launch Claude Code directly:

  ```bash
  claude
  ```

  To use in a specific project:

  ```bash
  # Navigate to your project directory
  cd /path/to/your/project

  # Launch Claude Code
  claude
  ```
</Callout>

<img alt="linux-img-03.webp" src={__img33} placeholder="blur" />

<img alt="linux-img-04.webp" src={__img34} placeholder="blur" />

<img alt="linux-img-05.webp" src={__img35} placeholder="blur" />

<Callout type="info" title="Select Model">
  Enter the command:

  ```bash
  /model
  ```

  Press Enter to select an official model; usually, the default model is sufficient.
</Callout>

<img alt="linux-img-06.webp" src={__img36} placeholder="blur" />

<img alt="linux-img-07.webp" src={__img37} placeholder="blur" />

<img alt="linux-img-08.webp" src={__img38} placeholder="blur" />

<img alt="linux-img-09.webp" src={__img39} placeholder="blur" />

> Note: After modifying the `ANTHROPIC_BASE_URL` environment variable, all models (including officially preset models) will call the custom access point instead of using official account quotas.

#### 4. Linux Common Issues

<Callout type="info" title="Missing Dependency Libraries">
  Some Linux distributions require additional dependencies to be installed:

  ```bash
  # Ubuntu/Debian
  sudo apt install build-essential

  # CentOS/RHEL
  sudo dnf groupinstall "Development Tools"
  ```
</Callout>

<Callout type="info" title="Environment Variables Not Taking Effect">
  Check the following points:

  * Confirm that you modified the correct configuration file (`.bashrc` or `.zshrc`)
  * Restart the terminal or run `source ~/.bashrc`
  * Verify settings: `echo $ANTHROPIC_BASE_URL`
</Callout>


# OpenAI Codex CLI











































































<Callout type="info" title="Project Introduction">
  Codex CLI is a coding agent from OpenAI that runs locally on your computer.

  * Official Homepage: [https://chatgpt.com/codex](https://chatgpt.com/codex)
  * Project Homepage: [https://github.com/openai/codex](https://github.com/openai/codex)
</Callout>

## Demo

<img alt="introduce-01.webp" src={__img0} placeholder="blur" />

### Features

| **Feature Category**            | **Feature**                                                                                                                                                                          |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Terminal-based Coding Assistant | Codex CLI is a terminal-based interactive coding assistant for editing code, generating patches, and running commands in the command line.                                           |
| Tool-driven Architecture        | Provides tools such as `apply_patch`, `shell`, `update_plan`, and `multi_tool_use` for controlled modifications to repository files and operations.                                  |
| Atomic Patch Editing            | Uses a dedicated patch format to atomically add/update/delete files via `apply_patch`, facilitating auditing and rollback.                                                           |
| Sandboxing and Approval         | Supports sandboxing policies (e.g., `workspace-write`, `read-only`) and approval modes (`on-request`, `on-failure`, `never`) to control write and network access permissions.        |
| Plan Tracking                   | `update_plan` is used to list steps and track status, requiring only one `in_progress` step at all times to maintain clear progress.                                                 |
| Interaction Protocol            | Sends brief introductory explanations before important operations, maintaining a friendly, concise tone and providing progress updates.                                              |
| Security Constraints            | Adheres to strict rules (no arbitrary changes to unrelated files, no adding copyright headers, no executing destructive commands), requiring user approval for sensitive operations. |
| Testing and Formatting          | Recommends running relevant tests and formatting tools after modifications, but is not responsible for fixing issues unrelated to the current task.                                  |
| Output and Style                | Final output follows CLI rendering specifications (e.g., `**` for headings, backticks for paths/commands), maintaining a scannable, concise structure.                               |
| Parallel Execution              | Supports running multiple tools in parallel via `multi_tool_use.parallel` to improve efficiency.                                                                                     |

## AI Model Configuration Method

### Windows Graphical Guide

#### 1. Open Terminal

<img alt="windows_open_terminal" src={__img1} placeholder="blur" />

#### 2. Install WSL

For optimal performance on Windows, install and use Windows Subsystem for Linux (WSL2).

<Callout type="info" title="Install WSL2, Restart Windows Computer">
  ```powershell
  wsl --install
  ```

  Restart your Windows computer after installation.
</Callout>

<Callout type="warn" title="Windows Notes">
  * It is recommended to use PowerShell instead of CMD
  * If you encounter permission issues, try running as administrator
  * Some antivirus software may falsely flag it; you need to add it to the whitelist
</Callout>

<img alt="windows-img-03.webp" src={__img2} placeholder="blur" />

<Callout type="info" title="Download Node Version Manager (NVM)">
  ```bash
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
  ```
</Callout>

<img alt="windows-img-04.webp" src={__img3} placeholder="blur" />

<Callout type="info" title="NVM Installs Node.js 22">
  Open a new PowerShell window in the tab bar, then open WSL:

  ```bash
  wsl
  ```

  Install Node.js (version numbers are time-sensitive; please install the corresponding version according to [OpenAI's official website](https://developers.openai.com/codex/windows) requirements):

  ```bash
  nvm install 22
  ```
</Callout>

<img alt="windows-img-05.webp" src={__img4} placeholder="blur" />

#### 3. Install Codex CLI

<Callout type="info" title="Install Codex CLI">
  ```bash
  npm i -g @openai/codex
  ```

  This command downloads and installs the latest version of Codex CLI from the official npm repository.
</Callout>

<img alt="windows-img-06.webp" src={__img5} placeholder="blur" />

#### 4. Modify Configuration File

<Callout type="info" title="One-click Modification of Codex CLI Configuration File">
  ```powershell
  iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.ps1')
  ```
</Callout>

<img alt="windows-configure" src={__img6} placeholder="blur" />

#### 5. Start Using Codex CLI

Now you can start using Codex CLI!

<Callout type="info" title="Launch Codex CLI">
  Launch WSL2:

  ```bash
  wsl
  ```

  Launch Codex CLI directly:

  ```bash
  codex
  ```

  Use in a specific project:

  ```bash
  cd mnt/c/path/to/your/project
  codex
  ```

  Press Enter to launch Codex CLI.
</Callout>

<img alt="windows-img-09.webp" src={__img7} placeholder="blur" />

<img alt="windows-img-10.webp" src={__img8} placeholder="blur" />

> Set Codex CLI permissions: 1. Allow Codex to modify files directly; 2. Codex requires manual authorization to modify files

<Callout type="info" title="Select Model">
  ```bash
  /model
  ```
</Callout>

<img alt="windows-img-11.webp" src={__img9} placeholder="blur" />

<img alt="windows-img-12.webp" src={__img10} placeholder="blur" />

<img alt="windows-img-13.webp" src={__img11} placeholder="blur" />

<img alt="windows-img-14.webp" src={__img12} placeholder="blur" />

> Note: After modifying the API address, all models (including officially preset models) will call the custom access point and will not use the official account quota.

### macOS Graphical Guide

#### 1. Install Homebrew (Skip if already installed)

Homebrew is the missing package manager for macOS.

Official Website: [https://brew.sh](https://brew.sh)

<img alt="macos-img-01.webp" src={__img13} placeholder="blur" />

<Callout type="info" title="Install Homebrew">
  ```bash
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  ```
</Callout>

<img alt="macos-img-02.webp" src={__img14} placeholder="blur" />

<img alt="macos-img-03.webp" src={__img15} placeholder="blur" />

<img alt="macos-img-04.webp" src={__img16} placeholder="blur" />

#### 2. Install Node.js Environment

<Callout type="info" title="Node.js Environment Installation Steps">
  Update Homebrew:

  ```bash
  brew update
  ```

  Install Node.js:

  ```bash
  brew install node
  ```
</Callout>

<Callout type="warn" title="macOS Notes">
  * If you encounter permission issues, you might need to use `sudo`
  * The first run might require permission in System Preferences
  * It is recommended to use Terminal or iTerm2
</Callout>

<img alt="macos-img-05.webp" src={__img17} placeholder="blur" />

<img alt="macos-img-06.webp" src={__img18} placeholder="blur" />

<Callout type="info" title="Verify Installation Success">
  After installation, open the terminal and enter the following commands:

  ```bash
  node --version
  npm --version
  ```

  If version numbers are displayed, the installation was successful.
</Callout>

#### 3. Install Codex CLI

<Callout type="info" title="Install Codex CLI">
  Open the terminal and run the following commands:

  ```bash
  # Install Codex CLI globally
  npm install -g @openai/codex
  ```

  If you encounter permission issues, you can use sudo:

  ```bash
  sudo npm install -g @openai/codex
  ```
</Callout>

<img alt="macos-img-07.webp" src={__img19} placeholder="blur" />

<Callout type="info" title="Verify Codex CLI Installation">
  After installation, enter the following command to check if the installation was successful:

  ```bash
  codex --version
  ```

  If a version number is displayed, congratulations! Codex CLI has been successfully installed.
</Callout>

#### 4. Modify Configuration File

<Callout type="info" title="One-click Modification of Codex CLI Configuration File">
  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img20} placeholder="blur" />

#### 5. Start Using Codex CLI

Now you can start using Codex CLI!

<Callout type="info" title="Launch Codex CLI">
  Launch Codex CLI directly:

  ```bash
  codex
  ```

  Use in a specific project:

  ```bash
  cd /path/to/your/project
  codex
  ```

  Press Enter to launch Codex CLI.
</Callout>

<img alt="macos-img-09.webp" src={__img21} placeholder="blur" />

<img alt="macos-img-10.webp" src={__img22} placeholder="blur" />

> Set Codex CLI permissions: 1. Allow Codex to modify files directly; 2. Codex requires manual authorization to modify files

<img alt="macos-img-11.webp" src={__img23} placeholder="blur" />

<img alt="macos-img-12.webp" src={__img24} placeholder="blur" />

<img alt="macos-img-13.webp" src={__img25} placeholder="blur" />

<img alt="macos-img-14.webp" src={__img26} placeholder="blur" />

> Note: After modifying the API address, all models (including officially preset models) will call the custom access point and will not use the official account quota.

#### 6. macOS Common Issues Troubleshooting

<Callout type="info" title="Permission Error During Installation">
  Try the following solutions:

  * Install with `sudo`: `sudo npm install -g @openai/codex`
  * Or configure `npm` to use the user directory: `npm config set prefix ~/.npm-global`
</Callout>

<Callout type="info" title="macOS Security Settings Prevent Running">
  If the system prevents Codex CLI from running:

  * Open "System Preferences" → "Security & Privacy"
  * Click "Open Anyway" or "Allow"
  * Or run in Terminal: `sudo spctl --master-disable`
</Callout>

### Linux Graphical Guide

#### 1. Install Node.js Environment

Codex CLI requires a Node.js environment to run.

<Callout type="info" title="Node.js Environment Installation Steps">
  Add NodeSource repository:

  ```bash
  sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  ```

  Install Node.js:

  ```bash
  sudo apt-get install -y nodejs
  ```
</Callout>

<Callout type="warn" title="Linux Notes">
  * Some distributions may require additional dependencies
  * If you encounter permission issues, use sudo
  * Ensure your user has write permissions in npm's global directory
</Callout>

<img alt="linux-img-01.webp" src={__img27} placeholder="blur" />

<img alt="linux-img-02.webp" src={__img28} placeholder="blur" />

<Callout type="info" title="Verify Installation Success">
  After installation, open the terminal and enter the following commands:

  ```bash
  node --version
  npm --version
  ```

  If version numbers are displayed, the installation was successful.
</Callout>

#### 2. Install Codex CLI

<Callout type="info" title="Install Codex CLI">
  Open the terminal and run the following commands:

  ```bash
  # Install Codex CLI globally
  npm install -g @openai/codex
  ```

  If you encounter permission issues, you can use sudo:

  ```bash
  sudo npm install -g @openai/codex
  ```
</Callout>

<img alt="linux-img-03.webp" src={__img29} placeholder="blur" />

<Callout type="info" title="Verify Codex CLI Installation">
  After installation, enter the following command to check if the installation was successful:

  ```bash
  codex --version
  ```

  If a version number is displayed, congratulations! Codex CLI has been successfully installed.
</Callout>

#### 3. Modify Configuration File

<Callout type="info" title="One-click Modification of Codex CLI Configuration File">
  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img30} placeholder="blur" />

#### 4. Start Using Codex CLI

Now you can start using Codex CLI!

<Callout type="info" title="Launch Codex CLI">
  Launch Codex CLI directly:

  ```bash
  codex
  ```

  Use in a specific project:

  ```bash
  # Navigate to your project directory
  cd /path/to/your/project

  # Launch Codex CLI
  codex
  ```

  Press Enter to launch Codex CLI.
</Callout>

<img alt="linux-img-05.webp" src={__img31} placeholder="blur" />

<img alt="linux-img-06.webp" src={__img32} placeholder="blur" />

> Set Codex CLI permissions: 1. Allow Codex to modify files directly; 2. Codex requires manual authorization to modify files

<img alt="linux-img-07.webp" src={__img33} placeholder="blur" />

<img alt="linux-img-08.webp" src={__img34} placeholder="blur" />

<img alt="linux-img-09.webp" src={__img35} placeholder="blur" />

<img alt="linux-img-10.webp" src={__img36} placeholder="blur" />

> Note: After modifying the API address, all models (including officially preset models) will call the custom access point and will not use the official account quota.

#### 5. Linux Common Issues Troubleshooting

<Callout type="info" title="Permission Error During Installation">
  Try the following solutions:

  * Install with `sudo`: `sudo npm install -g @openai/codex`
  * Or configure `npm` to use the user directory: `npm config set prefix ~/.npm-global`
  * Then add to PATH: `export PATH=~/.npm-global/bin:$PATH`
</Callout>

<Callout type="info" title="Missing Dependency Libraries">
  Some Linux distributions require additional dependencies:

  ```bash
  # Ubuntu/Debian
  sudo apt install build-essential

  # CentOS/RHEL
  sudo dnf groupinstall "Development Tools"
  ```
</Callout>


# Factory Droid CLI















<Callout type="info" title="Project Introduction">
  Droid CLI is a command-line tool developed by Factory AI, designed to run as an AI software engineering agent. It allows users to interact with various large language models through the terminal, build, debug, and refactor code, and even create complete applications.

  * Official Homepage: [https://factory.ai/product/cli](https://factory.ai/product/cli)
  * Official Documentation: [https://docs.factory.ai/cli/getting-started/quickstart](https://docs.factory.ai/cli/getting-started/quickstart)
</Callout>

## Demo

<img alt="droid.webp" src={__img0} placeholder="blur" />

### Features

| Category                       | Feature                                                                                                                     | Value/Capability                                               | Example/Notes                                                                          |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Quick Start with CLI           | 30-second installation; launch droid interactive session in project directory; supports macOS/Linux and Windows             | Rapid integration into current projects, no new tools required | Windows Installation: `irm https://app.factory.ai/cli/windows \| iex`; Launch: `droid` |
| End-to-End Feature Development | Full-process automation from planning to implementation to testing; transparent review process                              | Accelerate delivery, maintain human oversight                  | Native diff viewing and approval process (see "Transparency and Control")              |
| Deep Codebase Understanding    | Integrates organizational shared knowledge from codebases, documentation, issue tracking; context-aware, improves over time | More accurate suggestions and changes                          | Continuously leverages knowledge across repositories and documents                     |
| Engineering System Integration | Native integration with Jira, Notion, Slack, and other tools; development work stays synchronized with team processes       | Reduce tool switching and information silos                    | "etc." indicates more integrations                                                     |
| Production-Grade Automation    | Workflows reusable locally and in CI/CD; enterprise-grade security and compliance built-in                                  | Consistency and auditability                                   | Adapts to pipelines and enterprise environments                                        |
| Enterprise Capabilities        | Private deployment options, SOC-2 compliance, air-gapped environments                                                       | Meets security and compliance requirements                     | Prioritizes security and quality                                                       |
| Enhance Existing Tools         | Works in terminal, IDE, and existing development environments; no need to switch editors or learn new interfaces            | Maintain existing work habits, low migration cost              | Deep integration with familiar tools                                                   |
| Transparency and Control       | Every decision is visible and reviewable; complete oversight of code changes; native diff viewing and approval workflows    | Reduce risk, enhance controllability                           | Audit-friendly, traceable                                                              |
| Model Flexibility              | Not locked to a single AI provider; choose the best model per task; consistent organizational behavior and memory           | Optimal choice between performance and cost                    | Supports multi-model routing                                                           |
| Next Steps & Resources         | Quickstart, Common Use Cases, IDE Integration, Configuration, AGENTS.md                                                     | Facilitates adoption and practice                              | See "Next steps/Additional resources" on the page                                      |

## AI Model Configuration Method

### Windows Graphical Guide

#### 1. Open Terminal

<img alt="windows_open_terminal" src={__img1} placeholder="blur" />

#### 2. Install Factory Droid CLI

Official one-click installation command:

<Callout type="info" title="One-click Installation Command">
  ```powershell
  irm https://app.factory.ai/cli/windows | iex
  ```
</Callout>

<img alt="windows-install" src={__img2} placeholder="blur" />

#### 3. Modify Configuration File

Droid CLI requires modifying the configuration file to use third-party APIs.

<img alt="windows-configure.webp" src={__img3} placeholder="blur" />

<Callout type="info" title="Modify Environment Variables">
  ```powershell
  iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')
  ```
</Callout>

#### 4. Start Using Droid CLI

Now you can start using Droid CLI!

<Callout type="info" title="Launch Droid CLI">
  Launch Droid CLI directly:

  ```bash
  droid
  ```

  Use in a specific project:

  ```bash
  # Navigate to your project directory
  cd C:\path\to\your\project

  # Launch Droid CLI
  droid
  ```

  Press Enter to launch Droid CLI.
</Callout>

Droid CLI requires users to log in to an official account (free) before use.

#### 5. Windows Common Issues Solution

<Callout type="info" title="Installation prompts &#x22;permission denied&#x22; error">
  This is usually a permission issue. Try the following solutions:

  * Run PowerShell as an administrator
  * Or configure `npm` to use the user directory: `npm config set prefix %APPDATA%\npm`
</Callout>

<Callout type="info" title="PowerShell Execution Policy Error">
  If you encounter an execution policy restriction, run:

  ```powershell
  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  ```
</Callout>

### macOS/Linux Graphical Guide

#### 1. Install Droid CLI

<Callout type="info" title="Install Droid CLI">
  Open your terminal and run the following command:

  ```bash
  curl -fsSL https://app.factory.ai/cli | sh
  ```
</Callout>

<img alt="macos-open-terminal" src={__img4} placeholder="blur" />

<img alt="macos-img-02.webp" src={__img5} placeholder="blur" />

Follow the installation prompts to modify environment variables (copy the installation prompt code directly):

For Linux, choose `~/.bashrc` or `~/.zshrc` as appropriate.

<Callout type="info" title="Droid CLI Environment Variables (Example Only)">
  ```bash
  echo 'export PATH=/Users/modify_here/.local/bin:$PATH' >> ~/.zshrc
  source ~/.zshrc
  ```
</Callout>

#### 2. Modify Configuration File

Droid CLI requires modifying the configuration file to use third-party APIs.

<Callout type="info" title="One-click Configuration File Modification">
  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-img-03.webp" src={__img6} placeholder="blur" />

#### 3. Start Using Droid CLI

Now you can start using Droid CLI!

<Callout type="info" title="Launch Droid CLI">
  Launch Droid CLI directly:

  ```bash
  droid
  ```

  Use in a specific project:

  ```bash
  # Navigate to your project directory
  cd /path/to/your/project

  # Launch Droid CLI
  droid
  ```

  Press Enter to launch Droid CLI.
</Callout>

> Droid CLI requires users to log in to an official account (free) before use.


# FluentRead - Open Source Translation Plugin









<Callout type="info" title="Chat Settings Options">
  In the System Settings -> Chat Settings of the New API console, you can add
  the following shortcut options for easy one-click population to FluentRead on
  the Token Management page:
</Callout>

```json
{ "流畅阅读": "fluentread" }
```

<Callout type="info">
  🌊 FluentRead is an open-source browser translation plugin dedicated to
  providing a native-like reading experience.
</Callout>

* Project Address: [https://github.com/Bistutu/FluentRead](https://github.com/Bistutu/FluentRead)

## 🌟 Core Features

### Smart Translation Engine

* **Multi-Engine Support**: Supports 20+ translation engines
* **Traditional Translation**: Microsoft Translate, Google Translate, DeepL Translate, etc.
* **AI Large Models**: OpenAI, DeepSeek, Kimi, Ollama, etc.
* **Custom Engine**: Supports custom translation service configuration

### Immersive Reading Experience

* **Bilingual Comparison**: Original and translated text displayed side-by-side for easier reading
* **Selection Translation**: Select any text to get instant translation results
* **One-Click Copy**: Quickly copy translated text to improve reading efficiency
* **Full-Page Translation**: One-click translation of the entire webpage with a floating button, no page refresh required

### Privacy and Customization

* **Privacy Protection**: All data stored locally, open-source and transparent code
* **High Customization**: Rich customization options to meet different scenario needs
* **Completely Free**: Open-source and free, non-commercial project

## 📦 Installation Methods

| Browser     | Installation Method                                                                                                                                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Chrome**  | [Chrome Web Store](https://chromewebstore.google.com/detail/%E6%B5%81%E7%95%85%E9%98%85%E8%AF%BB/djnlaiohfaaifbibleebjggkghlmcpcj?hl=zh-CN\&authuser=0) \| [Domestic Mirror](https://www.crxsoso.com/webstore/detail/djnlaiohfaaifbibleebjggkghlmcpcj) |
| **Edge**    | [Edge Add-ons Store](https://microsoftedge.microsoft.com/addons/detail/%E6%B5%81%E7%95%85%E9%98%85%E8%AF%BB/kakgmllfpjldjhcnkghpplmlbnmcoflp?hl=zh-CN)                                                                                                 |
| **Firefox** | [Firefox Add-ons Store](https://addons.mozilla.org/zh-CN/firefox/addon/%E6%B5%81%E7%95%85%E9%98%85%E8%AF%BB/)                                                                                                                                          |

## 🚀 Configuration Methods

### Import Configuration from New API Console (Recommended)

After the FluentRead plugin is installed in your browser, opening the New API console -> Token Management page will display a prompt to add FluentRead.

<img alt="添加提示" src={__img0} placeholder="blur" />

After selecting a model, click 'One-click fill to FluentRead', and a confirmation window will pop up. Check if the corresponding information is correct.

<img alt="确认" src={__img1} placeholder="blur" />

After confirming the import, the New API configuration in FluentRead will be enabled.

<img alt="配置结果" src={__img2} placeholder="blur" />

### Manually Fill in Configuration in FluentRead

<img alt="手动配置" src={__img3} placeholder="blur" />

| Configuration Item  | Content                                 |
| ------------------- | --------------------------------------- |
| Translation Service | NewAPI                                  |
| Access Token        | NewAPI Key                              |
| NewAPI Endpoint     | NewAPI Deployment Address (without /v1) |
| Model               | Select from list, or custom model       |
| Custom Model        | Model Name                              |


# AI Applications

import { Card, Cards } from 'fumadocs-ui/components/card';
import {
  Cherry,
  Sparkles,
  Terminal,
  BookOpen,
  MessageCircle,
  Languages,
  Bot,
  Settings,
} from 'lucide-react';

## Overview

New API is compatible with various popular AI applications and tools. Below is a list of verified supported applications and their configuration guides.

## Supported Applications

<Cards>
  <Card icon={<Sparkles />} title="AionUi" description="Free, local, open-source 24/7 Cowork and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more." href="/en/docs/apps/aionui" />

  <Card icon={<Settings />} title="CC Switch" description="One-click fill from New API token page; configure Claude, Codex, or Gemini with main and variant models in the popup." href="/en/docs/apps/cc-switch" />

  <Card icon={<Cherry />} title="Cherry Studio" description="A powerful AI assistant client that supports multi-model conversations." href="/en/docs/apps/cherry-studio" />

  <Card icon={<Bot />} title="Memoh" description="A containerized AI agent platform where each bot runs in its own container with long-term memory and multi-channel support." href="/en/docs/apps/memoh" />

  <Card icon={<Bot />} title="OpenClaw" description="A self-hosted AI assistant platform — install OpenClaw, connect to New API, and manage agents across Feishu, Discord, Slack, and more." href="/en/docs/apps/openclaw" />

  <Card icon={<BookOpen />} title="Fluent Read" description="An AI-powered smart reading and translation assistant." href="/en/docs/apps/fluent-read" />

  <Card icon={<MessageCircle />} title="LangBot" description="A large language model-based chatbot framework." href="/en/docs/apps/langbot" />

  <Card icon={<Languages />} title="Luna Translator" description="A real-time translation tool for games and documents." href="/en/docs/apps/luna-translator" />

  <Card icon={<Bot />} title="AstrBot" description="An open-source, all-in-one Agent chatbot platform." href="/en/docs/apps/astrbot" />

  <Card icon={<Terminal />} title="Claude Code" description="An Anthropic Claude-powered code editor integration." href="/en/docs/apps/claude-code" />

  <Card icon={<Terminal />} title="Codex CLI" description="A command-line interface AI code assistant tool." href="/en/docs/apps/codex-cli" />

  <Card icon={<Bot />} title="Factory Droid CLI" description="An AI agent tool for automating workflows." href="/en/docs/apps/factory-droid-cli" />
</Cards>

## Integration Guide

Most applications only require configuring the following information to connect to New API:

1. **API Address**: Your New API service address
2. **API Key**: The Token generated in the New API console
3. **Model Name**: Select the model to use

For specific configuration steps, please refer to the detailed documentation of each application.


# LangBot - Instant Messaging Bot Development Platform















<Callout type="info">
  LangBot is an open-source instant messaging bot development platform that
  supports various instant messaging platforms such as Feishu, DingTalk, WeChat,
  QQ, Telegram, Discord, Slack, etc. It integrates with mainstream global AI
  models, supports various AI application capabilities like Knowledge Base,
  Agent, MCP, and is perfectly compatible with NewAPI.
</Callout>

* Official Website: [https://langbot.app](https://langbot.app/)
* Download Address: [https://github.com/langbot-app/LangBot/releases](https://github.com/langbot-app/LangBot/releases)
* Official Documentation: [https://docs.langbot.app](https://docs.langbot.app/)
* Open Source Address: [https://github.com/langbot-app/LangBot](https://github.com/langbot-app/LangBot)

## Integrating NewAPI

LangBot supports integrating with locally deployed NewAPI and third-party NewAPI services built using NewAPI.

### Usage

1. Obtain an API key from NewAPI
   <img alt="获取 API key" src={__img0} placeholder="blur" />

   If NewAPI is deployed locally, please configure the API address yourself (refer to [Container Network Connection](https://docs.langbot.app/en/workshop/network-details.html)). If using a third-party NewAPI service, you can copy the address from the page. Note that `/v1` needs to be appended to the address.

2. Add a model in LangBot, select NewAPI as the provider, and fill in the corresponding API key and API address
   <img alt="添加 NewAPI 模型" src={__img1} placeholder="blur" />

3. Select the model to use in the pipeline

   <img alt="选择模型" src={__img2} placeholder="blur" />

4. Use it by chatting in conversation debugging or by chatting with a bot bound to the pipeline

   <img alt="对话" src={__img3} placeholder="blur" />

   <img alt="微信对话" src={__img4} placeholder="blur" />

   For deploying and configuring bots, please refer to [Deploying Bots](https://docs.langbot.app/en/deploy/platforms/readme.html).

### Using LangBot Knowledge Base

LangBot supports using NewAPI's embedding models and utilizing them as vector models for the knowledge base.

1. Add an embedding model in LangBot, select NewAPI as the provider
   <img alt="添加嵌入模型" src={__img5} placeholder="blur" />

2. Select the embedding model when creating a new knowledge base
   <img alt="使用嵌入模型" src={__img6} placeholder="blur" />

For more usage instructions, please refer to the LangBot official documentation: [https://docs.langbot.app](https://docs.langbot.app/)


# LunaTranslator - Open-source GalGame Translator

























<Callout type="info" title="Chat Settings Options">
  In the New API console's System Settings -> Chat Settings, you can add the
  following shortcut option for one-click population into LunaTranslator on the
  Token Management page:
</Callout>

```json
{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }
```

<Callout type="info">
  LunaTranslator is an open-source and free visual novel (GalGame) translator,
  dedicated to providing a native-level visual novel gaming experience.
</Callout>

* Project Address: [https://github.com/HIllya51/LunaTranslator](https://github.com/HIllya51/LunaTranslator)
* Project Documentation: [https://docs.lunatranslator.org](https://docs.lunatranslator.org/en/README.html)

## Feature Support

* **HOOK** Primarily uses HOOK to extract game text, adapting to almost all common and niche visual novels.

* **In-game Translation** Some games can also have translations directly embedded in-game for an immersive experience.

* **HOOK Emulator** For most games on NS/PSP/PSV/PS2, HOOK emulator is supported to directly read game text.

* **OCR** Built-in high-precision OCR models, and supports many other online & offline OCR engines for flexible reading of any text.

* **Rich Translation Interfaces** Supports almost all translation engines, including large language model translation, offline translation, etc.

* **Language Learning** Supports Japanese word segmentation and kana furigana, AnkiConnect, and Yomitan plugin.

* **Speech Synthesis** Supports a large number of online & offline speech synthesis engines.

* **Speech Recognition** On Windows 10 and Windows 11, Windows Speech Recognition can be used.

## Installation

Download and install from [LunaTranslator Documentation - Download & Launch & Update](https://docs.lunatranslator.org/en/README.html)

## Integrating NewAPI into LunaTranslator

LunaTranslator supports integrating with locally deployed NewAPI and third-party NewAPI services built using NewAPI.

### One-Click Configuration

1. In the New API console's `System Settings` -> `Chat Settings`, add the following shortcut option:

   ```json
   { "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }
   ```

   <img alt="add_config" src={__img0} placeholder="blur" />

2. In the **`NewAPI`** -> `Console` -> `Token Management` tab, select the token to be used in LunaTranslator, click the dropdown option next to the chat button, select `LunaTranslator`, and it will jump to LunaTranslator and automatically configure the API address and API Key.

   <img alt="跳转到 LunaTranslator" src={__img1} placeholder="blur" />

3. In **`LunaTranslator`** -> `Settings` -> `Translation Settings` -> `Large Models`, a new large model interface configuration will appear; click Edit.

   <img alt="设置api" src={__img2} placeholder="blur" />

4. Click the refresh button next to the **model** dropdown box to get the NewAPI platform's model list, select or enter the model name, then click OK to save.

   <img alt="设置模型" src={__img3} placeholder="blur" />

5. Check if the toggle button next to the **new\_api** large model interface configuration is open; if not enabled, enable the interface to start using it.

   <img alt="开启配置" src={__img4} placeholder="blur" />

### Manual Configuration

1. In the **`NewAPI`** -> `Console` -> `Token Management` tab, obtain the API Key.

   <img alt="获取 API Key" src={__img5} placeholder="blur" />

2. In **`LunaTranslator`** -> `Settings` - `Translation Settings` -> `Large Models`, select Add.

   <img alt="添加 API" src={__img6} placeholder="blur" />

3. Copy the **Large Model General Interface** template and add a new interface.

   <img alt="添加 API2" src={__img7} placeholder="blur" />

4. In the **newly added interface**, fill in the corresponding API address and API Key.

   <img alt="设置 API1" src={__img8} placeholder="blur" />

   <img alt="设置 API2" src={__img9} placeholder="blur" />

5. Click the refresh button next to the **model** dropdown box to get the NewAPI platform's model list, select or enter the model name, then click OK to save.

   <img alt="设置 API3" src={__img10} placeholder="blur" />

6. Click the toggle button next to **NewAPI** to enable the interface and start using it.

   <img alt="打开API" src={__img11} placeholder="blur" />

For more usage methods, please refer to the LunaTranslator official documentation: [LunaTranslator Documentation - Large Model Translation Interface](https://docs.lunatranslator.org/en/guochandamoxing.html)


# Memoh - Containerized AI Agent Platform







<Callout type="info">
  Memoh is an open-source, self-hosted AI agent platform where each bot runs in
  its own isolated container with persistent memory and a dedicated filesystem.
  It supports 9 channels including Telegram, Discord, Lark (Feishu), QQ, Matrix,
  WeCom, WeChat, Email, and a built-in Web UI, along with MCP tool calling,
  browser automation, scheduled tasks, and other rich agent capabilities.
</Callout>

* Website: [https://memoh.sh](https://memoh.sh)
* Documentation: [https://docs.memoh.ai](https://docs.memoh.ai)
* GitHub: [https://github.com/memohai/Memoh](https://github.com/memohai/Memoh)

## Key Features

* **Containerized Isolation**: Each bot runs in its own containerd container with a dedicated filesystem and network, supporting snapshots and data import/export
* **Memory Engine**: LLM-driven fact extraction, hybrid retrieval (dense + sparse + BM25), 24-hour context loading, memory compaction and rebuild
* **Multi-Channel Support**: Telegram, Discord, Lark (Feishu), QQ, Matrix, WeCom, WeChat, Email, Web UI
* **MCP Support**: Full MCP protocol support (HTTP / SSE / Stdio / OAuth), with independent MCP connection management per bot
* **Browser Automation**: Built-in headless browser powered by Playwright, supporting web browsing, form filling, screenshots, and more
* **Web Dashboard**: Modern management interface built with Vue 3 + Tailwind CSS, featuring streaming chat, tool call visualization, file management, and more

## Quick Installation

Memoh is deployed via Docker. One-click install (requires Docker):

```bash
curl -fsSL https://memoh.sh | sudo sh
```

Or install manually:

```bash
git clone --depth 1 https://github.com/memohai/Memoh.git
cd Memoh
cp conf/app.docker.toml config.toml
# Edit the config.toml configuration file
sudo docker compose up -d
```

After startup, visit `http://localhost:8082`. Default credentials: `admin` / `admin123`.

## NewAPI Integration

Memoh supports any OpenAI-compatible model provider, allowing you to use NewAPI to centrally manage and access various AI model services.

### Configuration Steps

#### Obtain a NewAPI API Key

After registering and logging in to NewAPI, click "Console" in the top navigation bar, then click "Token Management", and click the "Add Token" button to create a new API Key. Select the appropriate permissions and click "Create".

Once created, click the copy button to copy the generated API Key.

<img alt="copy-api-key" src={__img0} placeholder="blur" />

#### Add a Model Provider in Memoh

Log in to the Memoh Web dashboard, go to the provider management page, and click NewAPI.

<img alt="switch-to-newapi-provider" src={__img1} placeholder="blur" />

Fill in the following information on the configuration page:

* **API Base URL**: Enter the NewAPI endpoint URL, e.g. `https://api.example.com/v1` (use `http://localhost:3000/v1` for local deployments)
* **API Key**: Paste the API Key copied from NewAPI

Click Save to complete the provider configuration.

#### Import Models

After configuring the provider, go to the model management page and click auto-import or manually add the models you need.

#### Configure a Model for Your Bot

Go to the bot settings page, find the model configuration section, switch the default chat model to the one added via the NewAPI provider, and click Save.

<img alt="set_chat_model" src={__img2} placeholder="blur" />

You have now successfully configured NewAPI as the model provider for Memoh. You can chat with AI bots through any of Memoh's channels (Telegram, Discord, Lark, etc.), and all requests will be routed through NewAPI.


# OpenClaw - Self-Hosted AI Smart Assistant Platform

<Callout type="info" title="Project Introduction">
  OpenClaw is an open-source, self-hosted personal AI
  assistant platform that connects messaging apps to AI
  agents running on your own hardware. Designed for developers and advanced users, it allows you to have an autonomous AI assistant without giving up control of your data.

  * Official Homepage: [https://openclaw.ai](https://openclaw.ai)
  * Project Documentation: [https://docs.openclaw.ai](https://docs.openclaw.ai)
  * GitHub: [https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)
</Callout>

OpenClaw is completely open source. You can browse the source code, submit issues, or contribute at [OpenClaw's GitHub repository](https://github.com/openclaw/openclaw). This tutorial covers the complete steps for installation, configuration, and integrating OpenClaw with New API.

## 🌟 Core Features

### Multi-Channel Integration

* **Multi-channel integration**: Supports various messaging channels like Telegram, Discord, WhatsApp, iMessage, and can be extended to more platforms via plugins.
* **Single Gateway**: Unified management of all channels through a single Gateway process.
* **Voice Support**: Supports macOS/iOS/Android voice interaction.
* **Canvas Interface**: Capable of rendering interactive Canvas interfaces.

### Self-Hosting and Data Security

* **Fully Self-Hosted**: Runs on your own machine or server.
* **Open Source & Transparent**: MIT open-source license, fully transparent code.
* **Data Localization**: Context and skills are stored on your local computer, not in the cloud.

### Smart Agent Capabilities

* **Continuous Operation**: Supports persistent background operation with long-term memory.
* **Scheduled Tasks**: Supports cron-based scheduled tasks.
* **Session Isolation**: Isolates sessions by agent/workspace/sender.
* **Multi-Agent Routing**: Supports collaborative work among multiple agents.
* **Tool Calling**: Native support for tool calling and code execution.

## 📦 Pre-integration Preparation

<Callout type="info" title="Preparation Information">
  * Node.js 22 or higher
  * An available New API address (usually ending with `/v1`)
  * An available New API API Key
</Callout>

Before integrating with New API, it's recommended to first get the Gateway and Control UI running according to OpenClaw's currently recommended official process. This makes it easier to distinguish whether OpenClaw itself hasn't started or if the model provider configuration is incorrect when troubleshooting later.

### 1. Install OpenClaw (macOS/Linux)

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

For other installation methods, refer to the OpenClaw official documentation: [Getting Started](https://docs.openclaw.ai/start/getting-started).

### 2. Run the Onboarding Wizard

```bash
openclaw onboard --install-daemon
```

This wizard completes basic authentication, Gateway setup, and optional channel initialization. The goal here is to get OpenClaw running first, then switch the default model to New API later.

### 3. Check Gateway and Control UI

```bash
openclaw gateway status
```

```bash
openclaw dashboard
```

If your browser can open the Control UI, it means OpenClaw's basic operation is normal. At this stage, there's no need to configure messaging channels like Telegram, Discord, or Feishu yet.

### 4. Locate the Configuration File

OpenClaw's configuration file is usually located at `~/.openclaw/openclaw.json`. You can continue to modify it based on what the onboarding wizard generates.

<Callout type="tip" title="Path-Related Environment Variables">
  If you run OpenClaw under a dedicated service account, or wish to customize the configuration/state directory, you can use:

  * `OPENCLAW_HOME`
  * `OPENCLAW_STATE_DIR`
  * `OPENCLAW_CONFIG_PATH`

  For detailed explanations, see the official environment variables documentation: [Environment Variables](https://docs.openclaw.ai/help/environment).
</Callout>

## 🚀 Using New API as a Model Provider

OpenClaw supports integrating custom or OpenAI-compatible model gateways via `models.providers`. For New API, the most common approach is to add it as a custom provider to the configuration, then point the default model to `newapi/MODEL_ID`.

### Integration Approach

1. Declare a `newapi` provider under `models.providers`.
2. Point `baseUrl` to your New API address, ensuring it includes `/v1`.
3. Set `api` to `openai-completions`.
4. List the model IDs you want OpenClaw to use in `models`.
5. Switch the default model to `newapi/...` in `agents.defaults.model.primary`.

### Recommended Practice: Store API Keys in Environment Variables

First, provide your New API key in the current shell, service environment, or a `.env` file readable by OpenClaw:

```bash
export NEWAPI_API_KEY="sk-your-newapi-key"
```

Then, add or modify the following snippet in `openclaw.json`:

```json5
{
  models: {
    mode: "merge",
    providers: {
      newapi: {
        baseUrl: "https://<your-newapi-domain>/v1",
        apiKey: "${NEWAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "newapi/gemini-2.5-flash",
        fallbacks: ["newapi/kimi-k2.5"],
      },
      models: {
        "newapi/gemini-2.5-flash": { alias: "flash" },
        "newapi/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}
```

This is not a complete configuration to be copied verbatim, but rather the most critical part for integrating New API. As long as the `provider`, model ID, and default model references are correctly matched, OpenClaw will be able to call the model resources you expose via New API.

### Key Configuration Explanation

| Configuration Item                | Description                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------------- |
| `models.mode`                     | Recommended to set to `merge` to append `newapi` while retaining OpenClaw's built-in providers. |
| `models.providers.newapi.baseUrl` | Your New API address, usually needs to include `/v1`.                                           |
| `models.providers.newapi.apiKey`  | New API key, recommended to inject via `${NEWAPI_API_KEY}`.                                     |
| `models.providers.newapi.api`     | For OpenAI-compatible gateways like New API, use `openai-completions`.                          |
| `models.providers.newapi.models`  | The model IDs listed here must match the actual model names exposed by your New API.            |
| `agents.defaults.model.primary`   | Default primary model, format must be `provider/model-id`.                                      |
| `agents.defaults.model.fallbacks` | Fallback model list, automatically switches if the primary model fails.                         |
| `agents.defaults.models`          | Optional, used to create aliases for models, convenient for referencing in UI or conversations. |

### Verify Successful Integration

After completing the configuration, return to or reopen the Control UI:

```bash
openclaw dashboard
```

If you can initiate conversations normally in OpenClaw and the default model has become `newapi/...`, then the integration is successful. You can also use:

```bash
openclaw models list
```

to confirm that models with the `newapi/` prefix appear in the selectable list.

### Common Issues

* `baseUrl` without `/v1`: This is one of the most common integration errors.
* Incorrect model ID: `primary` and `fallbacks` must correspond to the `id` in `models.providers.newapi.models`.
* Key only effective in the current terminal: If Gateway runs as a background service, ensure the service process can also read `NEWAPI_API_KEY`.
* For foreground troubleshooting: You can use the official foreground running method `openclaw gateway --port 18789` to observe logs and errors.


# Business Cooperation

## 💡 Our Original Intention

The original intention behind New API's creation is simple: **to enable more people to use AI and lower the barrier to AI adoption.**

We believe that AI should not be a privilege for a few, but a tool accessible to everyone. Whether you are an independent developer, a startup team, or a large enterprise, you should be able to access world-leading large model capabilities at a reasonable cost.

## 🤝 About Commercialization

We chose commercialization not to maximize profit, but to ensure the project can **develop healthily and sustainably.**

Servers incur costs, maintenance requires effort, and ecosystem development needs resources – moderate commercialization is a necessary guarantee for New API to continue serving the community. We pledge to invest our earnings into product iteration, community building, and ecosystem expansion, ensuring that every bit of support translates into better services.

## 📜 Gentleman's Agreement

The New API community has always upheld the concept of a **Gentleman's Agreement**:

* We trust every user and provide flexible and open ways of use.
* We do not impose cumbersome restrictions, trusting that everyone will use resources responsibly.
* We expect users, while benefiting, to also respect the sustainable development of the project.
* If your project benefits from New API, we welcome contributions back to the community in any form.

This is an agreement based on trust and respect, and a continuation of the open-source spirit.

## 📬 Contact Information

<Callout type="info" title="Business Cooperation Email">
  [newapi@quantumnous.com](mailto:newapi@quantumnous.com)

  Email replies typically take 2-3 business days.
</Callout>

<Callout type="info" title="WeChat Work (Scan to Contact)">
  <img src="/assets/wechat.png" alt="WeChat Work QR Code" width="240" />
</Callout>

New API is dedicated to providing developers and enterprises with a unified gateway and asset management capabilities to connect with the global large model ecosystem. If you wish to engage in in-depth cooperation with us at the product, technology, channel, or market level, we sincerely welcome your inquiry!


# About



The About page in the navigation bar can be configured in System Settings -> Other Settings.

<img alt="About" src={__img0} placeholder="blur" />


# Documentation



Clicking "Documentation" in the top navigation bar will redirect to the documentation webpage (the documentation address is configured in System Settings -> Operation Settings).

<img alt="Documentation" src={__img0} placeholder="blur" />


# Home



Homepage content can be configured in System Settings -> Other Settings.

<img alt="Homepage" src={__img0} placeholder="blur" />


# Pricing



Here you can view site-wide model pricing.

<img alt="Pricing" src={__img0} placeholder="blur" />


# Installation & Deployment

import { Card, Cards } from 'fumadocs-ui/components/card';
import {
  Container,
  Boxes,
  Server,
  Network,
  Code2,
  Settings,
  RefreshCw,
  FileCode,
} from 'lucide-react';

## Overview

New API supports multiple deployment methods. You can choose the most suitable solution based on your technical background and usage scenario.

## Deployment Methods

<Cards>
  <Card icon={<Boxes />} title="Docker Compose Deployment" description="Orchestrate multiple services using Docker Compose, suitable for production environments." href="/en/docs/installation/deployment-methods/docker-compose-installation" />

  <Card icon={<Container />} title="Docker Single Container Deployment" description="Quick deployment using Docker image, suitable for personal use." href="/en/docs/installation/deployment-methods/docker-installation" />

  <Card icon={<Server />} title="1Panel Deployment" description="Quick deployment via 1Panel graphical interface." href="/en/docs/installation/deployment-methods/1panel-installation" />

  <Card icon={<Server />} title="Baota Panel Deployment" description="Quick deployment via Baota Panel graphical interface." href="/en/docs/installation/deployment-methods/bt-docker-installation" />

  <Card icon={<Network />} title="Cluster Deployment Mode" description="Multi-node distributed deployment for high availability and load balancing." href="/en/docs/installation/deployment-methods/cluster-deployment" />

  <Card icon={<Code2 />} title="Local Development Deployment" description="Suitable for developers contributing code and customizing features." href="/en/docs/installation/deployment-methods/local-development" />
</Cards>

## Configuration & Maintenance

<Cards>
  <Card icon={<FileCode />} title="docker-compose.yml Configuration" description="Detailed explanation of Docker Compose configuration file parameters." href="/en/docs/installation/config-maintenance/docker-compose-yml" />

  <Card icon={<Settings />} title="Environment Variables Configuration" description="Complete environment variables configuration guide and best practices." href="/en/docs/installation/config-maintenance/environment-variables" />

  <Card icon={<RefreshCw />} title="System Update" description="Learn how to safely update New API to the latest version." href="/en/docs/installation/config-maintenance/system-update" />
</Cards>


# Skills

import { Card, Cards } from 'fumadocs-ui/components/card';
import { User, Shield } from 'lucide-react';

## Overview

**Skills** are a lightweight extension protocol that allows AI editors (such as Claude Code, Codex, OpenClaw, Cursor, Windsurf, etc.) to interact with New API directly from within your coding environment — no browser or admin panel needed.

New API Skills already work in Claude Code, Codex, OpenClaw, and other Skills-compatible tools for model queries, token management, balance checks, and New API usage questions.

New API currently offers the following Skills:

<Cards>
  <Card icon={<User />} title="newapi" description="User-level Skill — query models, manage tokens, view groups, check balance, and ask New API usage questions in Claude Code, Codex, and OpenClaw." href="/en/docs/skills/newapi" />

  <Card icon={<Shield />} title="newapi-admin (Coming Soon)" description="Admin-level Skill — channel management, user management, system configuration and more. For New API administrators." href="/en/docs/skills/newapi-admin" />
</Cards>

## Supported AI Editors

All Skills work with the following AI coding tools:

| AI Editor / Coding Assistant | Type                              | Notes                                             |
| ---------------------------- | --------------------------------- | ------------------------------------------------- |
| **Claude Code**              | Terminal AI programming assistant | Official Anthropic CLI                            |
| **OpenClaw**                 | Self-hosted AI assistant platform | Supports Skills-based `/newapi` command workflows |
| **Cursor**                   | AI-native code editor             | VS Code based                                     |
| **Windsurf**                 | AI code editor                    | By Codeium                                        |
| **Cline**                    | VS Code AI extension              | Open-source AI coding agent                       |
| **Codex CLI**                | Terminal AI programming assistant | Official OpenAI CLI                               |

> Any tool that supports the Skills protocol can use New API Skills.

## Learn More

* GitHub Repository: [github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
* New API Website: [www.newapi.ai](https://www.newapi.ai)


# newapi-admin (Coming Soon)

import { Callout } from 'fumadocs-ui/components/callout';

<Callout type="warn" title="Under Development — Coming Soon">
  **newapi-admin** is currently under development and has not been released yet. Below is a preview of planned features. This page will be updated with full documentation upon release.
</Callout>

## Introduction

**newapi-admin** is a Skill plugin designed for New API administrators. Unlike the user-level [newapi](/en/docs/skills/newapi) Skill, newapi-admin focuses on **admin operations**, allowing site administrators to perform daily management tasks from within their AI editor using natural language commands — no need to log into the admin dashboard.

## Planned Features

### Channel Management

| Command (Planned)                   | Description                                            |
| ----------------------------------- | ------------------------------------------------------ |
| `/newapi-admin channels`            | List all channels and their status                     |
| `/newapi-admin channel-add`         | Add new channels (OpenAI, Claude, Gemini, Azure, etc.) |
| `/newapi-admin channel-test <id>`   | Test connectivity of a specific channel                |
| `/newapi-admin channel-toggle <id>` | Enable or disable a specific channel                   |
| `/newapi-admin channel-priority`    | View and adjust channel priority                       |

### User Management

| Command (Planned)                       | Description                               |
| --------------------------------------- | ----------------------------------------- |
| `/newapi-admin users`                   | List users                                |
| `/newapi-admin user-info <id>`          | View user details (balance, group, usage) |
| `/newapi-admin user-quota <id>`         | Adjust user quota and balance             |
| `/newapi-admin user-group <id> <group>` | Change user's group                       |
| `/newapi-admin user-ban <id>`           | Ban or unban a user                       |

### System Configuration

| Command (Planned)                        | Description                          |
| ---------------------------------------- | ------------------------------------ |
| `/newapi-admin config`                   | View current system configuration    |
| `/newapi-admin config-set <key> <value>` | Modify a system configuration item   |
| `/newapi-admin ratio`                    | View model rate multiplier settings  |
| `/newapi-admin ratio-sync`               | Sync upstream model rate multipliers |

### Logs & Monitoring

| Command (Planned)      | Description                                                      |
| ---------------------- | ---------------------------------------------------------------- |
| `/newapi-admin logs`   | View recent request logs                                         |
| `/newapi-admin stats`  | View system statistics (request volume, consumption, error rate) |
| `/newapi-admin status` | Check system health and channel connectivity                     |

### Token & Redemption Management

| Command (Planned)                 | Description                   |
| --------------------------------- | ----------------------------- |
| `/newapi-admin redemptions`       | List redemption codes         |
| `/newapi-admin redemption-create` | Batch create redemption codes |
| `/newapi-admin token-overview`    | Global token usage overview   |

## Comparison with newapi Skill

|                  | newapi                                   | newapi-admin                         |
| ---------------- | ---------------------------------------- | ------------------------------------ |
| **Target Users** | Regular users / developers               | Site administrators                  |
| **Scope**        | Personal models, tokens, balance, groups | Global channels, users, config, logs |
| **Permissions**  | User access token                        | Admin access token                   |
| **Status**       | Released                                 | Under development                    |

## Stay Updated

newapi-admin is under active development. Follow the repository for the latest updates:

* GitHub Repository: [github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
* Released user-level Skill: [newapi](/en/docs/skills/newapi)


# newapi

import { Callout } from 'fumadocs-ui/components/callout';
import { Step, Steps } from 'fumadocs-ui/components/steps';

<Callout type="info" title="What is newapi-skills?">
  **newapi-skills** is the official AI editor Skill plugin from New API. Skills are a lightweight extension protocol that enables AI coding assistants — such as Claude Code, Codex, OpenClaw, Cursor, Windsurf, and Cline — to **call New API endpoints directly from within the editor**, performing model queries, token management, balance checks, and answering New API deployment, configuration, and API usage questions without ever leaving your coding environment.

  * GitHub Repository: [github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)

  It now also works inside OpenClaw, so you can run `/newapi` commands for models, tokens, groups, and balance, and ask New API usage questions without leaving your agent workflow.
</Callout>

## Why Use Skills

During everyday AI development, developers frequently switch between their editor and the New API management dashboard — checking available models, creating API tokens, inspecting balance, adjusting group quotas. These context switches disrupt coding flow.

**What newapi-skills solves:**

* **Zero context-switching**: Issue natural language commands directly in Claude Code, Codex, OpenClaw, or other AI IDEs — no browser or admin panel needed
* **Built-in help**: Ask about New API deployment, configuration, groups, and API call formats directly from your coding workflow
* **Security-first design**: Keys are never shown in plain text; token copy and injection use secure channels (`sk-` prefixed keys never appear in terminal output or logs)
* **Instant setup**: A single `npx` command handles installation; runtime auto-detection (Bun / Node.js / Deno)
* **Cross-editor compatibility**: Works with any AI editor or coding assistant that implements the Skills protocol

## Supported AI Editors

newapi-skills works with the following AI coding tools:

| AI Editor / Coding Assistant | Type                              | Notes                                             |
| ---------------------------- | --------------------------------- | ------------------------------------------------- |
| **Claude Code**              | Terminal AI programming assistant | Official Anthropic CLI                            |
| **OpenClaw**                 | Self-hosted AI assistant platform | Supports Skills-based `/newapi` command workflows |
| **Cursor**                   | AI-native code editor             | VS Code based                                     |
| **Windsurf**                 | AI code editor                    | By Codeium                                        |
| **Cline**                    | VS Code AI extension              | Open-source AI coding agent                       |
| **Codex CLI**                | Terminal AI programming assistant | Official OpenAI CLI                               |

> Any tool that supports the Skills protocol can use newapi-skills.

## Commands Reference

Below is the complete list of commands provided by newapi-skills. These commands interact with the New API REST API to query and manage resources on your New API instance.

### Query Commands

| Command           | Description              | Use Case                                                                           |
| ----------------- | ------------------------ | ---------------------------------------------------------------------------------- |
| `/newapi models`  | List available AI models | View all models configured on your New API instance (OpenAI, Claude, Gemini, etc.) |
| `/newapi groups`  | List user groups         | View your account's groups with quota and rate multiplier settings                 |
| `/newapi balance` | Show account balance     | Real-time query of current user's balance and usage                                |

### Token Management Commands

| Command                                     | Description                 | Use Case                                                                                     |
| ------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------- |
| `/newapi tokens`                            | List API tokens             | View all created tokens (keys shown masked, e.g. `sk-reHR**********OspA`)                    |
| `/newapi create-token <name> [--group=xxx]` | Create new API token        | Generate independent API keys for different apps or projects                                 |
| `/newapi switch-group <token_id> <group>`   | Change token's group        | Modify token group to adjust model access permissions and rate multipliers                   |
| `/newapi copy-token <token_id>`             | Copy key to clipboard       | Securely copy the real key to system clipboard (key never displayed in terminal)             |
| `/newapi apply-token <token_id> <file>`     | Inject key into config file | Securely write token key into project config files (e.g. `.env`) via placeholder replacement |

### Help Command

| Command                   | Description       | Use Case                                                                  |
| ------------------------- | ----------------- | ------------------------------------------------------------------------- |
| `/newapi help <question>` | Ask about New API | Get help on New API deployment, configuration, API call formats, and more |

## Installation & Configuration

<Steps>
  <Step>
    ### Install newapi-skills

    One-line installation via `npx`:

    ```bash
    npx skills add https://github.com/QuantumNous/skills --skill newapi
    ```

    This pulls the latest Skill definition from the GitHub repository and installs it into your editor environment.
  </Step>

  <Step>
    ### Set Environment Variables

    newapi-skills requires three environment variables to connect to your New API instance. Add them to your shell profile:

    ```bash
    # ~/.bashrc or ~/.zshrc
    export NEWAPI_BASE_URL=https://<your-newapi-domain>
    export NEWAPI_ACCESS_TOKEN=your-access-token
    export NEWAPI_USER_ID=1
    ```

    | Variable              | Description                | Example                                                             |
    | --------------------- | -------------------------- | ------------------------------------------------------------------- |
    | `NEWAPI_BASE_URL`     | New API service URL        | `https://api.example.com`                                           |
    | `NEWAPI_ACCESS_TOKEN` | Admin or user access token | From "Personal Settings → Account → Security → System Access Token" |
    | `NEWAPI_USER_ID`      | User ID                    | `1` (admin default is 1)                                            |

    You can also create a `.env` file in your project root. Make sure `.env` is listed in `.gitignore` to prevent key leaks.
  </Step>

  <Step>
    ### Start Using

    Once installed, type `/newapi` commands in any Skills-compatible AI editor. For example:

    * Type `/newapi models` to list available models
    * Type `/newapi balance` to check your current balance
    * Type `/newapi create-token my-app` to create a new token named `my-app`
    * Type `/newapi help how do I configure groups and tokens?` to ask New API usage questions directly
    * In OpenClaw, you can also run `/newapi models`, `/newapi balance`, and token commands directly in your agent workflow
  </Step>
</Steps>

## Runtime Requirements

newapi-skills requires one of the following JavaScript runtimes (auto-detected at startup):

| Runtime     | Version | Recommendation        |
| ----------- | ------- | --------------------- |
| **Bun**     | Latest  | Recommended (fastest) |
| **Node.js** | >= 18   | Widely supported      |
| **Deno**    | Latest  | Optional              |

## Security

newapi-skills has multiple layers of security built in to protect your API keys:

* Token listings only show **masked keys** (e.g. `sk-reHR**********OspA`) — real keys never appear in terminal output
* `copy-token` copies the key to the system clipboard only, never displaying it in any output
* `apply-token` uses placeholder replacement to inject keys, never exposing raw key content
* All `sk-` prefixed key values are strictly protected throughout the entire execution flow

## Learn More

newapi-skills is under active development — commands and features may change with updates. Refer to the repository README for the latest information and changelog:

* GitHub Repository: [github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
* New API Website: [www.newapi.ai](https://www.newapi.ai)
* New API GitHub: [github.com/QuantumNous/new-api](https://github.com/QuantumNous/new-api)


# Buy Us a Coffee

## 💝 Why We Need Your Support

New API is a completely free and open-source project, and we always adhere to:

* 🆓 Permanently free to use
* 💻 Completely open-source code
* 🤝 Continuous updates and maintenance
* 👥 Community co-construction

It is precisely because of the support and encouragement from users like you that we can continue to maintain and improve this project. Every bit of your support is our motivation to move forward.

## 🌟 Your Support Will Help Us

* Maintain and upgrade servers
* Develop new features
* Optimize user experience
* Provide better documentation
* Build a better community

## 🎁 How to Sponsor

If you find New API helpful, feel free to buy us a coffee, allowing us to dedicate more effort to making the project even better!

[☕ Support Us on AfDian](https://afdian.com/a/new-api)

## 💌 Acknowledgments

Thank you to every supporter; your generosity enables this project to continue its development. We promise to:

* Work harder to maintain and improve the project
* Seriously consider every user's feedback
* Allocate every sponsorship contribution to project development
* Maintain the open-source and free nature of the project

!!! quote "A Message"
The development of open-source projects is inseparable from the power of the community. Every bit of your support is our motivation to move forward and the best interpretation of the open-source spirit.

Thank you for being willing to contribute to open-source projects! ❤️


# Community Interaction

Welcome to the New API open-source community! Here, you can exchange experiences and share ideas with other developers.

## 📜 Group Rules

To maintain a positive community atmosphere, please observe the following rules:

<Callout type="warn" title="Important Notice">
  Violation of these rules may result in removal from the chat group. All members are requested to read and comply carefully.
</Callout>

1. Group administrators and owners are under no obligation to provide you with any technical support. If you have questions, please submit an [issue](/en/docs/support/feedback-issues)
2. The group chat prohibits the posting of any account selling or buying information. Group nicknames are prohibited from containing any purchase guidance or buying-related information.
3. This group does not sell any API products. Please do not trust or purchase API products from anyone (including administrators).
4. New API adopts the GNU AGPLv3 open-source license. It can be used for free as long as the open-source license is complied with. For details, please see [Project Introduction](/en/docs/guide/wiki/basic-concepts/project-introduction)
5. This project must be used in compliance with relevant laws and regulations. Discussion of any illegal topics is prohibited.

<Callout title="Friendly Reminder">
  If you have any feature suggestions or bug feedback, it is recommended to submit an issue directly on GitHub, which allows for better tracking and resolution of problems.
</Callout>

## 🤝 Join Our QQ Communication Group

<Callout type="info" title="Please Complete the Questionnaire Before Joining">
  After carefully reading the group rules above, please complete the following questionnaire for verification. The QQ group information will only be displayed if all questions are answered correctly.
</Callout>

<QQGroupQuiz locale="en" />


# FAQ

import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';

## 💰 Quota-Related Issues

<Accordions>
  <Accordion title="What is quota? How is it calculated?">
    The quota calculation formula is as follows:

    ```
    Quota = Group Ratio * Model Ratio * (Prompt Token Count + Completion Token Count * Completion Ratio)
    ```

    **Completion Ratio Explanation:**

    * GPT3.5: Fixed at 1.33
    * GPT4: Fixed at 2 (consistent with official)

    **Notes:**

    * In non-streaming mode, the official API returns the total tokens consumed, but the consumption ratios for prompt and completion are different.
    * The default ratio of New API is consistent with the official ratio and has been adjusted.
  </Accordion>

  <Accordion title="Why does it prompt insufficient quota when the account quota is sufficient?">
    This is because token quota and account quota are separate:

    * Token quota is only used to set the maximum usage limit.
    * Users can freely set the token quota.
    * Please check if your token quota is sufficient.
  </Accordion>
</Accordions>

## 🔧 Channel Configuration Issues

<Accordions>
  <Accordion title="What are Weight and Priority in Channels?">
    Weight and Priority are two important parameters that control the order and distribution of channel usage:

    * **Priority**: A larger number indicates higher priority; channels with higher priority will be used first.
    * **Weight**: Among channels with the same priority, requests are distributed according to the weight ratio.

    **For example:**

    * Channels with priority 2 will be used before channels with priority 1.
    * For two channels with the same priority 1, if the weight ratio is 2:1, requests will be distributed in a 2:1 ratio.
  </Accordion>

  <Accordion title="Prompt: No available channels?">
    Please check the following settings:

    1. User Group Settings
    2. Channel Group Settings
    3. Channel Model Settings
  </Accordion>

  <Accordion title="Channel test error: invalid character '<' looking for beginning of value">
    This error indicates that the return value is not valid JSON, but an HTML page.

    The most likely reason is: Your deployment site's IP or proxy node has been blocked by CloudFlare.
  </Accordion>

  <Accordion title="Channel test error: Ratio or price not configured, please contact the administrator to set it.">
    Please check if the ratio or price has been configured in "System Settings - Operation Settings - Model Ratio Settings".

    Or enable "Self-use Mode" in "System Settings - Operation Settings".
  </Accordion>
</Accordions>

## 🌐 Deployment and Connection Issues

<Accordions>
  <Accordion title="ChatGPT Next Web error: Failed to fetch">
    Please check the following:

    1. Do not set `BASE_URL` during deployment.
    2. Confirm that the API address and API Key are filled in correctly.
    3. Check if HTTPS is enabled (browsers will block HTTP requests under HTTPS domains).
  </Accordion>

  <Accordion title="Error: Current group load is saturated, please try again later.">
    This indicates that an upstream channel encountered a 429 error (Too Many Requests).
  </Accordion>
</Accordions>

## 📦 Database and Upgrade Issues

<Accordions>
  <Accordion title="Will my data be lost after upgrading?">
    It varies depending on the database type:

    * **MySQL**: Data will not be lost.
    * **SQLite**: You need to mount a volume according to the deployment command to persist the `one-api.db` database file, otherwise data will be lost after the container restarts.
  </Accordion>

  <Accordion title="Does the database need to be changed before upgrading?">
    Generally, no. The system will automatically adjust during initialization.

    If special handling is required, it will be explained in the update log and corresponding scripts will be provided.
  </Accordion>

  <Accordion title="Error after manually modifying the database: Database consistency has been corrupted, please contact the administrator?">
    This error indicates that invalid channel ID records were detected in the `ability` table. Common reasons:

    * Invalid channels in the `ability` table were not cleaned up synchronously when deleting `channel` table records.
    * Each model supported by a channel needs to have a corresponding record in the `ability` table.
  </Accordion>
</Accordions>

## ❓ Can't find your question?

If your question is not answered here, you are welcome to:

1. Check the [Installation and Deployment Documentation](/en/docs/installation)
2. [Submit an issue on GitHub](/en/docs/support/feedback-issues)
3. Join the [QQ communication group for help](/en/docs/support/community-interaction)


# Feedback



Your feedback is highly valued and crucial for the project's improvement. If you encounter any issues during use, please report them to us via GitHub Issues.

## 📝 How to Submit an Issue

Please visit our GitHub Issues page: [New API Issues](https://github.com/Calcium-Ion/new-api/issues)

<Callout type="info" title="Before Submitting an Issue">
  Before submitting a new issue, we recommend that you:
</Callout>

1. Search to see if a similar issue already exists
2. Ensure you are using the latest version
3. Check if there are relevant answers in the [FAQ document](/en/docs/support/faq)

<img alt="feedback-issues" src={__img0} placeholder="blur" />

## 💡 Issue Feedback Templates

### Format for Reporting Issues

```markdown
**例行检查**

[//]: # '方框内删除已有的空格，填 x 号'

- [ ] 我已确认目前没有类似 issue
- [ ] 我已确认我已升级到最新版本
- [ ] 我已完整查看过项目 README，尤其是常见问题部分
- [ ] 我理解并愿意跟进此 issue，协助测试和提供反馈
- [ ] 我理解并认可上述内容，并理解项目维护者精力有限，**不遵循规则的 issue 可能会被无视或直接关闭**

**问题描述**

**复现步骤**

**预期结果**

**相关截图**
如果没有的话，请删除此节。
```

### Format for Feature Requests

```markdown
**例行检查**

[//]: # '方框内删除已有的空格，填 x 号'

- [ ] 我已确认目前没有类似 issue
- [ ] 我已确认我已升级到最新版本
- [ ] 我已完整查看过项目 README，已确定现有版本无法满足需求
- [ ] 我理解并愿意跟进此 issue，协助测试和提供反馈
- [ ] 我理解并认可上述内容，并理解项目维护者精力有限，**不遵循规则的 issue 可能会被无视或直接关闭**

**功能描述**

**应用场景**
```

<Callout type="warn" title="Important Notes">
  * Please strictly follow the template format when submitting issues - Please
    use a clear title to facilitate searching for other users - Please pay
    attention to and reply to your submitted issues in a timely manner - Issues
    that do not meet the specifications may be closed directly - If the issue is
    resolved, please close it promptly
</Callout>


# Help & Support

import { Card, Cards } from 'fumadocs-ui/components/card';
import { HelpCircle, MessageCircle, Bug, Coffee } from 'lucide-react';

## Overview

Having issues? Need help? We provide multiple support channels to help you solve various problems during use.

## Get Help

<Cards>
  <Card icon={<HelpCircle />} title="FAQ" description="Check answers to frequently asked questions for quick problem resolution." href="/en/docs/support/faq" />

  <Card icon={<MessageCircle />} title="Community" description="Join the community to exchange experiences and tips with other users." href="/en/docs/support/community-interaction" />

  <Card icon={<Bug />} title="Feedback" description="Found a bug or have a feature suggestion? Let us know!" href="/en/docs/support/feedback-issues" />

  <Card icon={<Coffee />} title="Sponsor" description="If New API has been helpful to you, feel free to buy us a coffee." href="/en/docs/support/buy-us-a-coffee" />
</Cards>


# Authentication System Description (Auth)

## Description

Backend management interfaces adopt a multi-level authentication mechanism, commonly: **Public**, **User**, **Admin**, **Root**.

## Authentication Methods (Choose One)

### Session

Obtain Session via the login interface:

* `POST /api/user/login`

### Access Token (Recommended)

Carry in the request header:

```text
Authorization: Bearer {token}
```

Tokens can be generated in "Personal Settings - Security Settings - System Access Tokens".

## Required Request Headers

Some interfaces require carrying a user identification request header:

```text
New-Api-User: {user_id}
```

Where `{user_id}` must match the currently logged-in user.

## Permission Levels

* **Public**: No authentication required
* **User**: Requires login or Access Token
* **Admin**: Requires administrator privileges
* **Root**: Highest privilege


# API Tokens





Here you can view, edit, and add tokens.

## View Tokens

<img alt="View Tokens" src={__img0} placeholder="blur" />

## Add Tokens

<img alt="Add Tokens" src={__img1} placeholder="blur" />


# Channels









Here you can manage NewAPI's upstream Channels.

<img alt="Channels" src={__img0} placeholder="blur" />

## Channel Creation/Editing Page

<img alt="Channel Management 1" src={__img1} placeholder="blur" />

<img alt="Channel Management 2" src={__img2} placeholder="blur" />

<img alt="Channel Management 3" src={__img3} placeholder="blur" />

# Parameter Override Settings Documentation

## Overview

The parameter override system supports two modes: simple override mode (backward compatible) and advanced operation mode. Complex dynamic parameter adjustments can be achieved through flexible conditional judgments and operation types.

## Usage

### Simple Override Mode

Backward compatible, directly specify the fields and values to be overridden, and the system will merge these fields into the original request.

```json
{
  "temperature": 0.8,
  "max_tokens": 2000,
  "model": "gpt-4"
}
```

### Advanced Operation Mode

Define complex parameter operations through the `operations` array, supporting advanced features such as conditional judgments, array operations, string concatenation, and string normalization.

#### Basic Structure

```json
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.8,
      "conditions": [...],
      "logic": "AND"
    }
  ]
}
```

**Field Description (fill as needed):**

* `mode`: Required
* `path`: Applicable to `set` / `delete` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix` / `trim_space` / `to_lower` / `to_upper` / `replace` / `regex_replace`
* `value`: Commonly used in `set` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix`
* `from` / `to`: Applicable to `move` / `copy` / `replace` / `regex_replace`
* `keep_origin`: Used for `set` (skips if value already exists) and for `append` / `prepend` during object merging.

## Operation Modes (mode)

### 1. set - Set Value

Sets the value at the specified path.

```json
{
  "path": "temperature",
  "mode": "set",
  "value": 0.8,
  "keep_origin": false
}
```

**Parameter Description:**

* `keep_origin`: When `true`, if the target path already has a value, setting is skipped.

### 2. delete - Delete Field

Deletes the field at the specified path.

```json
{
  "path": "messages.0",
  "mode": "delete"
}
```

### 3. move - Move Field

Moves the value of one field to another location.

```json
{
  "mode": "move",
  "from": "messages.0.content",
  "to": "system"
}
```

### 4. append - Append Content

Appends new content after existing content.

```json
{
  "path": "messages.0.content",
  "mode": "append",
  "value": "\n\n请用中文回答。"
}
```

**Supported Data Types:**

* **String**: Appends to the end of the original string.
* **Array**: Adds elements to the end of the array (supports adding single elements or arrays).
* **Object**: Merges object properties.

### 5. prepend - Prepend Content

Adds new content before existing content.

```json
{
  "path": "messages.0.content",
  "mode": "prepend",
  "value": "重要提示：请仔细阅读以下内容。\n\n"
}
```

**Supported Data Types:**

* **String**: Prepends to the beginning of the original string.
* **Array**: Adds elements to the beginning of the array (supports adding single elements or arrays).
* **Object**: Merges object properties.

### 6. copy - Copy Field

Copies the value from the path specified by `from` to the path specified by `to` (does not delete the source field).

```json
{
  "mode": "copy",
  "from": "model",
  "to": "original_model"
}
```

**Parameter Requirements:**

* `from` / `to`: Required
* An error will be reported if the source path does not exist.

### 7. trim\_prefix - Trim Prefix

Removes the specified prefix from a string field (if it doesn't match, it remains unchanged).

```json
{
  "path": "model",
  "mode": "trim_prefix",
  "value": "openai/"
}
```

**Parameter Requirements:**

* `value`: Required

### 8. trim\_suffix - Trim Suffix

Removes the specified suffix from a string field (if it doesn't match, it remains unchanged).

```json
{
  "path": "model",
  "mode": "trim_suffix",
  "value": "-latest"
}
```

**Parameter Requirements:**

* `value`: Required

### 9. ensure\_prefix - Ensure Prefix

Ensures a string field starts with the specified prefix (if it already exists, it remains unchanged).

```json
{
  "path": "model",
  "mode": "ensure_prefix",
  "value": "openai/"
}
```

**Parameter Requirements:**

* `value`: Required and cannot be an empty string.

### 10. ensure\_suffix - Ensure Suffix

Ensures a string field ends with the specified suffix (if it already exists, it remains unchanged).

```json
{
  "path": "model",
  "mode": "ensure_suffix",
  "value": "-latest"
}
```

**Parameter Requirements:**

* `value`: Required and cannot be an empty string.

### 11. trim\_space - Trim Leading/Trailing Whitespace

Performs `TrimSpace` on a string field (spaces, newlines, tabs, etc., will be removed).

```json
{
  "path": "model",
  "mode": "trim_space"
}
```

### 12. to\_lower - Convert to Lowercase

Converts a string field to lowercase.

```json
{
  "path": "model",
  "mode": "to_lower"
}
```

### 13. to\_upper - Convert to Uppercase

Converts a string field to uppercase.

```json
{
  "path": "model",
  "mode": "to_upper"
}
```

### 14. replace - String Replace

Performs substring replacement on a string field.

```json
{
  "path": "model",
  "mode": "replace",
  "from": "openai/",
  "to": ""
}
```

**Parameter Requirements:**

* `from`: Required and cannot be an empty string.
* `to`: Optional, equivalent to an empty string if omitted.

### 15. regex\_replace - Regex Replace

Performs regular expression matching and replacement on a string field.

```json
{
  "path": "model",
  "mode": "regex_replace",
  "from": "^gpt-",
  "to": "openai/gpt-"
}
```

**Parameter Requirements:**

* `from`: Required (regular expression, Go regexp syntax).
* `to`: Optional, equivalent to an empty string if omitted.

## Conditional Judgment

Set the conditions for operation execution using the `conditions` array; the corresponding operation will only be executed when the conditions are met.

### Condition Structure

```json
{
  "conditions": [
    {
      "path": "model",
      "mode": "contains",
      "value": "gpt-4",
      "invert": false,
      "pass_missing_key": false
    }
  ],
  "logic": "AND"
}
```

### Condition Matching Modes

* `full`: Exact match (default)

* `prefix`: Prefix match

* `suffix`: Suffix match

* `contains`: Contains match

* `gt`: Greater than (numeric types only)

* `gte`: Greater than or equal to (numeric types only)

* `lt`: Less than (numeric types only)

* `lte`: Less than or equal to (numeric types only)

* Note:

- Numeric comparisons can only be used for numeric types.
- String operations (prefix, suffix, contains) will convert values to strings for comparison.

### Condition Parameter Description

* `invert`: Invert function, `true` means negate the result.
* `pass_missing_key`: Behavior when the specified path does not exist.
  * `true`: Condition passes if path does not exist.
  * `false`: Condition does not pass if path does not exist (default).

### Logical Relationship (logic)

* `AND`: All conditions must be met.
* `OR`: Any condition met is sufficient (default).

## Path Syntax

Use JSON path syntax to access nested fields:

* `temperature` - Root-level field
* `messages.0.content` - The content field of the first element in the array.
* `messages.-1.content` - The content field of the last element in the array.
* `metadata.user.name` - Nested object field.

Additionally, `path` supports the following built-in variables (no need to explicitly exist in the request body), which can be directly used for conditional judgments:

| Variable                   | Meaning                         | Typical Use                                                            |
| -------------------------- | ------------------------------- | ---------------------------------------------------------------------- |
| `model` / `upstream_model` | Target model after redirection  | Conditional matching based on the actual upstream model called         |
| `original_model`           | Target model before redirection | Conditional matching based on the original model requested by the user |

## Practical Examples

### 1. Dynamically Adjust Model Parameters

Dynamically adjust the temperature parameter based on message content:

```json
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.3,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "代码"
        }
      ]
    },
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.9,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "创意"
        }
      ]
    }
  ]
}
```

### 2. Add System Prompt

Add a system message at the beginning of the message array:

```json
{
  "operations": [
    {
      "path": "messages",
      "mode": "prepend",
      "value": [
        {
          "role": "system",
          "content": "你是一个专业的AI助手，请始终保持礼貌和专业。"
        }
      ]
    }
  ]
}
```

### 3. Adjust Parameters Based on Model Type

Set different max\_tokens based on different models:

```json
{
  "operations": [
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 4000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-4"
        }
      ]
    },
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 2000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-3.5"
        }
      ]
    }
  ]
}
```

### 4. Multiple Condition Combination (AND Logic)

Execute the operation only when multiple conditions are met simultaneously:

```json
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": false,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "claude"
        },
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "长文"
        }
      ],
      "logic": "AND"
    }
  ]
}
```

### 5. Numeric Comparison Conditions

Perform conditional judgment based on numerical size:

```json
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.1,
      "conditions": [
        {
          "path": "max_tokens",
          "mode": "gt",
          "value": 1000
        }
      ]
    }
  ]
}
```

### 6. Invert Condition

Use `invert` to implement inverse logic:

```json
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": true,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "gpt-3.5",
          "invert": true
        }
      ]
    }
  ]
}
```

### 7. Handle Missing Fields

Use `pass_missing_key` to handle potentially missing fields:

```json
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.7,
      "conditions": [
        {
          "path": "custom_field",
          "mode": "full",
          "value": "special",
          "pass_missing_key": true
        }
      ]
    }
  ]
}
```

### 8. String Concatenation Example

Append instructions after the user message:

```json
{
  "operations": [
    {
      "path": "messages.-1.content",
      "mode": "append",
      "value": "\n\n请详细解释你的思考过程。"
    }
  ]
}
```

## Important Notes

**Execution Order**: Operations are executed sequentially according to their order in the `operations` array; earlier operations may affect subsequent operations.


# Chat







New API provides quick access to several AI chat applications, making them convenient for testing or use.

## Import Configuration

You can import configurations into chat applications with one click on the Console -> API Tokens page.

<img alt="One-click Import" src={__img0} placeholder="blur" />

## ChatGPT Next Web

Deployment is currently paused.

## Lobe Chat

<Callout type="info">
  Lobe Chat is an open-source multimodal conversational application that
  supports various large language models (LLMs) and plugin extensions. It not
  only enables text conversations but also supports multimodal interactions such
  as images and audio, making it suitable for various scenarios like personal
  assistants, knowledge Q\&A, and content creation. Lobe Chat features a clean
  and intuitive interface, supports multi-device synchronization, and allows
  users to customize models and plugins as needed to flexibly extend
  conversational capabilities. Both developers and general users can easily get
  started and enjoy the efficient experience brought by intelligent
  conversations.
</Callout>

<Callout type="warn">
  Lobe Chat currently does not support one-click import of configurations from
  New API; manual entry is required.
</Callout>

Configuration Entry
<img alt="lobechat-1" src={__img1} placeholder="blur" />
<img alt="lobechat-2" src={__img2} placeholder="blur" />

## AI as Workspace

<Callout type="info">
  AI as Workspace is an innovative approach that integrates artificial
  intelligence capabilities into the workspace. By deeply combining AI
  assistants with daily office tasks, collaboration, knowledge management, and
  other scenarios, users can process information more efficiently, automate
  repetitive tasks, and receive intelligent suggestions, thereby enhancing
  overall work efficiency and experience.
</Callout>

<Callout type="info">
  Supports one-click configuration import from New API
</Callout>

## AMA 问天

<Callout type="info">
  AMA 问天 is an intelligent Q\&A assistant provided by NewAPI, supporting
  multi-turn conversations and complex problem-solving. Users can interact with
  AMA 问天 using natural language to obtain knowledge, technical support, or
  business consultations, enhancing communication efficiency and experience.
</Callout>

<Callout type="warn">
  The AMA 问天 app needs to be installed first.
</Callout>

## OpenCat

<Callout type="info">
  OpenCat is an open-source, multi-platform AI chat client that supports
  integration with various large language models. Users can engage in natural
  language conversations with AI through a clean interface, suitable for daily
  communication, knowledge Q\&A, and content creation across multiple scenarios.
  OpenCat supports multi-device synchronization and flexible configuration,
  making it suitable for both individuals and teams.
</Callout>

<Callout type="warn">
  The OpenCat app needs to be installed first.
</Callout>


# Dashboard



Here you can view NewAPI's overall statistics.

<img alt="Dashboard" src={__img0} placeholder="blur" />


# Drawing Log

```

Here you can view Midjourney task records

![Drawing Log](/assets/guide/drawing-log.png)
```


# Playground



Here you can quickly engage in AI chat, facilitating testing and use.

<img alt="Playground" src={__img0} placeholder="blur" />


# Personal Settings















Here you can view account information, manage account bindings, perform security settings, and more.

## View Available Models

Here you can view the models available to your current account. Click on a model name to copy it.

<img alt="可用模型" src={__img0} placeholder="blur" />

## Account Binding

Here you can perform account binding operations.

<img alt="账户绑定" src={__img1} placeholder="blur" />

## Security Settings

Here you can change your password, reset your API key, and perform other related operations.

<img alt="安全设置" src={__img2} placeholder="blur" />

## Other Settings

### Notification Settings

Here you can configure how you receive notifications. Currently, email and Webhook are supported.

<img alt="邮件通知" src={__img3} placeholder="blur" />

<img alt="Webhook" src={__img4} placeholder="blur" />

### Price Settings

Here you can set whether to accept models without a configured price.

<img alt="价格设置" src={__img5} placeholder="blur" />

### IP Logging

Here you can choose to enable IP logging. If enabled, IP addresses will be displayed in the logs.

<img alt="IP设置" src={__img6} placeholder="blur" />


# Redemption Code





Here you can manage NewAPI's redemption codes.

<img alt="Redemption Code 1" src={__img0} placeholder="blur" />

<img alt="Redemption Code 2" src={__img1} placeholder="blur" />


# Task Logs



Suno task logs can be viewed here.

<img alt="Task Logs" src={__img0} placeholder="blur" />


# Usage Logs



Here you can view the logs of API calls, and see the Token Group, model, and cost used. Regular users can view their own logs, while administrators can view other users' logs.

<img alt="Usage Logs" src={__img0} placeholder="blur" />


# User Management



Here you can manage registered users of NewAPI.

<img alt="User Management" src={__img0} placeholder="blur" />


# Wallet



Here you can top up, redeem redemption codes, and view AFF invitation links. Payment methods are configured by the administrator in System Settings -> Payment Settings.

<img alt="Wallet" src={__img0} placeholder="blur" />


# Changelog

import { Callout } from 'fumadocs-ui/components/callout';

<Callout type="warn" title="Version Log Information · Data updated at 2026-4-18 15:04:59">
  To view all historical versions, please visit the [GitHub Releases page](https://github.com/QuantumNous/new-api/releases). This page automatically fetches the latest update information from that page.
</Callout>

## v0.12.14

<Callout type="info" title="Latest Release · Published at 2026-04-18 00:41:21 (UTC+8)">
  ### Improvements

  * Improved user-visible management and top-up logs with a cleaner display, preserved row expansion, and clearer handling of legacy records.

  ***

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.13...v0.12.14](https://github.com/QuantumNous/new-api/compare/v0.12.13...v0.12.14)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/checksums-linux.txt">checksums-linux.txt</a>

       (172 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/checksums-macos.txt">checksums-macos.txt</a>

       (89 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/checksums-windows.txt">checksums-windows.txt</a>

       (87 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/New-API-App.0.12.14.exe">New-API-App.0.12.14.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/New-API-App.Setup.0.12.14.exe">New-API-App.Setup.0.12.14.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/new-api-arm64-v0.12.14">new-api-arm64-v0.12.14</a>

       (63.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/new-api-macos-v0.12.14">new-api-macos-v0.12.14</a>

       (81.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/new-api-v0.12.14">new-api-v0.12.14</a>

       (66.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.14/new-api-v0.12.14.exe">new-api-v0.12.14.exe</a>

       (67.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.14.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.14.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.13

<Callout type="note" title="Release · Published at 2026-04-18 00:04:31 (UTC+8)">
  This release improves admin workflows for top-ups and makes account status changes apply more consistently.

  #### Bug Fixes

  * Disabling a user now takes effect immediately instead of being delayed by stale cached account data.

  #### Improvements

  * Top-up logs now include additional admin-only audit details to make review and troubleshooting easier.

  #### Breaking Changes

  * Top-up searches are now limited to a maximum 30-day date range to keep queries responsive and reliable.

  ***

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.12...v0.12.13](https://github.com/QuantumNous/new-api/compare/v0.12.12...v0.12.13)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/checksums-linux.txt">checksums-linux.txt</a>

       (172 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/checksums-macos.txt">checksums-macos.txt</a>

       (89 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/checksums-windows.txt">checksums-windows.txt</a>

       (87 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/New-API-App.0.12.13.exe">New-API-App.0.12.13.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/New-API-App.Setup.0.12.13.exe">New-API-App.Setup.0.12.13.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/new-api-arm64-v0.12.13">new-api-arm64-v0.12.13</a>

       (63.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/new-api-macos-v0.12.13">new-api-macos-v0.12.13</a>

       (81.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/new-api-v0.12.13">new-api-v0.12.13</a>

       (66.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.13/new-api-v0.12.13.exe">new-api-v0.12.13.exe</a>

       (67.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.13.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.13.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.12

<Callout type="note" title="Release · Published at 2026-04-17 14:05:08 (UTC+8)">
  This release adds support for Claude Opus 4.7, expanding the set of available models in the API.

  ### New Features

  * Added support for the Claude Opus 4.7 model, making it available through the API alongside existing model options (#4293).

  ***

  ### What's Changed

  * feat: support claude-opus-4-7 by @prnake in [https://github.com/QuantumNous/new-api/pull/4293](https://github.com/QuantumNous/new-api/pull/4293)
  * chore(deps): bump github.com/jackc/pgx/v5 from 5.7.1 to 5.9.0 by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/4294](https://github.com/QuantumNous/new-api/pull/4294)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.11...v0.12.12](https://github.com/QuantumNous/new-api/compare/v0.12.11...v0.12.12)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/checksums-linux.txt">checksums-linux.txt</a>

       (172 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/checksums-macos.txt">checksums-macos.txt</a>

       (89 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/checksums-windows.txt">checksums-windows.txt</a>

       (87 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/New-API-App.0.12.12.exe">New-API-App.0.12.12.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/New-API-App.Setup.0.12.12.exe">New-API-App.Setup.0.12.12.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/new-api-arm64-v0.12.12">new-api-arm64-v0.12.12</a>

       (63.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/new-api-macos-v0.12.12">new-api-macos-v0.12.12</a>

       (81.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/new-api-v0.12.12">new-api-v0.12.12</a>

       (65.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.12/new-api-v0.12.12.exe">new-api-v0.12.12.exe</a>

       (67.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.12.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.12.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.11

<Callout type="note" title="Release · Published at 2026-04-16 20:13:49 (UTC+8)">
  #### New Features

  * Added payment method tracking and validation for top-ups.

  #### Bug Fixes

  * Improved handling of empty string content during OpenAI to Claude message conversion.

  ***

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.10...v0.12.11](https://github.com/QuantumNous/new-api/compare/v0.12.10...v0.12.11)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/checksums-linux.txt">checksums-linux.txt</a>

       (172 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/checksums-macos.txt">checksums-macos.txt</a>

       (89 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/checksums-windows.txt">checksums-windows.txt</a>

       (87 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/New-API-App.0.12.11.exe">New-API-App.0.12.11.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/New-API-App.Setup.0.12.11.exe">New-API-App.Setup.0.12.11.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/new-api-arm64-v0.12.11">new-api-arm64-v0.12.11</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/new-api-macos-v0.12.11">new-api-macos-v0.12.11</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/new-api-v0.12.11">new-api-v0.12.11</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.11/new-api-v0.12.11.exe">new-api-v0.12.11.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.11.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.11.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.10

<Callout type="note" title="Release · Published at 2026-04-15 21:02:01 (UTC+8)">
  ### New Features

  * Added passthrough support for Claude `cache_control` and `speed` options, giving you more control over request behavior when using Claude models (#4247).

  ### Bug Fixes

  * Fixed OpenAI Responses API compatibility issues when `instructions` contain structured content instead of plain text (#4260).

  ### Improvements

  * Improved Stripe payment processing to better handle asynchronous webhook events, making delayed payment confirmations more reliable.
  * Quota adjustment logs now record the acting admin username, making administrative audit trails easier to follow (#4216).

  ***

  ### What's Changed

  * fix: use json.RawMessage for Instructions field in OpenAIResponsesResponse by @linbin524 in [https://github.com/QuantumNous/new-api/pull/4260](https://github.com/QuantumNous/new-api/pull/4260)
  * fix(channel): 修复多密钥管理弹窗索引显示，将索引值调整为从1开始 by @wans10 in [https://github.com/QuantumNous/new-api/pull/4231](https://github.com/QuantumNous/new-api/pull/4231)
  * feat(claude): add cache\_control and speed passthrough controls by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4247](https://github.com/QuantumNous/new-api/pull/4247)
  * feat: include admin username in quota adjustment logs by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/4216](https://github.com/QuantumNous/new-api/pull/4216)

  ### New Contributors

  * @linbin524 made their first contribution in [https://github.com/QuantumNous/new-api/pull/4260](https://github.com/QuantumNous/new-api/pull/4260)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.9...v0.12.10](https://github.com/QuantumNous/new-api/compare/v0.12.9...v0.12.10)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/checksums-linux.txt">checksums-linux.txt</a>

       (172 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/checksums-macos.txt">checksums-macos.txt</a>

       (89 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/checksums-windows.txt">checksums-windows.txt</a>

       (87 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/New-API-App.0.12.10.exe">New-API-App.0.12.10.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/New-API-App.Setup.0.12.10.exe">New-API-App.Setup.0.12.10.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/new-api-arm64-v0.12.10">new-api-arm64-v0.12.10</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/new-api-macos-v0.12.10">new-api-macos-v0.12.10</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/new-api-v0.12.10">new-api-v0.12.10</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.10/new-api-v0.12.10.exe">new-api-v0.12.10.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.10.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.10.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.9

<Callout type="note" title="Release · Published at 2026-04-13 15:28:47 (UTC+8)">
  ### New Features

  * Subscription cards now show the next quota reset time, making it easier to see when usage limits will refresh (#4181).

  ### Bug Fixes

  * Claude requests are now more reliable by avoiding incompatible Top P settings when needed.
  * Azure channels now correctly support the `/v1/responses/compact` route (#4149).
  * Editing values in GroupTable no longer forces the cursor to jump to the end on each keystroke (#4208).

  ### Improvements

  * Dashboard charts have been refined to present rankings and chart sizing more clearly for easier monitoring.

  ***

  ### What's Changed

  * fix(GroupTable): prevent Input cursor jumping to end on keystroke by @Xbang0222 in [https://github.com/QuantumNous/new-api/pull/4208](https://github.com/QuantumNous/new-api/pull/4208)
  * feat: display next quota reset time in subscription card by @ShengM97 in [https://github.com/QuantumNous/new-api/pull/4181](https://github.com/QuantumNous/new-api/pull/4181)
  * fix: add Azure channel support for /v1/responses/compact URL routing by @woan1136 in [https://github.com/QuantumNous/new-api/pull/4149](https://github.com/QuantumNous/new-api/pull/4149)

  ### New Contributors

  * @Xbang0222 made their first contribution in [https://github.com/QuantumNous/new-api/pull/4208](https://github.com/QuantumNous/new-api/pull/4208)
  * @ShengM97 made their first contribution in [https://github.com/QuantumNous/new-api/pull/4181](https://github.com/QuantumNous/new-api/pull/4181)
  * @woan1136 made their first contribution in [https://github.com/QuantumNous/new-api/pull/4149](https://github.com/QuantumNous/new-api/pull/4149)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.8...v0.12.9](https://github.com/QuantumNous/new-api/compare/v0.12.8...v0.12.9)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/New-API-App.0.12.9.exe">New-API-App.0.12.9.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/New-API-App.Setup.0.12.9.exe">New-API-App.Setup.0.12.9.exe</a>

       (106.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/new-api-arm64-v0.12.9">new-api-arm64-v0.12.9</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/new-api-macos-v0.12.9">new-api-macos-v0.12.9</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/new-api-v0.12.9">new-api-v0.12.9</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.9/new-api-v0.12.9.exe">new-api-v0.12.9.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.9.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.9.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.8

<Callout type="note" title="Release · Published at 2026-04-12 23:58:29 (UTC+8)">
  #### Bug Fixes

  * Correctly report the stream status in error logs instead of defaulting to false (#4195).

  ***

  ### What's Changed

  * fix: isStream status in error logs instead of hardcoded false by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/4195](https://github.com/QuantumNous/new-api/pull/4195)
  * chore(deps): bump axios from 1.13.5 to 1.15.0 in /web by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/4201](https://github.com/QuantumNous/new-api/pull/4201)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.7...v0.12.8](https://github.com/QuantumNous/new-api/compare/v0.12.7...v0.12.8)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/New-API-App.0.12.8.exe">New-API-App.0.12.8.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/New-API-App.Setup.0.12.8.exe">New-API-App.Setup.0.12.8.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/new-api-arm64-v0.12.8">new-api-arm64-v0.12.8</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/new-api-macos-v0.12.8">new-api-macos-v0.12.8</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/new-api-v0.12.8">new-api-v0.12.8</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.8/new-api-v0.12.8.exe">new-api-v0.12.8.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.8.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.8.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.7

<Callout type="note" title="Release · Published at 2026-04-12 17:47:25 (UTC+8)">
  ### Improvements

  * Quota management now uses an amount-first input flow and applies changes atomically, making balance adjustments simpler and more reliable.
  * Model pricing errors now use cleaner, role-aware messages so it is easier to understand and resolve failed pricing actions.

  ***

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.6...v0.12.7](https://github.com/QuantumNous/new-api/compare/v0.12.6...v0.12.7)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/New-API-App.0.12.7.exe">New-API-App.0.12.7.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/New-API-App.Setup.0.12.7.exe">New-API-App.Setup.0.12.7.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/new-api-arm64-v0.12.7">new-api-arm64-v0.12.7</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/new-api-macos-v0.12.7">new-api-macos-v0.12.7</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/new-api-v0.12.7">new-api-v0.12.7</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.7/new-api-v0.12.7.exe">new-api-v0.12.7.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.7.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.7.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.6

<Callout type="note" title="Release · Published at 2026-04-09 14:44:42 (UTC+8)">
  #### New Features

  * Fill in custom fields for vllm-omini (#4154)

  #### Bug Fixes

  * Accept string usage values in Alibaba task polling (#4155)
  * Use correct endpoint for coding plan image generation in Zhipu 4V (#4146)
  * Prefer explicit pricing for compact models (#4156)
  * Fix document rendering (#4153)

  #### Improvements

  * Refine PR template and add PR submission checks (#4076)

  ***

  ### What's Changed

  * fix(zhipu\_4v): use correct endpoint for coding plan image generation by @NyaMisty in [https://github.com/QuantumNous/new-api/pull/4146](https://github.com/QuantumNous/new-api/pull/4146)
  * fix: prefer explicit pricing for compact models by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4156](https://github.com/QuantumNous/new-api/pull/4156)
  * fix(ali): accept string usage values in task polling by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4155](https://github.com/QuantumNous/new-api/pull/4155)
  * feat: fill in some custom fields for vllm-omini by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4154](https://github.com/QuantumNous/new-api/pull/4154)
  * fix: document render by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4153](https://github.com/QuantumNous/new-api/pull/4153)
  * ci: refine PR template and add PR submission checks by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4076](https://github.com/QuantumNous/new-api/pull/4076)

  ### New Contributors

  * @NyaMisty made their first contribution in [https://github.com/QuantumNous/new-api/pull/4146](https://github.com/QuantumNous/new-api/pull/4146)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.5...v0.12.6](https://github.com/QuantumNous/new-api/compare/v0.12.5...v0.12.6)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/New-API-App.0.12.6.exe">New-API-App.0.12.6.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/New-API-App.Setup.0.12.6.exe">New-API-App.Setup.0.12.6.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/new-api-arm64-v0.12.6">new-api-arm64-v0.12.6</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/new-api-macos-v0.12.6">new-api-macos-v0.12.6</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/new-api-v0.12.6">new-api-v0.12.6</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.6/new-api-v0.12.6.exe">new-api-v0.12.6.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.6.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.6.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## nightly-20260409-4d2993e

<Callout type="note" title="Release · Published at 2026-04-09 17:14:49 (UTC+8)">
  #### Highlights / 重点更新

  This release introduces comprehensive support for **tiered billing (阶梯计费)**. It allows for flexible pricing expressions, detailed tool call quota calculations, and channel test support for tiered models.
  本次发布重点增加了对**阶梯计费**的全面支持，支持灵活的计费表达式解析、自定义工具调用额度计算，并完善了UI配置项和渠道测试支持。

  **Docker image:** `calciumion/new-api:nightly`
  **Docker 镜像:** `calciumion/new-api:nightly`

  <img width="500" alt="" src="https://github.com/user-attachments/assets/893d5789-64b3-414d-8e71-cc178b724ac6" />

  #### New Features

  * Added comprehensive support for tiered billing, including flexible expression evaluation, tool pricing settings UI, and channel test support (#4145).
  * Added custom fields support for vllm-omini models (#4154).

  #### Bug Fixes

  * Fixed an issue in Alibaba Cloud task polling to correctly accept string usage values (#4155).
  * Fixed the endpoint for Zhipu 4v coding plan image generation (#4146).
  * Fixed pricing calculation to prefer explicit pricing for compact models (#4156).

  #### Improvements

  * Improved UI layout consistency by replacing card components with divs.
  * Added nightly branch trigger to Docker image CI workflows.
  * Refined PR templates and added PR submission checks (#4076).

  ***

  ### What's Changed

  * fix(zhipu\_4v): use correct endpoint for coding plan image generation by @NyaMisty in [https://github.com/QuantumNous/new-api/pull/4146](https://github.com/QuantumNous/new-api/pull/4146)
  * fix: prefer explicit pricing for compact models by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4156](https://github.com/QuantumNous/new-api/pull/4156)
  * fix(ali): accept string usage values in task polling by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4155](https://github.com/QuantumNous/new-api/pull/4155)
  * feat: fill in some custom fields for vllm-omini by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4154](https://github.com/QuantumNous/new-api/pull/4154)
  * fix: document render by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4153](https://github.com/QuantumNous/new-api/pull/4153)
  * ci: refine PR template and add PR submission checks by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4076](https://github.com/QuantumNous/new-api/pull/4076)
  * fix(channel-test): support tiered billing model tests by @yyhhyyyyyy in [https://github.com/QuantumNous/new-api/pull/4145](https://github.com/QuantumNous/new-api/pull/4145)

  ### New Contributors

  * @NyaMisty made their first contribution in [https://github.com/QuantumNous/new-api/pull/4146](https://github.com/QuantumNous/new-api/pull/4146)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.5...nightly-20260409](https://github.com/QuantumNous/new-api/compare/v0.12.5...nightly-20260409)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/nightly-20260409.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/nightly-20260409.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.5

<Callout type="note" title="Release · Published at 2026-04-08 17:13:32 (UTC+8)">
  #### New Features

  * Add support for Minimax image generation relay (#4103).

  #### Improvements

  * Redesign group ratio rules with a collapsible layout for better usability.
  * Enhance dashboard chart axes and sorting logic.
  * Add a convenient copy button next to the API link in the dashboard info panel.

  #### Bug Fixes

  * Resolve email delivery issues for Outlook and similar providers (#4112).

  <img width="2848" height="966" alt="" src="https://github.com/user-attachments/assets/8cfdd943-3b2a-4e2a-9f7f-301468d64ce2" />

  ***

  ### What's Changed

  * feat: 支持强制使用 AUTH LOGIN 以解决 outlook 等邮箱的发件问题 by @Hoshino-Yumetsuki in [https://github.com/QuantumNous/new-api/pull/4112](https://github.com/QuantumNous/new-api/pull/4112)
  * feat(minimax): add image generation relay support by @forsakenyang in [https://github.com/QuantumNous/new-api/pull/4103](https://github.com/QuantumNous/new-api/pull/4103)

  ### New Contributors

  * @Hoshino-Yumetsuki made their first contribution in [https://github.com/QuantumNous/new-api/pull/4112](https://github.com/QuantumNous/new-api/pull/4112)
  * @forsakenyang made their first contribution in [https://github.com/QuantumNous/new-api/pull/4103](https://github.com/QuantumNous/new-api/pull/4103)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.4...v0.12.5](https://github.com/QuantumNous/new-api/compare/v0.12.4...v0.12.5)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/new-api-arm64-v0.12.5">new-api-arm64-v0.12.5</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/new-api-macos-v0.12.5">new-api-macos-v0.12.5</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/new-api-v0.12.5">new-api-v0.12.5</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.5/new-api-v0.12.5.exe">new-api-v0.12.5.exe</a>

       (67.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.5.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.5.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.4

<Callout type="note" title="Release · Published at 2026-04-08 15:49:44 (UTC+8)">
  ### New Features

  * Added an `IncludeModelName` option to channel affinity rules for per-model affinity tracking (#3488)
  * Added an ErrorBoundary component to the web UI to prevent full-page crashes (#3350)
  * Added support for `Duration` in `TaskSubmitReq` (#4068)
  * Added admin user analytics to the dashboard

  ### Bug Fixes

  * Fixed pricing filtering based on usable groups (#4123)
  * Fixed an issue where Claude streaming interruptions incorrectly overwrote usage data instead of preserving cache billing fields (#4128)
  * Fixed an issue where the "do not retry after failure" configuration was incorrectly overwritten in memory (#4142)

  ### Improvements

  * Added support for enabling error logging via environment variables (#4131)
  * Wrapped scope tag labels with `t()` for better i18n support
  * Fixed chart labels on the dashboard

  ***

  ### What's Changed

  * feat: add IncludeModelName option to channel affinity rules by @clansty in [https://github.com/QuantumNous/new-api/pull/3488](https://github.com/QuantumNous/new-api/pull/3488)
  * feat: add ErrorBoundary to prevent full-page crashes by @goodmorning10 in [https://github.com/QuantumNous/new-api/pull/3350](https://github.com/QuantumNous/new-api/pull/3350)
  * fix: Claude 流式断流时不再整份覆盖 usage，保留 cache 计费字段 by @zuiho-kai in [https://github.com/QuantumNous/new-api/pull/4128](https://github.com/QuantumNous/new-api/pull/4128)
  * fix(pricing): add filtering for pricing based on usable groups by @bbbugg in [https://github.com/QuantumNous/new-api/pull/4123](https://github.com/QuantumNous/new-api/pull/4123)
  * chore(deps): bump github.com/aws/aws-sdk-go-v2/service/bedrockruntime from 1.50.0 to 1.50.4 by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/4136](https://github.com/QuantumNous/new-api/pull/4136)
  * add 添加 启用错误日志记录到env配置中 by @binorxin in [https://github.com/QuantumNous/new-api/pull/4131](https://github.com/QuantumNous/new-api/pull/4131)
  * Seedance support duration by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/4068](https://github.com/QuantumNous/new-api/pull/4068)
  * fix: 修复 失败后不重试 配置项写到内存被覆盖 by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4142](https://github.com/QuantumNous/new-api/pull/4142)

  ### New Contributors

  * @clansty made their first contribution in [https://github.com/QuantumNous/new-api/pull/3488](https://github.com/QuantumNous/new-api/pull/3488)
  * @goodmorning10 made their first contribution in [https://github.com/QuantumNous/new-api/pull/3350](https://github.com/QuantumNous/new-api/pull/3350)
  * @zuiho-kai made their first contribution in [https://github.com/QuantumNous/new-api/pull/4128](https://github.com/QuantumNous/new-api/pull/4128)
  * @bbbugg made their first contribution in [https://github.com/QuantumNous/new-api/pull/4123](https://github.com/QuantumNous/new-api/pull/4123)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.3...v0.12.4](https://github.com/QuantumNous/new-api/compare/v0.12.3...v0.12.4)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/New-API-App.0.12.4.exe">New-API-App.0.12.4.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/New-API-App.Setup.0.12.4.exe">New-API-App.Setup.0.12.4.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/new-api-arm64-v0.12.4">new-api-arm64-v0.12.4</a>

       (63.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/new-api-macos-v0.12.4">new-api-macos-v0.12.4</a>

       (81.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/new-api-v0.12.4">new-api-v0.12.4</a>

       (65.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.4/new-api-v0.12.4.exe">new-api-v0.12.4.exe</a>

       (67.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.4.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.4.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.3

<Callout type="note" title="Release · Published at 2026-04-08 01:04:04 (UTC+8)">
  This is a small polish release focused on making configuration easier to navigate by simplifying the settings layout and consolidating model pricing controls.

  ### Improvements

  * Refined the settings interface with a unified model pricing view and a cleaner tab structure to make configuration easier to navigate.

  ***

  ### What's Changed

  * feat(token): add batch API for fetching token keys by @RedwindA in [https://github.com/QuantumNous/new-api/pull/4114](https://github.com/QuantumNous/new-api/pull/4114)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.2...v0.12.3](https://github.com/QuantumNous/new-api/compare/v0.12.2...v0.12.3)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/New-API-App.0.12.3.exe">New-API-App.0.12.3.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/New-API-App.Setup.0.12.3.exe">New-API-App.Setup.0.12.3.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/new-api-arm64-v0.12.3">new-api-arm64-v0.12.3</a>

       (63.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/new-api-macos-v0.12.3">new-api-macos-v0.12.3</a>

       (81.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/new-api-v0.12.3">new-api-v0.12.3</a>

       (65.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.3/new-api-v0.12.3.exe">new-api-v0.12.3.exe</a>

       (67.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.3.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.3.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.2

<Callout type="note" title="Release · Published at 2026-04-06 18:10:52 (UTC+8)">
  #### New Features

  * Add support for PDF conversion between OpenAI and Claude APIs.
  * Support differential billing for Seedance 2.0 based on video vs. no-video input.
  * Enhance max\_tokens handling and input sanitization in the playground (#4106).
  * Enhance stream status display with error tooltips in usage logs.

  #### Bug Fixes

  * Fix usage calculation issues when converting between Claude and OpenAI APIs by emitting `message_delta` for the final stream chunk (#4090).
  * Fix Gemini stream detection by checking the `:streamGenerateContent` URL path (#4087).
  * Fix Claude request requirements by properly setting TopP to nil.

  #### Improvements

  * Unify file source creation and enhance caching mechanisms.

  ***

  ### What's Changed

  * fix(gemini): detect streaming from URL path :streamGenerateContent by @D26FORWARD in [https://github.com/QuantumNous/new-api/pull/4087](https://github.com/QuantumNous/new-api/pull/4087)
  * fix: emit claude message\_delta for usage-only final stream chunk by @seefs001 in [https://github.com/QuantumNous/new-api/pull/4090](https://github.com/QuantumNous/new-api/pull/4090)
  * chore(deps-dev): bump electron from 35.7.5 to 39.8.5 in /electron by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/4080](https://github.com/QuantumNous/new-api/pull/4080)
  * chore(deps-dev): bump @xmldom/xmldom from 0.8.11 to 0.8.12 in /electron by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/3523](https://github.com/QuantumNous/new-api/pull/3523)
  * chore(deps-dev): bump lodash from 4.17.23 to 4.18.1 in /electron by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/4097](https://github.com/QuantumNous/new-api/pull/4097)
  * feat(playground): enhance max\_tokens handling and input sanitization by @HynoR in [https://github.com/QuantumNous/new-api/pull/4106](https://github.com/QuantumNous/new-api/pull/4106)

  ### New Contributors

  * @D26FORWARD made their first contribution in [https://github.com/QuantumNous/new-api/pull/4087](https://github.com/QuantumNous/new-api/pull/4087)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.1...v0.12.2](https://github.com/QuantumNous/new-api/compare/v0.12.1...v0.12.2)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/New-API-App.0.12.2.exe">New-API-App.0.12.2.exe</a>

       (106.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/New-API-App.Setup.0.12.2.exe">New-API-App.Setup.0.12.2.exe</a>

       (106.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/new-api-arm64-v0.12.2">new-api-arm64-v0.12.2</a>

       (63.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/new-api-macos-v0.12.2">new-api-macos-v0.12.2</a>

       (81.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/new-api-v0.12.2">new-api-v0.12.2</a>

       (65.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.2/new-api-v0.12.2.exe">new-api-v0.12.2.exe</a>

       (67.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.2.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.2.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.1

<Callout type="note" title="Release · Published at 2026-04-02 22:01:41 (UTC+8)">
  This release adds Seedance 2.0 video support and broadens media compatibility across providers. It also makes failures easier to understand with clearer Seedance and performance-related error messages.

  ### New Features

  * Added Seedance 2.0 video generation API support with duration control in seconds, clearer failure reporting, and better prompt handling for single-text requests (#4042).
  * Added HEIC/HEIF image support, including Gemini channel compatibility and more reliable handling of HEIF images (#4049).
  * Added basic inline file support for Claude relay so compatible requests can include media directly (#3505).

  ### Improvements

  * Improved performance-related error messages to make request failures easier to understand.

  ***

  ### What's Changed

  * fix: add basic inline file support for Claude relay by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3505](https://github.com/QuantumNous/new-api/pull/3505)
  * 新增seedance2.0视频接口支持 by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/4042](https://github.com/QuantumNous/new-api/pull/4042)
  * feat: add HEIC/HEIF image format support for Gemini channel by @RedwindA in [https://github.com/QuantumNous/new-api/pull/4049](https://github.com/QuantumNous/new-api/pull/4049)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.0...v0.12.1](https://github.com/QuantumNous/new-api/compare/v0.12.0...v0.12.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/New-API-App.0.12.1.exe">New-API-App.0.12.1.exe</a>

       (96.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/New-API-App.Setup.0.12.1.exe">New-API-App.Setup.0.12.1.exe</a>

       (97.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/new-api-arm64-v0.12.1">new-api-arm64-v0.12.1</a>

       (63.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/new-api-macos-v0.12.1">new-api-macos-v0.12.1</a>

       (81.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/new-api-v0.12.1">new-api-v0.12.1</a>

       (65.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.1/new-api-v0.12.1.exe">new-api-v0.12.1.exe</a>

       (67.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.1.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.1.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.0

<Callout type="note" title="Release · Published at 2026-04-02 00:22:05 (UTC+8)">
  v0.12.0 adds Wan 2.7 image generation support and streamlines channel setup in the admin UI. It also improves billing accuracy and fixes several model and dashboard issues.

  ### New Features

  * Added support for Wan 2.7 image generation, including control over how many images are generated per request (#3526).

  ### Bug Fixes

  * Fixed image-generation billing and usage statistics so request counts and costs are reported more accurately without double-counting (#3512).
  * Fixed a UI issue that caused the consumption distribution chart to make the page scrollbar flicker on hover (#3474).
  * Fixed xAI Grok-3-mini compatibility when no completion token limit is set, reducing failed requests.

  ### Improvements

  * Made channel setup faster and smoother by letting you create a channel from a copied token, remembering advanced settings in the edit dialog, and improving clipboard handling.

  ***

  ### What's Changed

  * fix(dashboard): 修复消耗分布图表悬浮时滚动条闪烁 by @wans10 in [https://github.com/QuantumNous/new-api/pull/3474](https://github.com/QuantumNous/new-api/pull/3474)
  * docs(zh-TW): fix missing content and add partner logo by @DaZuiZui in [https://github.com/QuantumNous/new-api/pull/3462](https://github.com/QuantumNous/new-api/pull/3462)
  * chore(deps-dev): bump picomatch from 4.0.3 to 4.0.4 in /electron by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/3450](https://github.com/QuantumNous/new-api/pull/3450)
  * fix: prevent double-counting of image count n in billing by @imlhb in [https://github.com/QuantumNous/new-api/pull/3512](https://github.com/QuantumNous/new-api/pull/3512)
  * 支持wan2.7生图-wan2.7-image by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/3526](https://github.com/QuantumNous/new-api/pull/3526)

  ### New Contributors

  * @DaZuiZui made their first contribution in [https://github.com/QuantumNous/new-api/pull/3462](https://github.com/QuantumNous/new-api/pull/3462)
  * @imlhb made their first contribution in [https://github.com/QuantumNous/new-api/pull/3512](https://github.com/QuantumNous/new-api/pull/3512)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0](https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/New-API-App.0.12.0.exe">New-API-App.0.12.0.exe</a>

       (96.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/New-API-App.Setup.0.12.0.exe">New-API-App.Setup.0.12.0.exe</a>

       (97.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/new-api-arm64-v0.12.0">new-api-arm64-v0.12.0</a>

       (63.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/new-api-macos-v0.12.0">new-api-macos-v0.12.0</a>

       (81.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/new-api-v0.12.0">new-api-v0.12.0</a>

       (65.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.12.0/new-api-v0.12.0.exe">new-api-v0.12.0.exe</a>

       (67.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.0-alpha.2

<Callout type="note" title="Release · Published at 2026-03-31 21:43:12 (UTC+8)">
  ### Release Highlights

  This release includes minor improvements to the `EditChannelModal` component to enhance clipboard handling reliability.

  ### Bug Fixes

  * **EditChannelModal:** Enhance clipboard handling with error checks (`670abee`)

  ***

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.12.0-alpha.1...v0.12.0-alpha.2](https://github.com/QuantumNous/new-api/compare/v0.12.0-alpha.1...v0.12.0-alpha.2)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0-alpha.2.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0-alpha.2.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.12.0-alpha.1

<Callout type="note" title="Release · Published at 2026-03-31 19:40:48 (UTC+8)">
  ### Highlights

  This release introduces a new clipboard magic string feature for quick channel creation and includes important security and UI improvements.

  ### New Features

  * Add clipboard magic string for quick channel creation from token copy

  ### Bug Fixes

  * 修复消耗分布图表悬浮时滚动条闪烁 (Fix dashboard scrollbar flickering) (#3474)
  * Fix xAI MaxTokens mapping for grok-3-mini model

  ### Improvements

  * Security improvements
  * Enhance footer layout and styling
  * Update Traditional Chinese README with missing content and partner logo (#3462)
  * Refactor account binding endpoints to use POST and normalize reset responses

  ***

  ### What's Changed

  * fix(dashboard): 修复消耗分布图表悬浮时滚动条闪烁 by @wans10 in [https://github.com/QuantumNous/new-api/pull/3474](https://github.com/QuantumNous/new-api/pull/3474)
  * docs(zh-TW): fix missing content and add partner logo by @DaZuiZui in [https://github.com/QuantumNous/new-api/pull/3462](https://github.com/QuantumNous/new-api/pull/3462)

  ### New Contributors

  * @DaZuiZui made their first contribution in [https://github.com/QuantumNous/new-api/pull/3462](https://github.com/QuantumNous/new-api/pull/3462)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0-alpha.1](https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0-alpha.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0-alpha.1.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.12.0-alpha.1.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.9

<Callout type="note" title="Release · Published at 2026-03-31 17:07:05 (UTC+8)">
  ### Release Notes for v0.11.9

  #### New Features

  * Add slide-in animations and update translations for new UI elements
  * Prevent metadata from overriding model fields (#3461)
  * Record stream interruption reasons via StreamStatus
  * Expose i18n instance to the global window object for easier access

  #### Bug Fixes

  * Restore pre-3400 OpenRouter billing semantics (#3438)
  * Restore doubao coding plan deprecation and regex ignored models lost during conflict resolution
  * Preserve cache usage in openai-to-claude response conversion

  #### Improvements

  * Expose skip-retry option and show it in the rules list (#3440)
  * Harden Docker and release CI workflows to improve security

  ***

  ### What's Changed

  * fix: restore pre-3400 OpenRouter billing semantics by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3438](https://github.com/QuantumNous/new-api/pull/3438)
  * refactor: expose skip-retry option and show it in rules list by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3440](https://github.com/QuantumNous/new-api/pull/3440)
  * feat: prevent metadata from overriding model fields by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/3461](https://github.com/QuantumNous/new-api/pull/3461)
  * chore(deps): bump golang.org/x/image from 0.23.0 to 0.38.0 by @dependabot\[bot] in [https://github.com/QuantumNous/new-api/pull/3507](https://github.com/QuantumNous/new-api/pull/3507)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.9-alpha.1...v0.11.9](https://github.com/QuantumNous/new-api/compare/v0.11.9-alpha.1...v0.11.9)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/checksums-linux.txt">checksums-linux.txt</a>

       (170 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/checksums-macos.txt">checksums-macos.txt</a>

       (88 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/checksums-windows.txt">checksums-windows.txt</a>

       (86 B)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/New-API-App.0.11.9.exe">New-API-App.0.11.9.exe</a>

       (96.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/New-API-App.Setup.0.11.9.exe">New-API-App.Setup.0.11.9.exe</a>

       (97.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/new-api-arm64-v0.11.9">new-api-arm64-v0.11.9</a>

       (63.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/new-api-macos-v0.11.9">new-api-macos-v0.11.9</a>

       (81.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/new-api-v0.11.9">new-api-v0.11.9</a>

       (65.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.9/new-api-v0.11.9.exe">new-api-v0.11.9.exe</a>

       (67.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.9.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.9.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.9-alpha.1

<Callout type="note" title="Release · Published at 2026-03-23 15:40:30 (UTC+8)">
  ### What's Changed

  * fix: disable doubao coding plan selection by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3379](https://github.com/QuantumNous/new-api/pull/3379)
  * fix: oauth bind callback handling by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3393](https://github.com/QuantumNous/new-api/pull/3393)
  * feat: support regex-prefixed ignored upstream models by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3381](https://github.com/QuantumNous/new-api/pull/3381)
  * adjuct default settings by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3335](https://github.com/QuantumNous/new-api/pull/3335)
  * fix: honor channel affinity skip-retry when channel is disabled by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3333](https://github.com/QuantumNous/new-api/pull/3333)
  * fix: apply forced beta query at final upstream URL stage by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3331](https://github.com/QuantumNous/new-api/pull/3331)
  * Refactor/codex usage by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3399](https://github.com/QuantumNous/new-api/pull/3399)
  * refactor: optimize billing flow for OpenAI-to-Anthropic convert by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3400](https://github.com/QuantumNous/new-api/pull/3400)
  * fix: the "detail" field is empty, an empty field was sent to upstream by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3401](https://github.com/QuantumNous/new-api/pull/3401)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.8...v0.11.9-alpha.1](https://github.com/QuantumNous/new-api/compare/v0.11.8...v0.11.9-alpha.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.9-alpha.1.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.9-alpha.1.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.8

<Callout type="note" title="Release · Published at 2026-03-22 13:55:40 (UTC+8)">
  ### What's Changed

  * fix: normalize generic oauth bearer token type by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3359](https://github.com/QuantumNous/new-api/pull/3359)
  * feat: add server log file management to performance settings by @RedwindA in [https://github.com/QuantumNous/new-api/pull/3369](https://github.com/QuantumNous/new-api/pull/3369)
  * feat: Add support for counting cache-hit tokens in llama.cpp by @wenyifancc in [https://github.com/QuantumNous/new-api/pull/3357](https://github.com/QuantumNous/new-api/pull/3357)
  * docs: 完善宝塔面板部署教程并修复链接错误 by @lcq225 in [https://github.com/QuantumNous/new-api/pull/3360](https://github.com/QuantumNous/new-api/pull/3360)

  ### New Contributors

  * @wenyifancc made their first contribution in [https://github.com/QuantumNous/new-api/pull/3357](https://github.com/QuantumNous/new-api/pull/3357)
  * @lcq225 made their first contribution in [https://github.com/QuantumNous/new-api/pull/3360](https://github.com/QuantumNous/new-api/pull/3360)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.7...v0.11.8](https://github.com/QuantumNous/new-api/compare/v0.11.7...v0.11.8)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/New-API-App.0.11.8.exe">New-API-App.0.11.8.exe</a>

       (96.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/New-API-App.Setup.0.11.8.exe">New-API-App.Setup.0.11.8.exe</a>

       (97.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/new-api-arm64-v0.11.8">new-api-arm64-v0.11.8</a>

       (63.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/new-api-macos-v0.11.8">new-api-macos-v0.11.8</a>

       (81.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/new-api-v0.11.8">new-api-v0.11.8</a>

       (65.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.8/new-api-v0.11.8.exe">new-api-v0.11.8.exe</a>

       (67.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.8.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.8.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.7

<Callout type="note" title="Release · Published at 2026-03-19 16:15:24 (UTC+8)">
  ### What's Changed

  * chore: refine PR template by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3287](https://github.com/QuantumNous/new-api/pull/3287)
  * feat: 支持通过环境变量配置搜索接口限流参数 by @ywandy in [https://github.com/QuantumNous/new-api/pull/3313](https://github.com/QuantumNous/new-api/pull/3313)
  * fix: 修正 Codex free 账号用量显示到每周窗口 by @Honghurumeng in [https://github.com/QuantumNous/new-api/pull/3316](https://github.com/QuantumNous/new-api/pull/3316)
  * feat(waffo): Waffo payment gateway integration by @zhongyuanzhao-alt in [https://github.com/QuantumNous/new-api/pull/3293](https://github.com/QuantumNous/new-api/pull/3293)
  * fix: redirect OAuth login in current page by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3329](https://github.com/QuantumNous/new-api/pull/3329)

  ### New Contributors

  * @ywandy made their first contribution in [https://github.com/QuantumNous/new-api/pull/3313](https://github.com/QuantumNous/new-api/pull/3313)
  * @Honghurumeng made their first contribution in [https://github.com/QuantumNous/new-api/pull/3316](https://github.com/QuantumNous/new-api/pull/3316)
  * @zhongyuanzhao-alt made their first contribution in [https://github.com/QuantumNous/new-api/pull/3293](https://github.com/QuantumNous/new-api/pull/3293)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.6...v0.11.7](https://github.com/QuantumNous/new-api/compare/v0.11.6...v0.11.7)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/New-API-App.0.11.7.exe">New-API-App.0.11.7.exe</a>

       (96.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/New-API-App.Setup.0.11.7.exe">New-API-App.Setup.0.11.7.exe</a>

       (97.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/new-api-arm64-v0.11.7">new-api-arm64-v0.11.7</a>

       (63.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/new-api-macos-v0.11.7">new-api-macos-v0.11.7</a>

       (81.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/new-api-v0.11.7">new-api-v0.11.7</a>

       (65.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.7/new-api-v0.11.7.exe">new-api-v0.11.7.exe</a>

       (67.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.7.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.7.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.6-patch.1

<Callout type="note" title="Release · Published at 2026-03-17 18:39:55 (UTC+8)">
  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6-patch.1/new-api-arm64-v0.11.6-patch.1">new-api-arm64-v0.11.6-patch.1</a>

       (62.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6-patch.1/new-api-macos-v0.11.6-patch.1">new-api-macos-v0.11.6-patch.1</a>

       (81.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6-patch.1/new-api-v0.11.6-patch.1">new-api-v0.11.6-patch.1</a>

       (65.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6-patch.1/new-api-v0.11.6-patch.1.exe">new-api-v0.11.6-patch.1.exe</a>

       (66.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.6-patch.1.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.6-patch.1.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.6

<Callout type="note" title="Release · Published at 2026-03-17 17:23:40 (UTC+8)">
  参数覆盖记录到日志
  错误日志恢复tooltip显示

  ### What's Changed

  * feat: params override log by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3285](https://github.com/QuantumNous/new-api/pull/3285)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.5...v0.11.6](https://github.com/QuantumNous/new-api/compare/v0.11.5...v0.11.6)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/New-API-App.0.11.6.exe">New-API-App.0.11.6.exe</a>

       (96.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/New-API-App.Setup.0.11.6.exe">New-API-App.Setup.0.11.6.exe</a>

       (96.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/new-api-arm64-v0.11.6">new-api-arm64-v0.11.6</a>

       (62.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/new-api-macos-v0.11.6">new-api-macos-v0.11.6</a>

       (81.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/new-api-v0.11.6">new-api-v0.11.6</a>

       (65.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.6/new-api-v0.11.6.exe">new-api-v0.11.6.exe</a>

       (66.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.6.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.6.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## nightly-20260317

<Callout type="note" title="Release · Published at 2026-03-17 18:30:50 (UTC+8)">
  feat: implement tiered billing expression evaluation

  Docker image: calciumion/new-api:nightly

  <img width="500" alt="" src="https://github.com/user-attachments/assets/893d5789-64b3-414d-8e71-cc178b724ac6" />

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/nightly-20260317-44fc10b/new-api-macos-nightly-20260317-44fc10b">new-api-macos-nightly-20260317-44fc10b</a>

       (82.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/nightly-20260317-44fc10b.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/nightly-20260317-44fc10b.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.5

<Callout type="note" title="Release · Published at 2026-03-15 01:27:39 (UTC+8)">
  ### What's Changed

  * Round remaining balance by @KiGamji in [https://github.com/QuantumNous/new-api/pull/3233](https://github.com/QuantumNous/new-api/pull/3233)
  * enhance channel key viewing by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3257](https://github.com/QuantumNous/new-api/pull/3257)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.5](https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.5)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/New-API-App.0.11.5.exe">New-API-App.0.11.5.exe</a>

       (96.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/New-API-App.Setup.0.11.5.exe">New-API-App.Setup.0.11.5.exe</a>

       (96.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/new-api-arm64-v0.11.5">new-api-arm64-v0.11.5</a>

       (62.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/new-api-macos-v0.11.5">new-api-macos-v0.11.5</a>

       (81.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/new-api-v0.11.5">new-api-v0.11.5</a>

       (65.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.5/new-api-v0.11.5.exe">new-api-v0.11.5.exe</a>

       (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.5.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.5.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.4-patch.1

<Callout type="note" title="Release · Published at 2026-03-14 15:31:42 (UTC+8)">
  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.4-patch.1](https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.4-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4-patch.1/new-api-arm64-v0.11.4-patch.1">new-api-arm64-v0.11.4-patch.1</a>

       (62.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4-patch.1/new-api-macos-v0.11.4-patch.1">new-api-macos-v0.11.4-patch.1</a>

       (81.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4-patch.1/new-api-v0.11.4-patch.1">new-api-v0.11.4-patch.1</a>

       (65.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4-patch.1/new-api-v0.11.4-patch.1.exe">new-api-v0.11.4-patch.1.exe</a>

       (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-patch.1.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-patch.1.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.4

<Callout type="note" title="Release · Published at 2026-03-12 15:37:12 (UTC+8)">
  ### What's Changed

  * Feature/param override wildcard path by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3129](https://github.com/QuantumNous/new-api/pull/3129)
  * fix: fetch model add header passthrough rule key check by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/3130](https://github.com/QuantumNous/new-api/pull/3130)
  * feats: repair the thinking of claude to openrouter convert by @nekohy in [https://github.com/QuantumNous/new-api/pull/3120](https://github.com/QuantumNous/new-api/pull/3120)
  * feat: kling cost quota support use FinalUnitDeduction as totalToken by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2769](https://github.com/QuantumNous/new-api/pull/2769)
  * fix: If top\_p is not provided, ignore it by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3141](https://github.com/QuantumNous/new-api/pull/3141)
  * fix(relay): skip retries for bad response body errors by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3151](https://github.com/QuantumNous/new-api/pull/3151)
  * 为渠道参数覆盖可视化规则提供拖拽排序支持 by @somnifex in [https://github.com/QuantumNous/new-api/pull/3166](https://github.com/QuantumNous/new-api/pull/3166)
  * fix: kling risk fail return openAIVideo error by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/3148](https://github.com/QuantumNous/new-api/pull/3148)
  * fix: add explicit docker-compose networks by @pigletfly in [https://github.com/QuantumNous/new-api/pull/3147](https://github.com/QuantumNous/new-api/pull/3147)
  * feat：support $keep\_only\_declared and deduped $append for header override by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3182](https://github.com/QuantumNous/new-api/pull/3182)
  * chore: update model lists for frequently used channels by @RedwindA in [https://github.com/QuantumNous/new-api/pull/3221](https://github.com/QuantumNous/new-api/pull/3221)

  ### New Contributors

  * @pigletfly made their first contribution in [https://github.com/QuantumNous/new-api/pull/3147](https://github.com/QuantumNous/new-api/pull/3147)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.2...v0.11.4](https://github.com/QuantumNous/new-api/compare/v0.11.2...v0.11.4)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/New-API-App.0.11.4.exe">New-API-App.0.11.4.exe</a>

       (96.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/New-API-App.Setup.0.11.4.exe">New-API-App.Setup.0.11.4.exe</a>

       (96.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/new-api-arm64-v0.11.4">new-api-arm64-v0.11.4</a>

       (62.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/new-api-macos-v0.11.4">new-api-macos-v0.11.4</a>

       (81.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/new-api-v0.11.4">new-api-v0.11.4</a>

       (65.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.11.4/new-api-v0.11.4.exe">new-api-v0.11.4.exe</a>

       (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.4-alpha.5

<Callout type="note" title="Release · Published at 2026-03-10 02:03:34 (UTC+8)">
  请求头覆盖新增追加功能

  ### What's Changed

  * fix: kling risk fail return openAIVideo error by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/3148](https://github.com/QuantumNous/new-api/pull/3148)
  * fix: add explicit docker-compose networks by @pigletfly in [https://github.com/QuantumNous/new-api/pull/3147](https://github.com/QuantumNous/new-api/pull/3147)
  * feat：support $keep\_only\_declared and deduped $append for header override by @seefs001 in [https://github.com/QuantumNous/new-api/pull/3182](https://github.com/QuantumNous/new-api/pull/3182)

  ### New Contributors

  * @pigletfly made their first contribution in [https://github.com/QuantumNous/new-api/pull/3147](https://github.com/QuantumNous/new-api/pull/3147)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.4...v0.11.4-alpha.5](https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.4...v0.11.4-alpha.5)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-alpha.5.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-alpha.5.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***

## v0.11.4-alpha.4

<Callout type="note" title="Release · Published at 2026-03-08 22:42:27 (UTC+8)">
  为渠道参数覆盖可视化规则提供拖拽排序支持
  后端Token相关API变更

  ### What's Changed

  * 为渠道参数覆盖可视化规则提供拖拽排序支持 by @somnifex in [https://github.com/QuantumNous/new-api/pull/3166](https://github.com/QuantumNous/new-api/pull/3166)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.3...v0.11.4-alpha.4](https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.3...v0.11.4-alpha.4)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-alpha.4.zip">Source code (zip)</a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.11.4-alpha.4.tar.gz">Source code (tar.gz)</a>
    </li>
  </ul>
</Callout>

***


# Special Thanks

import { Callout } from 'fumadocs-ui/components/callout';

The development of New API would not be possible without the support and contributions of the community. We would like to express our special gratitude to all individuals and organizations who have helped with this project.

## ❤️ Sponsors

Below are all the sponsors who have provided financial support for the project. Thank you for their generous donations that allow the project to continue developing!

<Callout title="Sponsor Information · Data updated at 2026-4-18 15:05:06 (UTC+8)">
  The following sponsor data is automatically retrieved from the Afdian platform. Based on the cumulative sponsorship amount, they are divided into three levels: Gold, Silver, and Bronze. If you would also like to provide financial support for the project, you are welcome to make a donation on the [Afdian](https://afdian.com/a/new-api) platform.
</Callout>

### 🥇 Gold Sponsors

Thank you to the following gold sponsors (sponsorship amount ≥ ¥10,001) for their generous support!

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/3fa029503a2a11f09cdc5254001e7c00/avatar/7375d27e01cb39688579c2a6e38cf1c7_w1080_h1080_s120.jpeg" alt="gala" className="w-20 h-20 rounded-full border-4 border-yellow-400 shadow-lg shadow-yellow-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      gala
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10001.00
    </span>
  </div>
</div>

***

### 🥈 Silver Sponsors

Thank you to the following silver sponsors (sponsorship amount ¥1,001-¥10,000) for their generous support!

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/aa8818c63f3211e9b11852540025c377/avatar/f47b48e57f544fb7ae9a7ea61ef424c8_w1284_h1284_s368.jpeg" alt="奥利奥利奥" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      奥利奥利奥
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥8000.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/52774fb85a8911ee8c0b52540025c377/avatar/198c6c7ac518bae6443c54e911739b3d_w282_h282_s574.jpg.gif" alt="月歌殿下" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      月歌殿下
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥2600.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_3cc36" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_3cc36
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥2500.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_NkhT" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_NkhT
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1450.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/e819d9c627f911ef8a4952540025c377/avatar/22e9581d5d394e7624a7e17c98b58e7e_w1080_h1080_s157.jpeg" alt="wangyuee" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      wangyuee
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_69dae" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_69dae
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1152.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="key" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      key
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1150.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/5ab96244655611eca9d752540025c377/avatar/f8dba601ed9073e4bd08481ee115247a_w1024_h1024_s70.png" alt="皮皮伟" className="w-20 h-20 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      皮皮伟
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1020.00
    </span>
  </div>
</div>

***

### 🥉 Bronze Sponsors

Thank you to the following bronze sponsors (sponsorship amount ¥0-¥1,000) for their support!

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="赵利利" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      赵利利
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1000.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="猪猪子zy" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      猪猪子zy
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥1000.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/99b04b76183211ee9e9052540025c377/avatar/19a45ff8427f4cb804c64456d08ca013_w700_h700_s87.jpeg" alt="miss" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      miss
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥888.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_a32c6" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_a32c6
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥888.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_0c0a2" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_0c0a2
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥500.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/user_upload_osl/bbdbcdb8ef56cc6873f047c9114cd26d_w132_h132_s2.jpeg" alt="papersnake" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      papersnake
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥400.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="Hunter killer" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      Hunter killer
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥400.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_41b29" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_41b29
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥388.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/a33d5fecf11711ebad8352540025c377/avatar/2ffe77874776fd9f087c29b487f10674_w4032_h3024_s6468.jpg" alt="朱昆鹏" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      朱昆鹏
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥300.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="爱发电用户_RQrm" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_RQrm
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥300.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_TV9k" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_TV9k
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥250.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/user_upload_osl/e37e80635ba0a9b315fb91d6cabbaee7_w132_h132_s6.jpeg" alt="盲" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      盲
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥210.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="张前鹏" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      张前鹏
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥205.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_skuW" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_skuW
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_9c3c8" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_9c3c8
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_31729" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_31729
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="小明咪" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      小明咪
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_f7d1c" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_f7d1c
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="爱发电用户_HvTS" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_HvTS
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_07e33" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_07e33
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/495b8e5c7fc911eeaabf52540025c377/avatar/762a2acf0a072416d7eaba1ebb065452_w512_h512_s24.jpeg" alt="BlueSky" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      BlueSky
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_RX9Y" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_RX9Y
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_afbef" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_afbef
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_61eb9" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_61eb9
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_c2122" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_c2122
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_2e88b" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_2e88b
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_ca3cd" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_ca3cd
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="dafeng" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      dafeng
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_3b6cb" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_3b6cb
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/ebf38bbc87ef11f0b3da52540025c377/avatar/426690a6f3de8ffa4c7c9ea88134a445_w967_h967_s1264.png" alt="桐原土司" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      桐原土司
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/38d2b1261dba11ee8c0752540025c377/avatar/3648c6490361f1585cfd2ef7a324ec8f_w2160_h3840_s855.jpeg" alt="寰渡科技" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      寰渡科技
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_53a07" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_53a07
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_f4b6a" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_f4b6a
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="智强" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      智强
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/e6434fcc4bef11f0b4a352540025c377/avatar/949c087732ff1332efc85c1f0c826a1f_w1280_h720_s1050.png" alt="Dee" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      Dee
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_273c5" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_273c5
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_d3e8c" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_d3e8c
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="Volador" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      Volador
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_WeKp" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_WeKp
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_df2c0" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_df2c0
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_803b9" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_803b9
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/2ebeaaba859b11efbc3a5254001e7c00/avatar/f1a46461c4901360c49f51edea76422f_w827_h828_s69.jpeg" alt="Mufasa" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      Mufasa
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_0fc42" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_0fc42
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_764de" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_764de
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/0a93cb68d68611edbb355254001e7c00/avatar/e1f4d72eb5ca93d7840029f3230fd4f0_w486_h486_s35.jpeg" alt="zmh-program" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      zmh-program
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥200.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_c18b8" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_c18b8
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥100.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_9e15c" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_9e15c
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥100.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="爱发电用户_mMKB" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_mMKB
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥88.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_41582" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_41582
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥66.66
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="爱发电用户_K6rG" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_K6rG
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥60.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="代码居士" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      代码居士
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_7cbea" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_7cbea
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_c700c" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_c700c
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="su" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      su
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="blue" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      blue
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/user_upload_osl/6cb183e6f34a8a815ee953ac5de078b4_w132_h132_s7.jpeg" alt="俊熙" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      俊熙
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_yqKb" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_yqKb
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="爱发电用户_dACN" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_dACN
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_7353e" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_7353e
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_9WXG" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_9WXG
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_9G6v" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_9G6v
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/default-avatar@2x.png" alt="takoyaki" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      takoyaki
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="爱发电用户_T4f7" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_T4f7
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/cccc0a9ace2211edac4352540025c377/avatar/25e234aa7bcea63353bfc87e5e6f4beb_w1073_h1074_s61.png" alt="ChatGPT" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      ChatGPT
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_796f4" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_796f4
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥50.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_08890" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_08890
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥30.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_dcd86" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_dcd86
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="爱发电用户_AvRM" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_AvRM
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_WVck" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_WVck
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_WNQd" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_WNQd
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="爱发电用户_mpUu" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_mpUu
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="爱发电用户_RQY4" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_RQY4
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥10.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_3be60" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_3be60
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="天悦" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      天悦
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="江" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      江
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_6d610" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      爱发电用户_6d610
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/user/ac0fb2cc833611f08e155254001e7c00/avatar/ea2a5e9dcd37fa1ed3cf55d00a9aec1f_w467_h467_s22.png" alt="Burncloud" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      Burncloud
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

<div className="flex items-center mb-5 p-4 rounded-lg bg-fd-muted/30">
  <div className="mr-5">
    <img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="LCYang" className="w-20 h-20 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <span className="text-lg font-semibold mb-1">
      LCYang
    </span>

    <span className="text-sm text-muted-foreground">
      Total Sponsored: ¥5.00
    </span>
  </div>
</div>

***

## 👨‍💻 Developer Contributors

Below is a list of all developers who have contributed to the project. We thank them for their hard work and creativity!

<Callout title="Contributor Information · Data updated at 2026-4-18 15:05:06 (UTC+8)">
  The following contributor data is automatically retrieved from the [GitHub Contributors page](https://github.com/QuantumNous/new-api/graphs/contributors) for the top 50 contributors. The top three contributors are marked with gold, silver, and bronze borders respectively. If you would also like to contribute to the project, you are welcome to submit a Pull Request.
</Callout>

### 🥇 Calcium-Ion

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/61247483?v=4" alt="Calcium-Ion" className="w-16 h-16 rounded-full border-4 border-yellow-400 shadow-lg shadow-yellow-400/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Calcium-Ion" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Calcium-Ion
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 2595
    </span>
  </div>
</div>

***

### 🥈 songquanpeng

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/39998050?v=4" alt="songquanpeng" className="w-16 h-16 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/songquanpeng" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      songquanpeng
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 509
    </span>
  </div>
</div>

***

### 🥉 seefs001

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/40468931?v=4" alt="seefs001" className="w-16 h-16 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/seefs001" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      seefs001
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 508
    </span>
  </div>
</div>

***

### t0ng7u

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/133845290?v=4" alt="t0ng7u" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/t0ng7u" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      t0ng7u
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 411
    </span>
  </div>
</div>

***

### creamlike1024

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/25699126?v=4" alt="creamlike1024" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/creamlike1024" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      creamlike1024
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 186
    </span>
  </div>
</div>

***

### feitianbubu

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/6916415?v=4" alt="feitianbubu" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/feitianbubu" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      feitianbubu
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 165
    </span>
  </div>
</div>

***

### RedwindA

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/128586631?v=4" alt="RedwindA" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/RedwindA" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      RedwindA
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 105
    </span>
  </div>
</div>

***

### xyfacai

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/52985669?v=4" alt="xyfacai" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xyfacai" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      xyfacai
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 53
    </span>
  </div>
</div>

***

### HynoR

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/20227709?v=4" alt="HynoR" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/HynoR" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      HynoR
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 44
    </span>
  </div>
</div>

***

### QuentinHsu

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/21162238?v=4" alt="QuentinHsu" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/QuentinHsu" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      QuentinHsu
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 32
    </span>
  </div>
</div>

***

### somnifex

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/98788152?v=4" alt="somnifex" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/somnifex" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      somnifex
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 25
    </span>
  </div>
</div>

***

### guoruqiang

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/61670021?v=4" alt="guoruqiang" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/guoruqiang" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      guoruqiang
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 25
    </span>
  </div>
</div>

***

### wzxjohn

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1193593?v=4" alt="wzxjohn" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/wzxjohn" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      wzxjohn
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 22
    </span>
  </div>
</div>

***

### tbphp

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17903218?v=4" alt="tbphp" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/tbphp" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      tbphp
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 19
    </span>
  </div>
</div>

***

### dependabot\[bot]

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/in/29110?v=4" alt="dependabot[bot]" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/apps/dependabot" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      dependabot[bot]
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 18
    </span>
  </div>
</div>

***

### iszcz

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/74706321?v=4" alt="iszcz" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/iszcz" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      iszcz
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 18
    </span>
  </div>
</div>

***

### prnake

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/52364396?v=4" alt="prnake" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/prnake" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      prnake
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 17
    </span>
  </div>
</div>

***

### nekohy

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/152958106?v=4" alt="nekohy" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/nekohy" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      nekohy
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 16
    </span>
  </div>
</div>

***

### mrhaoji

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/483419?v=4" alt="mrhaoji" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/mrhaoji" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      mrhaoji
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 15
    </span>
  </div>
</div>

***

### neotf

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/10400594?v=4" alt="neotf" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/neotf" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      neotf
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 14
    </span>
  </div>
</div>

***

### bubblepipe

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/30717258?v=4" alt="bubblepipe" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/bubblepipe" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      bubblepipe
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 13
    </span>
  </div>
</div>

***

### danding5

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/9128697?v=4" alt="danding5" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/danding5" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      danding5
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 12
    </span>
  </div>
</div>

***

### luxlzz6

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/53847251?v=4" alt="luxlzz6" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/luxlzz6" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      luxlzz6
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 12
    </span>
  </div>
</div>

***

### MapleEve

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1845053?v=4" alt="MapleEve" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/MapleEve" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      MapleEve
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 12
    </span>
  </div>
</div>

***

### Yan-Zero

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/32036413?v=4" alt="Yan-Zero" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Yan-Zero" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Yan-Zero
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 11
    </span>
  </div>
</div>

***

### littlewrite

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/9785694?v=4" alt="littlewrite" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/littlewrite" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      littlewrite
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 11
    </span>
  </div>
</div>

***

### Sh1n3zZ

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/110708622?v=4" alt="Sh1n3zZ" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Sh1n3zZ" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Sh1n3zZ
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 10
    </span>
  </div>
</div>

***

### quzard

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/30899719?v=4" alt="quzard" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/quzard" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      quzard
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 9
    </span>
  </div>
</div>

***

### comeback01

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17897116?v=4" alt="comeback01" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/comeback01" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      comeback01
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 8
    </span>
  </div>
</div>

***

### Licoy

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/20410697?v=4" alt="Licoy" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Licoy" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Licoy
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 8
    </span>
  </div>
</div>

***

### Ehco1996

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/24697284?v=4" alt="Ehco1996" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Ehco1996" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Ehco1996
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 7
    </span>
  </div>
</div>

***

### JoeyLearnsToCode

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/11903658?v=4" alt="JoeyLearnsToCode" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/JoeyLearnsToCode" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      JoeyLearnsToCode
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 7
    </span>
  </div>
</div>

***

### zhongyuanzhao-alt

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/251140080?v=4" alt="zhongyuanzhao-alt" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/zhongyuanzhao-alt" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      zhongyuanzhao-alt
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 7
    </span>
  </div>
</div>

***

### igophper

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/34326532?v=4" alt="igophper" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/igophper" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      igophper
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 7
    </span>
  </div>
</div>

***

### Sacode

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1641279?v=4" alt="Sacode" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Sacode" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      Sacode
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 7
    </span>
  </div>
</div>

***

### fevrax

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/58434904?v=4" alt="fevrax" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/fevrax" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      fevrax
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### ckt1031

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/65409152?v=4" alt="ckt1031" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/ckt1031" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      ckt1031
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### glzjin

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/7975407?v=4" alt="glzjin" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/glzjin" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      glzjin
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### google-labs-jules\[bot]

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/in/842251?v=4" alt="google-labs-jules[bot]" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/apps/google-labs-jules" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      google-labs-jules[bot]
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### liusanp

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/13930358?v=4" alt="liusanp" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/liusanp" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      liusanp
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### xixingya

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/37765666?v=4" alt="xixingya" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xixingya" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      xixingya
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### xiangyuanliu

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/93586556?v=4" alt="xiangyuanliu" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xiangyuanliu" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      xiangyuanliu
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### wans10

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/51012039?v=4" alt="wans10" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/wans10" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      wans10
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 6
    </span>
  </div>
</div>

***

### p3psi-boo

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/43925055?v=4" alt="p3psi-boo" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/p3psi-boo" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      p3psi-boo
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### QAbot-zh

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/40236765?v=4" alt="QAbot-zh" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/QAbot-zh" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      QAbot-zh
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### OswinWu

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/22212484?v=4" alt="OswinWu" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/OswinWu" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      OswinWu
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### xqx333

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/141810964?v=4" alt="xqx333" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xqx333" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      xqx333
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### daggeryu

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17616921?v=4" alt="daggeryu" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/daggeryu" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      daggeryu
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### x-Ai

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/5061489?v=4" alt="x-Ai" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/x-Ai" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      x-Ai
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 5
    </span>
  </div>
</div>

***

### kuwork

<div className="flex items-center mb-5">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/6893350?v=4" alt="kuwork" className="w-16 h-16 rounded-full " />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/kuwork" target="_blank" rel="noopener noreferrer" className="font-medium no-underline mb-1">
      kuwork
    </a>

    <span className="text-sm text-muted-foreground">
      Contributions: 4
    </span>
  </div>
</div>

***


# Docker Compose Configuration Guide

This document details the Docker Compose configuration options for New API, applicable to various deployment scenarios.

## Basic Configuration Structure

The Docker Compose configuration file `docker-compose.yml` defines how the New API service and its dependent services (such as MySQL, Redis) are deployed.

## Standard Configuration (Recommended for Production)

Below is the standard Docker Compose configuration, suitable for most production environments:

```yaml
# New-API Docker Compose Configuration
#
# Quick Start:
#   1. docker-compose up -d
#   2. Access at http://localhost:3000
#
# Using MySQL instead of PostgreSQL:
#   1. Comment out the postgres service and SQL_DSN line 15
#   2. Uncomment the mysql service and SQL_DSN line 16
#   3. Uncomment mysql in depends_on (line 28)
#   4. Uncomment mysql_data in volumes section (line 64)
#
# ⚠️  IMPORTANT: Change all default passwords before deploying to production!

version: '3.4' # For compatibility with older Docker versions

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    command: --log-dir /app/logs
    ports:
      - '3000:3000'
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    environment:
      - SQL_DSN=postgresql://root:123456@postgres:5432/new-api # ⚠️ IMPORTANT: Change the password in production!
      #      - SQL_DSN=root:123456@tcp(mysql:3306)/new-api  # Point to the mysql service, uncomment if using MySQL
      - REDIS_CONN_STRING=redis://redis
      - TZ=Asia/Shanghai
      - ERROR_LOG_ENABLED=true # Whether to enable error logging
      - BATCH_UPDATE_ENABLED=true # Whether to enable batch update
    #      - STREAMING_TIMEOUT=300  # Streaming timeout in seconds, default is 120s. Increase if experiencing empty completions
    #      - SESSION_SECRET=random_string  # For multi-node deployment, this random string must be changed!
    #      - SYNC_FREQUENCY=60  # Uncomment if regular database syncing is needed

    depends_on:
      - redis
      - postgres
    #      - mysql  # Uncomment if using MySQL
    healthcheck:
      test:
        [
          'CMD-SHELL',
          "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1",
        ]
      interval: 30s
      timeout: 10s
      retries: 3

  redis:
    image: redis:latest
    container_name: redis
    restart: always

  postgres:
    image: postgres:15
    container_name: postgres
    restart: always
    environment:
      POSTGRES_USER: root
      POSTGRES_PASSWORD: 123456 # ⚠️ IMPORTANT: Change this password in production!
      POSTGRES_DB: new-api
    volumes:
      - pg_data:/var/lib/postgresql/data
#    ports:
#      - "5432:5432"  # Uncomment if you need to access PostgreSQL from outside Docker

#  mysql:
#    image: mysql:8.2
#    container_name: mysql
#    restart: always
#    environment:
#      MYSQL_ROOT_PASSWORD: 123456  # ⚠️ IMPORTANT: Change this password in production!
#      MYSQL_DATABASE: new-api
#    volumes:
#      - mysql_data:/var/lib/mysql
#    ports:
#      - "3306:3306"  # Uncomment if you need to access MySQL from outside Docker

volumes:
  pg_data:
#  mysql_data:
```

## Simplified Configuration (Suitable for Testing)

For testing purposes, you can use the following simplified version, which only includes the New API service itself:

```yaml
services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - '3000:3000'
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/data
```

## Configuration Details

### New API Service Configuration

| Parameter        | Description                                                                    |
| ---------------- | ------------------------------------------------------------------------------ |
| `image`          | Image name, usually `calciumion/new-api:latest` to get the latest version      |
| `container_name` | Container name, customizable                                                   |
| `restart`        | Container restart policy, recommended to set to `always` for automatic restart |
| `command`        | Startup command, customizable startup parameters                               |
| `ports`          | Port mapping, by default maps container's 3000 port to host's 3000 port        |
| `volumes`        | Volume mapping, ensures data persistence                                       |
| `environment`    | Environment variable settings, used to configure New API behavior              |
| `depends_on`     | Dependent services, ensures startup in the correct order                       |
| `healthcheck`    | Health check configuration, used to monitor service status                     |

### Environment Variable Description

New API supports various environment variable configurations. Here are some commonly used ones:

| Environment Variable | Description                                         | Example                               |
| -------------------- | --------------------------------------------------- | ------------------------------------- |
| `SQL_DSN`            | Database connection string                          | `root:123456@tcp(mysql:3306)/new-api` |
| `REDIS_CONN_STRING`  | Redis connection string                             | `redis://redis`                       |
| `TZ`                 | Time zone setting                                   | `Asia/Shanghai`                       |
| `SESSION_SECRET`     | Session secret (required for multi-node deployment) | `your_random_string`                  |
| `NODE_TYPE`          | Node type (master/slave)                            | `master` or `slave`                   |
| `SYNC_FREQUENCY`     | Sync frequency (seconds)                            | `60`                                  |

For a more complete list of environment variables, please refer to the [Environment Variables Configuration Guide](/en/docs/installation/config-maintenance/environment-variables).

## Multi-Node Deployment Configuration

For multi-node deployment scenarios, the configuration for master and slave nodes differs slightly:

### Master Node Configuration

```yaml
services:
  new-api-master:
    image: calciumion/new-api:latest
    container_name: new-api-master
    restart: always
    ports:
      - '3000:3000'
    environment:
      - SQL_DSN=root:123456@tcp(mysql:3306)/new-api
      - REDIS_CONN_STRING=redis://redis
      - SESSION_SECRET=your_unique_session_secret
      - CRYPTO_SECRET=your_unique_crypto_secret
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/data
```

### Slave Node Configuration

```yaml
services:
  new-api-slave:
    image: calciumion/new-api:latest
    container_name: new-api-slave
    restart: always
    ports:
      - '3001:3000' # Note the different port mapping
    environment:
      - SQL_DSN=root:123456@tcp(mysql:3306)/new-api
      - REDIS_CONN_STRING=redis://redis
      - SESSION_SECRET=your_unique_session_secret # Must be the same as the master node
      - CRYPTO_SECRET=your_unique_crypto_secret # Must be the same as the master node
      - NODE_TYPE=slave # Set as slave node
      - SYNC_FREQUENCY=60
      - TZ=Asia/Shanghai
    volumes:
      - ./data-slave:/data
```

## Usage

### Installation

Save the configuration as `docker-compose.yml` and then run the following command in the same directory:

```bash
docker compose up -d
```

### Viewing Logs

```bash
docker compose logs -f
```

### Stopping Services

```bash
docker compose down
```

<Callout type="info" title="Tip">
  For more information on using Docker Compose, please refer to the [Docker
  Compose Installation
  Guide](/en/docs/installation/deployment-methods/docker-compose-installation).
</Callout>


# Environment Variable Configuration Guide

This document provides all environment variables supported by New API and their configuration instructions. You can customize the system's behavior by setting these environment variables.

<Callout type="info" title="Tip">
  New API supports reading environment variables from `.env` files. Please refer to the `.env.example`
  file and rename it to `.env` when using it.
</Callout>

## Basic Configuration

| Environment Variable | Description                     | Default Value | Example               |
| -------------------- | ------------------------------- | ------------- | --------------------- |
| `PORT`               | Service listening port          | `3000`        | `PORT=8080`           |
| `TZ`                 | Time zone setting               | -             | `TZ=America/New_York` |
| `VERSION`            | Override running version number | -             | `VERSION=1.2.3`       |

## Database Configuration

| Environment Variable | Description                                       | Default Value         | Example                                                                                                                          |
| -------------------- | ------------------------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `SQL_DSN`            | Database connection string                        | SQLite (`one-api.db`) | MySQL: `SQL_DSN=root:123456@tcp(localhost:3306)/new-api` \| PostgreSQL: `SQL_DSN=postgresql://root:123456@postgres:5432/new-api` |
| `SQL_MAX_IDLE_CONNS` | Maximum idle connections in connection pool       | `100`                 | `SQL_MAX_IDLE_CONNS=50`                                                                                                          |
| `SQL_MAX_OPEN_CONNS` | Maximum open connections in connection pool       | `1000`                | `SQL_MAX_OPEN_CONNS=500`                                                                                                         |
| `SQL_MAX_LIFETIME`   | Maximum connection lifetime (seconds)             | `60`                  | `SQL_MAX_LIFETIME=120`                                                                                                           |
| `LOG_SQL_DSN`        | Separate database connection string for log table | -                     | `LOG_SQL_DSN=root:123456@tcp(localhost:3306)/oneapi_logs`                                                                        |
| `SQLITE_PATH`        | SQLite database path                              | `one-api.db`          | `SQLITE_PATH=/var/lib/new-api/new-api.db`                                                                                        |

## Cache Configuration

| Environment Variable    | Description                                                                  | Default Value | Example                                                    |
| ----------------------- | ---------------------------------------------------------------------------- | ------------- | ---------------------------------------------------------- |
| `REDIS_CONN_STRING`     | Redis connection string                                                      | -             | `REDIS_CONN_STRING=redis://default:redispw@localhost:6379` |
| `REDIS_POOL_SIZE`       | Redis connection pool size                                                   | `10`          | `REDIS_POOL_SIZE=20`                                       |
| `MEMORY_CACHE_ENABLED`  | Whether to enable memory cache (automatically enabled when Redis is enabled) | `false`       | `MEMORY_CACHE_ENABLED=true`                                |
| `SYNC_FREQUENCY`        | Cache and database synchronization frequency (seconds)                       | `60`          | `SYNC_FREQUENCY=120`                                       |
| `BATCH_UPDATE_ENABLED`  | Enable database batch update aggregation                                     | `false`       | `BATCH_UPDATE_ENABLED=true`                                |
| `BATCH_UPDATE_INTERVAL` | Batch update aggregation interval (seconds)                                  | `5`           | `BATCH_UPDATE_INTERVAL=10`                                 |

## Multi-node and Security Configuration

| Environment Variable       | Description                                                                         | Default Value | Example                                                |
| -------------------------- | ----------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------ |
| `SESSION_SECRET`           | Session secret (required for multi-machine deployment)                              | -             | `SESSION_SECRET=your_session_secret`                   |
| `CRYPTO_SECRET`            | Encryption secret (encrypts database content, defaults to SESSION\_SECRET)          | -             | `CRYPTO_SECRET=your_crypto_secret`                     |
| `FRONTEND_BASE_URL`        | Frontend base URL (used by slave nodes, redirects unmatched routes to this address) | -             | `FRONTEND_BASE_URL=https://<your-newapi-domain>`       |
| `NODE_TYPE`                | Node type                                                                           | `master`      | `NODE_TYPE=slave`                                      |
| `TLS_INSECURE_SKIP_VERIFY` | Globally skip TLS certificate verification                                          | `false`       | `TLS_INSECURE_SKIP_VERIFY=true`                        |
| `TRUSTED_REDIRECT_DOMAINS` | List of trusted redirect domains (comma-separated)                                  | -             | `TRUSTED_REDIRECT_DOMAINS=example.com,api.example.com` |

<Callout type="warn" title="SESSION_SECRET Notes">
  `SESSION_SECRET` cannot be set to `random_string`, otherwise the program will refuse to start. All nodes must use the same secret for multi-machine deployment.
</Callout>

<Callout type="info" title="Cluster Deployment">
  For how to build a complete cluster deployment using these environment variables, please refer to the [Cluster Deployment Guide](/en/docs/installation/deployment-methods/cluster-deployment).
</Callout>

## User and Token Configuration

| Environment Variable                 | Description                                                   | Default Value | Example                                 |
| ------------------------------------ | ------------------------------------------------------------- | ------------- | --------------------------------------- |
| `GENERATE_DEFAULT_TOKEN`             | Generate initial token for new registered users               | `false`       | `GENERATE_DEFAULT_TOKEN=true`           |
| `NOTIFICATION_LIMIT_DURATION_MINUTE` | Notification limit duration (minutes)                         | `10`          | `NOTIFICATION_LIMIT_DURATION_MINUTE=15` |
| `NOTIFY_LIMIT_COUNT`                 | Maximum number of notifications within the specified duration | `2`           | `NOTIFY_LIMIT_COUNT=3`                  |

## Request Limit Configuration

| Environment Variable             | Description                                    | Default Value | Example                              |
| -------------------------------- | ---------------------------------------------- | ------------- | ------------------------------------ |
| `GLOBAL_API_RATE_LIMIT_ENABLE`   | Global API rate limit switch                   | `true`        | `GLOBAL_API_RATE_LIMIT_ENABLE=false` |
| `GLOBAL_API_RATE_LIMIT`          | Global API rate limit (per IP)                 | `180`         | `GLOBAL_API_RATE_LIMIT=100`          |
| `GLOBAL_API_RATE_LIMIT_DURATION` | Global API rate limit window (seconds)         | `180`         | `GLOBAL_API_RATE_LIMIT_DURATION=120` |
| `GLOBAL_WEB_RATE_LIMIT_ENABLE`   | Global Web rate limit switch                   | `true`        | `GLOBAL_WEB_RATE_LIMIT_ENABLE=false` |
| `GLOBAL_WEB_RATE_LIMIT`          | Global Web rate limit (per IP)                 | `60`          | `GLOBAL_WEB_RATE_LIMIT=30`           |
| `GLOBAL_WEB_RATE_LIMIT_DURATION` | Global Web rate limit window (seconds)         | `180`         | `GLOBAL_WEB_RATE_LIMIT_DURATION=120` |
| `CRITICAL_RATE_LIMIT_ENABLE`     | Critical operation rate limit switch           | `true`        | `CRITICAL_RATE_LIMIT_ENABLE=false`   |
| `CRITICAL_RATE_LIMIT`            | Critical operation rate limit count            | `20`          | `CRITICAL_RATE_LIMIT=10`             |
| `CRITICAL_RATE_LIMIT_DURATION`   | Critical operation rate limit window (seconds) | `1200`        | `CRITICAL_RATE_LIMIT_DURATION=600`   |

## Relay and Proxy Configuration

| Environment Variable            | Description                                                                        | Default Value | Example                             |
| ------------------------------- | ---------------------------------------------------------------------------------- | ------------- | ----------------------------------- |
| `RELAY_TIMEOUT`                 | Relay request timeout (seconds), 0 for unlimited                                   | `0`           | `RELAY_TIMEOUT=60`                  |
| `STREAMING_TIMEOUT`             | Streaming single response timeout (seconds)                                        | `300`         | `STREAMING_TIMEOUT=120`             |
| `RELAY_MAX_IDLE_CONNS`          | Maximum idle connections in relay HTTP client pool                                 | `500`         | `RELAY_MAX_IDLE_CONNS=1000`         |
| `RELAY_MAX_IDLE_CONNS_PER_HOST` | Maximum idle connections per host in relay HTTP client pool                        | `100`         | `RELAY_MAX_IDLE_CONNS_PER_HOST=200` |
| `MAX_FILE_DOWNLOAD_MB`          | Maximum file download size (MB)                                                    | `64`          | `MAX_FILE_DOWNLOAD_MB=128`          |
| `MAX_REQUEST_BODY_MB`           | Maximum request body size (MB, counted after decompression; prevents zip bomb/OOM) | `128`         | `MAX_REQUEST_BODY_MB=256`           |
| `STREAM_SCANNER_MAX_BUFFER_MB`  | SSE stream scanner maximum buffer size (MB)                                        | `64`          | `STREAM_SCANNER_MAX_BUFFER_MB=128`  |

<Callout type="warn" title="RELAY_TIMEOUT Setting Warning">
  Please be cautious when setting the `RELAY_TIMEOUT` environment variable. Setting it too short may lead to the following issues:
</Callout>

* Upstream API has completed the request and charged, but local billing failed due to timeout

* Leading to billing desynchronization, which may result in system losses

* It is recommended not to set it unless you know what you are doing

## Channel Management Configuration

| Environment Variable       | Description                                                     | Default Value                         | Example                         |
| -------------------------- | --------------------------------------------------------------- | ------------------------------------- | ------------------------------- |
| `CHANNEL_UPDATE_FREQUENCY` | Regularly update channel balance (minutes)                      | - (disabled if not set)               | `CHANNEL_UPDATE_FREQUENCY=1440` |
| `CHANNEL_TEST_FREQUENCY`   | Regularly check channels (minutes), overrides database settings | - (uses database settings if not set) | `CHANNEL_TEST_FREQUENCY=1440`   |
| `POLLING_INTERVAL`         | Request polling interval (seconds)                              | `0`                                   | `POLLING_INTERVAL=5`            |

### Channel Upstream Model Synchronization

| Environment Variable                                       | Description                                                    | Default Value | Example                                                        |
| ---------------------------------------------------------- | -------------------------------------------------------------- | ------------- | -------------------------------------------------------------- |
| `CHANNEL_UPSTREAM_MODEL_UPDATE_TASK_ENABLED`               | Enable regular synchronization of upstream provider model list | `true`        | `CHANNEL_UPSTREAM_MODEL_UPDATE_TASK_ENABLED=false`             |
| `CHANNEL_UPSTREAM_MODEL_UPDATE_TASK_INTERVAL_MINUTES`      | Model list synchronization interval (minutes)                  | `30`          | `CHANNEL_UPSTREAM_MODEL_UPDATE_TASK_INTERVAL_MINUTES=60`       |
| `CHANNEL_UPSTREAM_MODEL_UPDATE_MIN_CHECK_INTERVAL_SECONDS` | Minimum check interval per channel (seconds)                   | `300`         | `CHANNEL_UPSTREAM_MODEL_UPDATE_MIN_CHECK_INTERVAL_SECONDS=600` |

## Model and Request Processing Configuration

| Environment Variable         | Description                                                                               | Default Value | Example                           |
| ---------------------------- | ----------------------------------------------------------------------------------------- | ------------- | --------------------------------- |
| `FORCE_STREAM_OPTION`        | Override client stream\_options parameter, force retrieval of streaming usage information | `true`        | `FORCE_STREAM_OPTION=false`       |
| `CountToken`                 | Whether to enable local token counting                                                    | `true`        | `CountToken=false`                |
| `GET_MEDIA_TOKEN`            | Whether to count image/audio tokens in streaming mode                                     | `true`        | `GET_MEDIA_TOKEN=false`           |
| `GET_MEDIA_TOKEN_NOT_STREAM` | Whether to count image/audio tokens in non-streaming mode                                 | `false`       | `GET_MEDIA_TOKEN_NOT_STREAM=true` |

## Asynchronous Task Configuration

| Environment Variable   | Description                                                                                         | Default Value | Example                              |
| ---------------------- | --------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------ |
| `UPDATE_TASK`          | Whether to enable asynchronous task polling updates (MJ, Suno, etc.)                                | `true`        | `UPDATE_TASK=false`                  |
| `TASK_QUERY_LIMIT`     | Maximum number of tasks queried per poll                                                            | `1000`        | `TASK_QUERY_LIMIT=500`               |
| `TASK_TIMEOUT_MINUTES` | Asynchronous task timeout (minutes), marked as failed and refunded after timeout, 0 to disable      | `1440`        | `TASK_TIMEOUT_MINUTES=720`           |
| `TASK_PRICE_PATCH`     | Task price patch, specified models are billed per-use only, model names separated by English commas | -             | `TASK_PRICE_PATCH=sora-2,sora-2-pro` |

## Specific Model Configuration

| Environment Variable        | Description                                       | Default Value        | Example                                |
| --------------------------- | ------------------------------------------------- | -------------------- | -------------------------------------- |
| `AZURE_DEFAULT_API_VERSION` | Azure channel default API version                 | `2025-04-01-preview` | `AZURE_DEFAULT_API_VERSION=2023-05-15` |
| `COHERE_SAFETY_SETTING`     | Cohere model safety setting                       | `NONE`               | `COHERE_SAFETY_SETTING=CONTEXTUAL`     |
| `DIFY_DEBUG`                | Dify channel output workflow and node information | `true`               | `DIFY_DEBUG=false`                     |

## Subscription Cache Configuration

| Environment Variable               | Description                                      | Default Value | Example                                  |
| ---------------------------------- | ------------------------------------------------ | ------------- | ---------------------------------------- |
| `SUBSCRIPTION_PLAN_CACHE_TTL`      | Subscription plan cache TTL (seconds)            | `300`         | `SUBSCRIPTION_PLAN_CACHE_TTL=600`        |
| `SUBSCRIPTION_PLAN_INFO_CACHE_TTL` | Subscription plan details cache TTL (seconds)    | `120`         | `SUBSCRIPTION_PLAN_INFO_CACHE_TTL=300`   |
| `SUBSCRIPTION_PLAN_CACHE_CAP`      | Subscription plan cache maximum capacity         | `5000`        | `SUBSCRIPTION_PLAN_CACHE_CAP=10000`      |
| `SUBSCRIPTION_PLAN_INFO_CACHE_CAP` | Subscription plan details cache maximum capacity | `10000`       | `SUBSCRIPTION_PLAN_INFO_CACHE_CAP=20000` |

## Other Configuration

| Environment Variable | Description                                           | Default Value | Example                  |
| -------------------- | ----------------------------------------------------- | ------------- | ------------------------ |
| `ERROR_LOG_ENABLED`  | Whether to log and display error logs on the frontend | `false`       | `ERROR_LOG_ENABLED=true` |

## Analytics and Statistics

| Environment Variable  | Description                   | Default Value                          | Example                                                |
| --------------------- | ----------------------------- | -------------------------------------- | ------------------------------------------------------ |
| `UMAMI_WEBSITE_ID`    | Umami Website ID              | -                                      | `UMAMI_WEBSITE_ID=xxxx-xxxx`                           |
| `UMAMI_SCRIPT_URL`    | Umami Script URL              | `https://analytics.umami.is/script.js` | `UMAMI_SCRIPT_URL=https://umami.example.com/script.js` |
| `GOOGLE_ANALYTICS_ID` | Google Analytics 4 Website ID | -                                      | `GOOGLE_ANALYTICS_ID=G-XXXXXXX`                        |

## Metadata Synchronization

| Environment Variable        | Description                            | Default Value                            | Example                                                      |
| --------------------------- | -------------------------------------- | ---------------------------------------- | ------------------------------------------------------------ |
| `SYNC_UPSTREAM_BASE`        | Model/Vendor Metadata Upstream Address | `https://basellm.github.io/llm-metadata` | `SYNC_UPSTREAM_BASE=https://mirror.example.com/llm-metadata` |
| `SYNC_HTTP_TIMEOUT_SECONDS` | Sync HTTP Timeout (seconds)            | `10`                                     | `SYNC_HTTP_TIMEOUT_SECONDS=15`                               |
| `SYNC_HTTP_RETRY`           | Sync Retry Count                       | `3`                                      | `SYNC_HTTP_RETRY=5`                                          |
| `SYNC_HTTP_MAX_MB`          | Max Response Body Size (MB)            | `10`                                     | `SYNC_HTTP_MAX_MB=20`                                        |

## Frontend Configuration

| Environment Variable        | Description                                                        | Default Value | Example                                             |
| --------------------------- | ------------------------------------------------------------------ | ------------- | --------------------------------------------------- |
| `VITE_REACT_APP_SERVER_URL` | Frontend base URL for backend requests (effective at compile time) | -             | `VITE_REACT_APP_SERVER_URL=https://api.example.com` |

<Callout type="info" title="Compile-time Variables">
  `VITE_REACT_APP_SERVER_URL` is a frontend variable injected by Vite at compile time, only effective during frontend build, cannot be modified at runtime.
</Callout>

## Pyroscope Continuous Performance Analysis

| Environment Variable            | Description                                      | Default Value | Example                                |
| ------------------------------- | ------------------------------------------------ | ------------- | -------------------------------------- |
| `PYROSCOPE_URL`                 | Pyroscope server address, leave blank to disable | -             | `PYROSCOPE_URL=http://pyroscope:4040`  |
| `PYROSCOPE_APP_NAME`            | Application name for reporting                   | `new-api`     | `PYROSCOPE_APP_NAME=my-api`            |
| `PYROSCOPE_BASIC_AUTH_USER`     | Pyroscope Basic Auth username                    | -             | `PYROSCOPE_BASIC_AUTH_USER=admin`      |
| `PYROSCOPE_BASIC_AUTH_PASSWORD` | Pyroscope Basic Auth password                    | -             | `PYROSCOPE_BASIC_AUTH_PASSWORD=secret` |
| `HOSTNAME`                      | Hostname label for reporting                     | `new-api`     | `HOSTNAME=node-1`                      |
| `PYROSCOPE_MUTEX_RATE`          | Mutex profiling sample rate                      | `5`           | `PYROSCOPE_MUTEX_RATE=10`              |
| `PYROSCOPE_BLOCK_RATE`          | Block profiling sample rate                      | `5`           | `PYROSCOPE_BLOCK_RATE=10`              |

## LinuxDo OAuth

No modification is required under normal circumstances.

| Environment Variable      | Description            | Default Value                           | Example                                                         |
| ------------------------- | ---------------------- | --------------------------------------- | --------------------------------------------------------------- |
| `LINUX_DO_TOKEN_ENDPOINT` | LinuxDo Token Endpoint | `https://connect.linux.do/oauth2/token` | `LINUX_DO_TOKEN_ENDPOINT=https://connect.linux.do/oauth2/token` |
| `LINUX_DO_USER_ENDPOINT`  | LinuxDo User Endpoint  | `https://connect.linux.do/api/user`     | `LINUX_DO_USER_ENDPOINT=https://connect.linux.do/api/user`      |

## Debugging Related

| Environment Variable | Description                                     | Default Value | Example             |
| -------------------- | ----------------------------------------------- | ------------- | ------------------- |
| `DEBUG`              | Enable debug mode (including GORM debug output) | `false`       | `DEBUG=true`        |
| `GIN_MODE`           | Gin running mode                                | `release`     | `GIN_MODE=debug`    |
| `ENABLE_PPROF`       | Enable pprof performance analysis (port 8005)   | `false`       | `ENABLE_PPROF=true` |

## Deprecated Environment Variables

The following environment variables have been deprecated. Please use the corresponding options in the system settings interface:

| Environment Variable          | Alternative Method                                     |
| ----------------------------- | ------------------------------------------------------ |
| `GEMINI_MODEL_MAP`            | Please set in System Settings - Model Related Settings |
| `GEMINI_SAFETY_SETTING`       | Please set in System Settings - Model Related Settings |
| `GEMINI_VISION_MAX_IMAGE_NUM` | Please set in System Settings - Model Related Settings |

## Multi-machine Deployment Example

In multi-machine deployment scenarios, the following environment variables must be set:

### Master Node Configuration

```bash
# Database Configuration - Use a remote database
SQL_DSN=root:password@tcp(db-server:3306)/oneapi

# Security Configuration
SESSION_SECRET=your_unique_session_secret
CRYPTO_SECRET=your_unique_crypto_secret

# Redis Cache Configuration
REDIS_CONN_STRING=redis://default:password@redis-server:6379
```

### Slave Node Configuration

```bash
# Database Configuration - Use the same remote database
SQL_DSN=root:password@tcp(db-server:3306)/oneapi

# Security Configuration - Use the same secret as the master node
SESSION_SECRET=your_unique_session_secret
CRYPTO_SECRET=your_unique_crypto_secret

# Redis Cache Configuration - Use the same Redis as the master node
REDIS_CONN_STRING=redis://default:password@redis-server:6379

# Node Type Setting
NODE_TYPE=slave

# Optional: Frontend Base URL
# FRONTEND_BASE_URL=https://<your-newapi-domain>

# Optional: Synchronization Frequency
SYNC_FREQUENCY=60
```

<Callout type="info" title="Complete Cluster Configuration">
  This is just a basic multi-node configuration example. For complete cluster deployment configuration, architecture description, and best practices, please refer to the [Cluster Deployment Guide](/en/docs/installation/deployment-methods/cluster-deployment).
</Callout>

## Environment Variable Example in Docker Compose

Below is a brief example of setting environment variables in a Docker Compose configuration file:

```yaml
services:
  new-api:
    image: calciumion/new-api:latest
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=root:123456@tcp(mysql:3306)/oneapi
      - REDIS_CONN_STRING=redis://default:redispw@redis:6379
      - SESSION_SECRET=your_unique_session_secret
      - CRYPTO_SECRET=your_unique_crypto_secret
      - MEMORY_CACHE_ENABLED=true
      - GENERATE_DEFAULT_TOKEN=true
      - STREAMING_TIMEOUT=120
      - CHANNEL_UPDATE_FREQUENCY=1440
```

For a complete Docker Compose configuration, including more environment variable setting options, please refer to the [Docker Compose Configuration Instructions](/en/docs/installation/config-maintenance/docker-compose-yml) document.


# System Update Guide

This document provides methods and best practices for updating the New API system to ensure a smooth upgrade to the latest version.

## Pre-update Preparations

Before updating the system, it is recommended to perform the following preparations:

1. **Back up data**: Back up your database and important configuration files
2. **Check update logs**: Review the update content for the latest version on [GitHub Releases](https://github.com/Calcium-Ion/new-api/releases)
3. **Check compatibility**: Confirm whether the new version is compatible with your existing plugins, integrations, or custom configurations
4. **Choose an appropriate time**: Perform the update during off-peak hours to minimize impact on users

## Docker Deployment Update Methods

### Method One: Single Container Deployment Update

If you have deployed New API using a single Docker container, you can update by following these steps:

```shell
# 拉取最新镜像
docker pull calciumion/new-api:latest

# 停止并移除旧容器
docker stop new-api
docker rm new-api

# 使用相同的参数重新运行容器
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
```

<Callout type="warn" title="Please Note">
  Please ensure that you use the same parameters as the original container when
  starting the new container, especially for data volume mounts and environment
  variable configurations.
</Callout>

### Method Two: Update using Docker Compose

If you are deploying using Docker Compose (see [Docker Compose Configuration Instructions](/en/docs/installation/config-maintenance/docker-compose-yml)), the update process is simpler:

```shell
# 进入项目目录
cd new-api

# 拉取最新镜像
docker compose pull

# 停止并重启服务
docker compose down
docker compose up -d
```

Or use a more concise command:

```shell
docker compose pull && docker compose down && docker compose up -d
```

### Method Three: Update using 1Panel Panel

If you are deploying using the 1Panel panel, you can update by following these steps:

1. Log in to the 1Panel panel, go to **App Store** -> **Upgradable Page**
2. Find the New API application and click the **Upgrade** button
3. Select the **Target version to upgrade to**
4. Click the **Confirm** button, and the system will automatically pull the latest image to upgrade the application

### Method Four: Update using Baota Panel

If you are deploying using the Baota Panel, you can update by following these steps:

1. Log in to the Baota Panel, go to **Docker Management** -> **Container List**
2. Find the New API container, click **More** -> **Recreate**
3. Check the **Pull latest image** option, ensuring other configurations remain unchanged
4. Click **Submit**, and the system will automatically pull the latest image and recreate the container

## Update Method from Source Code Compilation

If you have deployed New API by compiling from source code, the update steps are as follows:

```shell
# 进入项目目录
cd new-api

# 拉取最新代码
git pull

# 编译后端
go build -o new-api

# 更新并编译前端
cd web
bun install
bun run build
cd ..

# 重启服务
./new-api --port 3000
```

## Multi-node Deployment Update Strategy

For multi-node deployment environments, the following update strategy is recommended:

1. **Update secondary nodes first**: First update one secondary node and test its stability
2. **Gradual rollout**: After confirming the stability of the secondary node, update the remaining secondary nodes one by one
3. **Finally update the primary node**: After all secondary nodes are running stably, update the primary node

This strategy can minimize the risk of service interruption.

<Callout title="Detailed Guide">
  For a complete guide on cluster deployment, please refer to the [Cluster
  Deployment
  Documentation](/en/docs/installation/deployment-methods/cluster-deployment).
</Callout>

## Post-update Checklist

After the system update, please check the following items to ensure the system is running correctly:

1. **Access management interface**: Confirm that you can log in and access the management interface normally
2. **Check logs**: Review system logs for errors or warnings
3. **Test API calls**: Test some API calls to ensure functionality is normal
4. **Check database migration**: Confirm whether the database structure update was successful
5. **Check channel status**: Confirm whether all channel connections are normal

## Version Rollback

If issues arise after an update, you can roll back to a previous stable version:

### Docker Rollback

```shell
# 拉取特定版本的镜像
docker pull calciumion/new-api:v1.x.x

# 停止并移除当前容器
docker stop new-api
docker rm new-api

# 使用旧版本镜像重新创建容器
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:v1.x.x
```

### Source Code Rollback

```shell
# 进入项目目录
cd new-api

# 切换到特定版本
git checkout v1.x.x

# 重新编译
go build -o new-api

# 更新并编译前端
cd web
bun install
bun run build
cd ..

# 重启服务
./new-api --port 3000
```

## Common Issues

### Service Fails to Start After Update

* Check logs for error messages
* Confirm database connection is normal
* Confirm environment variable configuration is correct

### Abnormal Functionality After Update

* Check for any API format changes
* Check if frontend and backend versions match
* Confirm if the new version requires additional configuration

### Database Structure Incompatibility

* Check update logs for database migration instructions
* Check if manual execution of database migration scripts is required
* Contact developers for database upgrade guidance

## Automatic Update Tools (Use with Caution)

For users who wish to automate updates, Watchtower can be used to automatically update containers:

```shell
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower -c \
  --run-once new-api
```

<Callout type="warn" title="Please Note">
  Automatic updates may lead to unexpected issues, especially when database
  structures change. It is recommended to use automatic updates only in testing
  environments; production environments should control the update process
  manually.
</Callout>


# 1Panel Panel Deployment











This document provides a graphical tutorial for deploying New API using the 1Panel panel.

## Prerequisites

| Item                 | Requirement                        |
| -------------------- | ---------------------------------- |
| 1Panel Panel         | Latest stable version              |
| Recommended OS       | Linux (Ubuntu/CentOS/Debian, etc.) |
| Server Configuration | At least 1 core and 2GB RAM        |

## Step 1: Install 1Panel Panel

<Callout type="info" title="Install 1Panel Panel">
  For information on 1Panel installation, deployment, and basic features, please refer to the [1Panel Official Documentation](https://1panel.cn/docs/)

  After completing the 1Panel installation and deployment, open your browser to the prompted URL to access the 1Panel panel.
</Callout>

<img alt="1panel" src={__img0} placeholder="blur" />

## Step 2: Install New API

### Search for Applications

<Callout type="info" title="Search for Applications">
  Go to the application list in the App Store, find the New API application under the \[AI] category, and install it.
</Callout>

<img alt="1panel-newapi" src={__img1} placeholder="blur" />

### Configure Parameters

<Callout type="info" title="Install Application">
  Configure New API application parameters on the installation page:
</Callout>

* **Name**: The name of the New API application to be created
* **Version**: Select the version of New API
* **Port**: The service port for the New API application
* **Timezone**: Enter the timezone where the server is located (default Asia/Shanghai)
* **Advanced Settings**: Be sure to check external port access

<img alt="newapi-setting" src={__img2} placeholder="blur" />

### Confirm Installation

<Callout type="info" title="Confirm Installation">
  Click Confirm to start the installation. The page will automatically redirect to the installed applications list. Wait for the New API application status to change to Started.
</Callout>

<img alt="newapi-start" src={__img3} placeholder="blur" />

## Step 3: Configure Environment Variables (Important)

After installation, it is recommended to configure the following key environment variables:

### Required Environment Variables

| Variable         | Description                                                  | Required     |
| ---------------- | ------------------------------------------------------------ | ------------ |
| `SESSION_SECRET` | Session secret, must be consistent for multi-node deployment | **Required** |
| `CRYPTO_SECRET`  | Encryption secret, required when using Redis                 | Conditional  |

### Configuration Method

1. In the 1Panel application list, click the **Parameters** button for the New API application
2. Add in the environment variables section:
   * `SESSION_SECRET=your_random_secret_key`
   * `CRYPTO_SECRET=your_crypto_secret_key` (optional)
3. Click **Confirm** to save the configuration
4. Restart the application for the configuration to take effect

### Generate Random Secrets

```bash
# Generate SESSION_SECRET
openssl rand -hex 16

# Or use Linux command
head -c 16 /dev/urandom | xxd -p
```

## Step 4: Access New API

<Callout type="info" title="Access Application">
  * On the `Installed` page, click `Jump` to enter the New API WebUI page
  * Before use, it is recommended to set the `Default Access Address` on the `Panel Settings` page
</Callout>

<img alt="newapi-visit" src={__img4} placeholder="blur" />

The first visit will automatically guide you to the initialization page. Follow the on-screen instructions to set up an administrator account and password.

## Common Issues

### Cannot access application interface

1. Check if the application status is "Started"
2. Confirm that the port is correctly mapped and open
3. Check the server firewall and cloud server security group

### Session invalid after login

Ensure the `SESSION_SECRET` environment variable is set and not empty.

### How to update version

1. Log in to 1Panel panel, go to **App Store** → **Upgradable page**
2. Find the New API application, click the **Upgrade** button
3. Select the target version, click **Confirm**

### How to persist data

1Panel applications store data in Docker volumes by default. To customize storage location:

1. In the application parameter settings, configure directory mapping
2. Ensure the `/data` directory is mapped to persistent storage

## Related Links

* [Environment Variables Configuration](/docs/installation/config-maintenance/environment-variables)
* [Docker Compose Deployment](/docs/installation/deployment-methods/docker-compose-installation)
* [FAQ](/docs/support/faq)
* [GitHub Repository](https://github.com/QuantumNous/new-api)


# Deploying with Baota Panel

This document provides a graphical tutorial for deploying New API using the Baota Panel Docker feature.

## Prerequisites

| Item                 | Requirement                          |
| -------------------- | ------------------------------------ |
| Baota Panel          | Version 9.2.0 or higher              |
| Recommended OS       | CentOS 7+, Ubuntu 18.04+, Debian 10+ |
| Server Configuration | At least 1 core and 2GB RAM          |

## Step 1: Install Baota Panel

1. Go to the [Baota Panel Official Website](https://www.bt.cn/new/download.html) to download the installation script suitable for your system
2. Run the installation script to install Baota Panel
3. After installation, use the provided address, username, and password to log in to Baota Panel

## Step 2: Install Docker

1. After logging in to Baota Panel, find and click **Docker** in the left sidebar
2. The first time you enter, you will be prompted to install the Docker service. Click **Install Now**
3. Follow the prompts to complete the Docker service installation

## Step 3: Install New API

### Method One: Using Baota App Store (Recommended)

1. In the Baota Panel Docker feature, click **App Store**
2. Search for and find **New-API**
3. Click **Install**
4. Configure the following basic options:
   * **Container Name**: Customizable, defaults to `new-api`
   * **Port Mapping**: Defaults to `3000:3000`
   * **Environment Variables**:
     * `SESSION_SECRET`: Session secret (**Required**, must be consistent for multi-node deployment)
     * `CRYPTO_SECRET`: Encryption secret (Required when using Redis)
   * **Directory Mapping**: Ensure the `/data` directory is mapped to a host directory
5. Click **Confirm** to start installation
6. After installation completes, access `http://your-server-ip:3000`

### Method Two: Using Docker Compose

Suitable for scenarios requiring more custom configuration.

1. Create a website directory in Baota Panel, such as `/www/wwwroot/new-api`
2. Create a `docker-compose.yml` file:

```yaml
version: '3'
services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - SESSION_SECRET=your_session_secret_here  # Replace with random string
      - TZ=Asia/Shanghai
```

3. Enter the directory via SSH terminal and start:

```bash
cd /www/wwwroot/new-api
docker-compose up -d
```

### Method Three: Using Custom Image

<Callout type="warn" title="Advanced Usage">
  It is strongly recommended to install via "App Store". This section is for advanced users familiar with Docker.
</Callout>

1. In the Baota Panel Docker feature, click **Image Management**
2. Click **Get Image** → **Pull Image**
3. Enter Image Name: `calciumion/new-api:latest`
4. Click **Submit** and wait for the image pull to complete
5. After the pull is complete, go to **Container List** and click **Create Container**
6. Fill in the following information:
   * **Container Name**: `new-api` (customizable)
   * **Image**: Select the `calciumion/new-api:latest` image you just pulled
   * **Port Mapping**: Add `3000:3000`
   * **Directory Mapping**: Add `/your/host/path:/data` (replace with your host path)
   * **Environment Variables**: Add as needed
7. Click **Submit** to complete the installation

## Environment Variables

### Required Environment Variables

| Variable            | Description                                                  | Required     |
| ------------------- | ------------------------------------------------------------ | ------------ |
| `SESSION_SECRET`    | Session secret, must be consistent for multi-node deployment | **Required** |
| `CRYPTO_SECRET`     | Encryption secret, required when using Redis                 | Conditional  |
| `SQL_DSN`           | Database connection string (when using external database)    | Optional     |
| `REDIS_CONN_STRING` | Redis connection string                                      | Optional     |

### Generate Random Secrets

```bash
# Generate SESSION_SECRET
openssl rand -hex 16

# Or use Linux command
head -c 16 /dev/urandom | xxd -p
```

## Access and Initialization

After installation, access `http://server-ip:3000`

The first visit will automatically guide you to the initialization page. Follow the on-screen instructions to set up an administrator account and password.

## Common Issues

### Cannot access port 3000

1. Check if the server firewall allows port 3000
2. In Baota Panel **Security**, allow port 3000
3. Check if the cloud server security group allows the port

### Session invalid after login

Ensure the `SESSION_SECRET` environment variable is set and not empty.

### How to persist data

Use Docker volume mapping for the data directory:

```yaml
volumes:
  - ./data:/data
```

### How to update version

```bash
# Pull latest image
docker pull calciumion/new-api:latest

# Restart with Docker Compose
docker-compose down && docker-compose up -d

# Or restart container via Baota container management
```

## Related Links

* [Environment Variables Configuration](/docs/installation/config-maintenance/environment-variables)
* [Docker Compose Deployment](/docs/installation/deployment-methods/docker-compose-installation)
* [FAQ](/docs/support/faq)
* [GitHub Repository](https://github.com/QuantumNous/new-api)


# Cluster Deployment



This document provides detailed configuration steps and best practices for New API cluster deployment, helping you build a highly available, load-balanced distributed system.

## Prerequisites

* Multiple servers (at least two, master-slave architecture)
* Docker and Docker Compose installed
* Shared MySQL database (master and slave nodes must access the same database)
* Shared Redis service (for inter-node data synchronization and caching)
* Optional: Load balancer (e.g., Nginx, HAProxy, or cloud provider's load balancing service)

## Cluster Architecture Overview

The New API cluster adopts a master-slave architecture design:

1. **Master Node**: Responsible for handling all write operations and some read operations
2. **Slave Nodes**: Primarily responsible for handling read operations, improving overall system throughput

<img alt="集群架构" src={__img0} />

## Key Cluster Deployment Configurations

The key to cluster deployment is that all nodes must:

1. **Share the same database**: All nodes access the same MySQL database
2. **Share the same Redis**: Used for caching and inter-node communication
3. **Use the same keys**: `SESSION_SECRET` and `CRYPTO_SECRET` must be identical across all nodes
4. **Correctly configure node type**: Master node as `master`, slave nodes as `slave`

## Deployment Steps

### Step One: Prepare Shared Database and Redis

First, you need to prepare shared MySQL database and Redis services. This can be:

* Separately deployed highly available MySQL and Redis services
* Managed database and caching services provided by cloud providers
* MySQL and Redis running on independent servers

For MySQL databases, you can choose from the following architectural solutions:

| Architecture Type                         | Component Composition                                        | How it Works                                                                                     | Application Configuration Method           |
| :---------------------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------------------------------------------- | :----------------------------------------- |
| **Master-Slave Replication Architecture** | 1 Master<br />N Slaves                                       | Master handles writes<br />Slaves handle reads<br />Master-slave data automatically synchronized | Configure master address as `SQL_DSN`      |
| **Database Cluster Architecture**         | Multiple peer nodes<br />Proxy layer (ProxySQL/MySQL Router) | All nodes can read/write<br />Load balancing via proxy layer<br />Automatic failover             | Configure proxy layer address as `SQL_DSN` |

<Callout type="warn" title="Important Note">
  Regardless of the chosen architecture, the application's `SQL_DSN`
  configuration only requires a unified entry address.
</Callout>

Ensure these services are accessible by all nodes and have sufficient performance and reliability.

### Step Two: Configure Master Node

Create a `docker-compose.yml` file on the master node server:

```yaml
services:
  new-api-master:
    image: calciumion/new-api:latest
    container_name: new-api-master
    restart: always
    ports:
      - '3000:3000'
    environment:
      - SQL_DSN=root:password@tcp(your-db-host:3306)/new-api
      - REDIS_CONN_STRING=redis://default:password@your-redis-host:6379
      - SESSION_SECRET=your_unique_session_secret
      - CRYPTO_SECRET=your_unique_crypto_secret
      - TZ=Asia/Shanghai
      # 以下是可选配置
      - SYNC_FREQUENCY=60 # 同步频率，单位秒
      # - FRONTEND_BASE_URL=https://<your-newapi-domain> # 前端基础 URL，用于邮件通知等功能
    volumes:
      - ./data:/data
      - ./logs:/app/logs
```

<Callout type="warn" title="Security Tip">
  Please replace the example values in the above configuration with strong
  passwords and randomly generated key strings.
</Callout>

Start the master node:

```bash
docker compose up -d
```

### Step Three: Configure Slave Nodes

Create a `docker-compose.yml` file on each slave node server:

```yaml
services:
  new-api-slave:
    image: calciumion/new-api:latest
    container_name: new-api-slave
    restart: always
    ports:
      - '3000:3000' # 可以与主节点使用相同端口，因为它们在不同服务器上
    environment:
      - SQL_DSN=root:password@tcp(your-db-host:3306)/new-api # 与主节点相同
      - REDIS_CONN_STRING=redis://default:password@your-redis-host:6379 # 与主节点相同
      - SESSION_SECRET=your_unique_session_secret # 必须与主节点相同
      - CRYPTO_SECRET=your_unique_crypto_secret # 必须与主节点相同
      - NODE_TYPE=slave # 关键配置，指定为从节点
      - SYNC_FREQUENCY=60 # 从节点与主节点同步频率，单位秒
      - TZ=Asia/Shanghai
      # 以下是可选配置
      # - FRONTEND_BASE_URL=https://<your-newapi-domain> # 需与主节点相同
    volumes:
      - ./data:/data
      - ./logs:/app/logs
```

Start the slave node:

```bash
docker compose up -d
```

Repeat this step for each slave node server.

### Step Four: Configure Load Balancer

To achieve balanced traffic distribution, you need to set up a load balancer. Below is a configuration example using Nginx as a load balancer:

```nginx
upstream new_api_cluster {
    server master-node-ip:3000 weight=3;
    server slave-node1-ip:3000 weight=5;
    server slave-node2-ip:3000 weight=5;
    # 可添加更多从节点
}

server {
    listen 80;
    server_name <your-newapi-domain>;

    location / {
        proxy_pass http://new_api_cluster;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

This configuration sets the master node weight to 3 and slave node weights to 5, meaning slave nodes will handle more requests. You can adjust these weights according to your actual needs.

## Advanced Configuration Options

### Data Synchronization Settings

Data synchronization between cluster nodes depends on the following environment variables:

| Environment Variable    | Description                              | Recommended Value |
| :---------------------- | :--------------------------------------- | :---------------- |
| `SYNC_FREQUENCY`        | Node synchronization frequency (seconds) | `60`              |
| `BATCH_UPDATE_ENABLED`  | Enable batch updates                     | `true`            |
| `BATCH_UPDATE_INTERVAL` | Batch update interval (seconds)          | `5`               |

### Redis High Availability Configuration

To improve Redis availability, you can configure Redis Cluster or Sentinel mode:

```yaml
environment:
  - REDIS_CONN_STRING=redis://your-redis-host:6379
  - REDIS_PASSWORD=your_redis_password
  - REDIS_MASTER_NAME=mymaster # 哨兵模式下的主节点名称
  - REDIS_CONN_POOL_SIZE=10 # Redis 连接池大小
```

### Session Security Configuration

Ensure all nodes in the cluster use the same session and encryption keys:

```yaml
environment:
  - SESSION_SECRET=your_unique_session_secret # 所有节点必须相同
  - CRYPTO_SECRET=your_unique_crypto_secret # 所有节点必须相同
```

## Monitoring and Maintenance

### Health Checks

Configure regular health checks to monitor node status:

```yaml
healthcheck:
  test:
    [
      'CMD-SHELL',
      "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' | awk -F: '{print $$2}'",
    ]
  interval: 30s
  timeout: 10s
  retries: 3
```

### Log Management

For large-scale clusters, a centralized log management system is recommended:

```yaml
environment:
  - LOG_SQL_DSN=root:password@tcp(log-db-host:3306)/new_api_logs # 独立的日志数据库
```

## Scaling Guide

As your business grows, you may need to expand your cluster size. The scaling steps are as follows:

1. **Prepare new servers**: Install Docker and Docker Compose
2. **Configure slave nodes**: Configure new slave nodes according to the instructions in "Step Three: Configure Slave Nodes"
3. **Update load balancer configuration**: Add the new nodes to the load balancer configuration
4. **Test new nodes**: Ensure the new nodes are working correctly and participating in load balancing

## Best Practices

1. **Regularly back up the database**: Even in a cluster environment, the database should be backed up regularly
2. **Monitor resource usage**: Closely monitor CPU, memory, and disk usage
3. **Adopt a rolling update strategy**: When updating, update slave nodes first, and then update the master node after confirming stability
4. **Configure an alerting system**: Monitor node status and promptly notify administrators when issues occur
5. **Geographically distributed deployment**: If possible, deploy nodes in different geographical locations to improve availability

## Troubleshooting

### Nodes unable to synchronize data

* Check if Redis connection is normal
* Confirm that SESSION\_SECRET and CRYPTO\_SECRET are identical across all nodes
* Verify that the database connection configuration is correct

### Load Imbalance

* Check load balancer configuration and weight settings
* Monitor resource usage of each node to ensure no node is overloaded
* May need to adjust node weights or add more nodes

### Session Loss Issues

* Ensure all nodes use the same SESSION\_SECRET
* Verify that Redis is configured correctly and accessible
* Check if the client is handling cookies correctly

## Related Documentation

* [Environment Variable Configuration Guide](/en/docs/installation/config-maintenance/environment-variables) - Contains all relevant environment variables for multi-node deployment
* [System Update Guide](/en/docs/installation/config-maintenance/system-update) - System update strategy in a multi-node environment
* [Docker Compose Configuration Instructions](/en/docs/installation/config-maintenance/docker-compose-yml) - Used for writing cluster node configuration files


# Docker Compose Deployment

This document provides detailed steps for deploying New API using Docker Compose.

## Prerequisites

* Docker and Docker Compose installed
* Recommended OS: Linux (Ubuntu/CentOS/Debian, etc.)

## Deploy with Docker Compose

### Method One: Clone the Project with Git (Recommended)

If you have normal access to GitHub, this method is recommended. The project already includes a complete `docker-compose.yml` configuration file:

```shell
# Download project source code
git clone https://github.com/QuantumNous/new-api.git

# Enter project directory
cd new-api

# Edit docker-compose.yml file as needed
# Use nano editor
nano docker-compose.yml
# Or use vim editor
# vim docker-compose.yml
```

<Callout type="info" title="Tip">
  The `docker-compose.yml` file included with the project has already configured
  all necessary services (including MySQL and Redis). You only need to modify
  parameters such as ports and passwords according to your actual situation to
  use it.
</Callout>

### Method Two: Manually Create Configuration File

If you cannot access GitHub or clone the repository, you can manually create the configuration file:

1. Create a directory for New API deployment:

```shell
mkdir new-api
cd new-api
```

2. Create the `docker-compose.yml` file in this directory

   You can refer to the configuration examples in the [Docker Compose Configuration Guide](/en/docs/installation/config-maintenance/docker-compose-yml) document and choose according to your needs:

   * For production environments, a complete configuration (including MySQL and Redis) is recommended.
   * For testing environments, a simplified configuration can be used.

3. Use a text editor to create the file:

```shell
# Use nano editor
nano docker-compose.yml

# Or use vim editor
vim docker-compose.yml
```

Copy the selected configuration content into this file and customize it as needed.

## Start Services

Once the configuration file is ready, whether you cloned it with Git or created it manually, you can use the following command to start the services:

```shell
# Start services using Docker Compose
docker compose up -d
```

This command will automatically pull the required images and start the services in the background.

## View Logs

* **Real-time logs for all services**

```bash
docker compose logs -f
```

* **Logs for a specific service** (Examples: `new-api`, `mysql`, `redis`)

```bash
docker compose logs -f new-api
docker compose logs -f mysql
docker compose logs -f redis
```

* **View only the last N lines**

```bash
docker compose logs --tail=100 new-api
```

* **View logs from a recent period**

```bash
docker compose logs --since=10m new-api
```

* **Show timestamps**

```bash
docker compose logs -f -t new-api
```

* **Foreground mode debugging (real-time log output with startup)**

```bash
docker compose up
# Or only start and follow a specific service
docker compose up new-api
```

Press Ctrl+C to exit foreground mode (this will stop the corresponding service). For background operation, use `-d`.

* **View service list/status**

```bash
docker compose ps
```

* **View logs using container name** (when `container_name` is set, e.g., `new-api` in the configuration)

```bash
docker logs -f new-api
```

## Stop Services

```shell
# Stop services
docker compose down
```

## Access the System

After the services start successfully, accessing `http://Server_IP:3000` will automatically redirect to the initialization page. Follow the on-screen instructions to manually set up the administrator account and password (only required for the first installation). After initialization, you can log in to the system using the administrator account you set.


# Docker Deployment

This document provides detailed steps for deploying New API using Docker.

<Callout type="warn" title="Highly Recommended">
  We highly recommend using the [Docker Compose installation
  method](/en/docs/installation/deployment-methods/docker-compose-installation)
  instead of manually starting Docker containers. The Docker Compose method
  offers better configuration management, service orchestration, and deployment
  experience.
</Callout>

## Basic Requirements

* Docker environment installed
* Port: Default port 3000 is used

## Deploy Directly Using Docker Image

### Using SQLite Database (Not Recommended)

```shell
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
```

<Callout type="warn" title="Note">
  Please replace `/your/data/path` with your desired local path for data
  storage.
</Callout>

### Using MySQL Database

```shell
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="用户名:密码@tcp(数据库地址:3306)/数据库名" \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
```

<Callout type="warn" title="Note">
  Please replace the database connection information in the parameters.
</Callout>

## Accessing the System

After deployment, accessing `http://Server_IP:3000` will automatically redirect you to the initialization page. Follow the on-screen instructions to manually set up the administrator account and password (only required for the first installation), and upon completion, you can log in to the system with the newly set administrator account.


# Local Development and Deployment

This document provides detailed steps for setting up and developing the New API project in a local environment, suitable for developers who wish to contribute to the project or perform custom development.

## Development Environment Requirements

Before starting local development, please ensure that the following software is installed on your system:

* **Go** 1.21 or higher (for backend development)
* **Node.js** 18 or higher (for frontend development)
* **Bun** latest version (recommended package manager, 25x faster than npm/yarn)
* **Git** (for version control)
* **MySQL** (optional, SQLite is used by default)
* **Redis** (optional, for performance enhancement)
* **Visual Studio Code** or other code editor

<Callout type="info" title="About Bun">
  Bun is an incredibly fast JavaScript package manager, test runner, and
  bundler. Compared to traditional npm or yarn, Bun installs packages 25 times
  faster and is the most recommended JavaScript package management tool for
  2024\.
</Callout>

## Clone Project

First, clone the New API repository from GitHub to your local machine:

```bash
git clone https://github.com/Calcium-Ion/new-api.git
cd new-api
```

## Backend Development Setup

### Install Go Dependencies

```bash
go mod download
```

### Configure Development Environment

New API supports configuring environment variables via a `.env` file. Create a `.env` file (you can copy from `.env.example`):

```bash
cp .env.example .env
```

Edit the `.env` file and modify the configuration as needed. The following are common configurations for the development environment:

```bash
PORT=3000
SQL_DSN=root:password@tcp(localhost:3306)/new-api   # If using MySQL, uncomment and modify
# REDIS_CONN_STRING=redis://localhost:6379         # If using Redis, uncomment and modify
```

<Callout type="info" title="Hint">
  If `SQL_DSN` is not configured, the system will default to using an SQLite
  database, stored in the `one-api.db` file.
</Callout>

### Run Backend Service

```bash
# Run directly
go run main.go

# Or compile and run
go build -o new-api
./new-api
```

The service runs on `http://localhost:3000` by default.

## Frontend Development Setup

The frontend code for New API is located in the `web` directory and is developed using React and the [semi design component library](https://semi.design/zh-CN).

### Install Bun (Recommended)

If you haven't installed Bun yet, please use the following commands to install it:

**macOS/Linux:**

```bash
curl -fsSL https://bun.sh/install | bash
```

**Windows (using WSL):**

```bash
curl -fsSL https://bun.sh/install | bash
```

**macOS (using Homebrew):**

```bash
brew tap oven-sh/bun
brew install bun
```

After installation, restart your terminal or run `source ~/.bashrc` (or `~/.zshrc`) to make the Bun command available.

### Install Frontend Dependencies

```bash
cd web
bun install   # Install frontend dependencies using bun
```

### Run Development Server

```bash
bun run dev   # Run development server using bun
```

The frontend development server runs on `http://localhost:5173` by default and is configured with a proxy that forwards API requests to the backend service.

### Build Frontend Assets

```bash
bun run build   # Build frontend assets using bun
```

The built files will be generated into the `web/dist` directory, and the backend service will automatically load these static assets.

7. **Create a Pull Request**: Create a PR on GitHub, describing your changes.

## Debugging Tips

### Backend Debugging

1. **View Logs**:

   ```bash
   go run main.go --log-dir ./logs
   ```

2. **Debug with Delve**:
   ```bash
   go install github.com/go-delve/delve/cmd/dlv@latest
   dlv debug main.go
   ```

### Frontend Debugging

1. **Use Chrome DevTools**:
   * Open Chrome Developer Tools (F12)
   * Check the Console and Network tabs

2. **React Developer Tools**:
   * Install the React Developer Tools extension in Chrome
   * Use it to inspect component structure and state

## Project Structure

The directory structure of the New API project:

```
new-api/                                 # Project root directory
│  .dockerignore                         # Files to ignore during Docker build configuration
│  .env.example                          # Example environment variables file
│  .gitignore                            # Git ignore file configuration
│  BT.md                                 # BT (possibly Baota panel) related documentation
│  docker-compose.yml                    # Docker Compose configuration file for container orchestration
│  Dockerfile                            # Docker image build configuration
│  go.mod                                # Go module dependency configuration file
│  go.sum                                # Go module dependency checksum file
│  LICENSE                               # Project license file
│  main.go                               # Project main entry file
│  makefile                              # Project build script
│  Midjourney.md                         # Midjourney service related documentation
│  one-api.service                       # systemd service configuration file
│  README.en.md                          # English version project README
│  README.md                             # Chinese version project README
│  Rerank.md                             # Rerank feature related documentation
│  Suno.md                               # Suno API related documentation
│  VERSION                               # Project version information file
│
├─.github                                # GitHub related configuration directory
│  │  FUNDING.yml                        # GitHub funding configuration file
│  │
│  ├─ISSUE_TEMPLATE                      # GitHub Issue template directory
│  │      bug_report.md                  # Bug report template
│  │      config.yml                     # Issue configuration file
│  │      feature_request.md             # Feature request template
│  │
│  └─workflows                           # GitHub Actions workflow configuration directory
│          docker-image-amd64.yml        # AMD64 architecture Docker image build workflow
│          docker-image-arm64.yml        # ARM64 architecture Docker image build workflow
│          linux-release.yml             # Linux platform release workflow
│          macos-release.yml             # macOS platform release workflow
│          windows-release.yml           # Windows platform release workflow
│
├─bin                                    # Binary files and scripts directory
│      migration_v0.2-v0.3.sql           # Database v0.2 to v0.3 migration script
│      migration_v0.3 to v0.4.sql        # Database v0.3 to v0.4 migration script
│      time_test.sh                      # Time test script
│
├─common                                 # Common functional modules directory
│      constants.go                      # Common constants definition
│      crypto.go                         # Cryptography related functions
│      custom-event.go                   # Custom event handling
│      database.go                       # Database connection and operations
│      email-outlook-auth.go             # Outlook email authentication
│      email.go                          # Email functions
│      embed-file-system.go              # Embedded file system
│      env.go                            # Environment variable handling
│      gin.go                            # Gin framework related functions
│      go-channel.go                     # Go channel management
│      gopool.go                         # Go goroutine pool
│      init.go                           # Initialization functions
│      logger.go                         # Logging functions
│      pprof.go                          # Performance profiling tools
│      rate-limit.go                     # Rate limiting functions
│      redis.go                          # Redis client
│      str.go                            # String utility functions
│      topup-ratio.go                    # Top-up ratio calculation
│      utils.go                          # General utility functions
│      validate.go                       # Data validation functions
│      verification.go                   # Verification code related functions
│
├─constant                               # Constants definition directory
│      cache_key.go                      # Cache key constants
│      channel_setting.go                # Channel settings constants
│      context_key.go                    # Context key constants
│      env.go                            # Environment variable constants
│      finish_reason.go                  # Finish reason constants
│      midjourney.go                     # Midjourney related constants
│      task.go                           # Task related constants
│      user_setting.go                   # User settings constants
│
├─controller                             # Controller layer, handles HTTP requests
│      billing.go                        # Billing controller
│      channel-billing.go                # Channel billing controller
│      channel-test.go                   # Channel test controller
│      channel.go                        # Channel management controller
│      github.go                         # GitHub related controller
│      group.go                          # User group controller
│      linuxdo.go                        # LinuxDo related controller
│      log.go                            # Log controller
│      midjourney.go                     # Midjourney service controller
│      misc.go                           # Miscellaneous functions controller
│      model.go                          # Model management controller
│      oidc.go                           # OpenID Connect authentication controller
│      option.go                         # Option settings controller
│      playground.go                     # Playground controller
│      pricing.go                        # Pricing management controller
│      redemption.go                     # Redemption code controller
│      relay.go                          # Request forwarding controller
│      task.go                           # Task management controller
│      telegram.go                       # Telegram related controller
│      token.go                          # Token management controller
│      topup.go                          # Top-up controller
│      usedata.go                        # User data controller
│      user.go                           # User management controller
│      wechat.go                         # WeChat related controller
│
├─docs                                   # Documentation directory
│  ├─api                                 # API documentation
│  │      api_auth.md                    # API authentication documentation
│  │      user.md                        # User related API documentation
│  │
│  └─channel                             # Channel documentation
│          other_setting.md              # Other settings documentation
│
├─dto                                    # Data Transfer Object directory
│      audio.go                          # Audio related DTO
│      dalle.go                          # DALL-E related DTO
│      embedding.go                      # Embedding related DTO
│      error.go                          # Error response DTO
│      file_data.go                      # File data DTO
│      midjourney.go                     # Midjourney related DTO
│      notify.go                         # Notification related DTO
│      openai_request.go                 # OpenAI request DTO
│      openai_response.go                # OpenAI response DTO
│      playground.go                     # Playground DTO
│      pricing.go                        # Pricing related DTO
│      realtime.go                       # Realtime data DTO
│      rerank.go                         # Rerank related DTO
│      sensitive.go                      # Sensitive content related DTO
│      suno.go                           # Suno related DTO
│      task.go                           # Task related DTO
│
├─middleware                             # Middleware directory
│      auth.go                           # Authentication middleware
│      cache.go                          # Cache middleware
│      cors.go                           # Cross-Origin Resource Sharing middleware
│      distributor.go                    # Request distributor middleware
│      gzip.go                           # Gzip compression middleware
│      logger.go                         # Logging middleware
│      model-rate-limit.go               # Model-level rate limit middleware
│      rate-limit.go                     # General rate limit middleware
│      recover.go                        # Exception recovery middleware
│      request-id.go                     # Request ID middleware
│      turnstile-check.go                # Cloudflare Turnstile check middleware
│      utils.go                          # Middleware utility functions
│
├─model                                  # Data model directory
│      ability.go                        # Ability model
│      cache.go                          # Cache model
│      channel.go                        # Channel model
│      log.go                            # Log model
│      main.go                           # Main models and ORM configuration
│      midjourney.go                     # Midjourney related model
│      option.go                         # Option settings model
│      pricing.go                        # Pricing model
│      redemption.go                     # Redemption code model
│      task.go                           # Task model
│      token.go                          # Token model
│      token_cache.go                    # Token cache model
│      topup.go                          # Top-up model
│      usedata.go                        # User data model
│      user.go                           # User model
│      user_cache.go                     # User cache model
│      utils.go                          # Model utility functions
│
├─relay                                  # Request forwarding module directory
│  │  relay-audio.go                     # Audio request forwarding
│  │  relay-image.go                     # Image request forwarding
│  │  relay-mj.go                        # Midjourney request forwarding
│  │  relay-text.go                      # Text request forwarding
│  │  relay_adaptor.go                   # Forwarding adaptor
│  │  relay_embedding.go                 # Embedding request forwarding
│  │  relay_rerank.go                    # Rerank request forwarding
│  │  relay_task.go                      # Task request forwarding
│  │  websocket.go                       # WebSocket communication handling
│  │
│  ├─channel                             # Forwarding channel directory
│  │  │  adapter.go                      # General channel adaptor
│  │  │  api_request.go                  # API request handling
│  │  │
│  │  ├─ai360                            # 360 AI Channel
│  │  │      constants.go                # 360 AI constants definition
│  │  │
│  │  ├─ali                              # Alibaba Cloud AI Channel
│  │  │      adaptor.go                  # Alibaba Cloud adaptor
│  │  │      constants.go                # Alibaba Cloud constants definition
│  │  │      dto.go                      # Alibaba Cloud Data Transfer Object
│  │  │      image.go                    # Alibaba Cloud image processing
│  │  │      text.go                     # Alibaba Cloud text processing
│  │  │
│  │  ├─aws                              # AWS AI Channel
│  │  │      adaptor.go                  # AWS adaptor
│  │  │      constants.go                # AWS constants definition
│  │  │      dto.go                      # AWS Data Transfer Object
│  │  │      relay-aws.go                # AWS request forwarding
│  │  │
│  │  ├─baidu                            # Baidu AI Channel
│  │  │      adaptor.go                  # Baidu adaptor
│  │  │      constants.go                # Baidu constants definition
│  │  │      dto.go                      # Baidu Data Transfer Object
│  │  │      relay-baidu.go              # Baidu request forwarding
│  │  │
│  │  ├─baidu_v2                         # Baidu AI v2 Version Channel
│  │  │      adaptor.go                  # Baidu v2 adaptor
│  │  │      constants.go                # Baidu v2 constants definition
│  │  │
│  │  ├─claude                           # Claude AI Channel
│  │  │      adaptor.go                  # Claude adaptor
│  │  │      constants.go                # Claude constants definition
│  │  │      dto.go                      # Claude Data Transfer Object
│  │  │      relay-claude.go             # Claude request forwarding
│  │  │
│  │  ├─cloudflare                       # Cloudflare AI Channel
│  │  │      adaptor.go                  # Cloudflare adaptor
│  │  │      constant.go                 # Cloudflare constants definition
│  │  │      dto.go                      # Cloudflare Data Transfer Object
│  │  │      relay_cloudflare.go         # Cloudflare request forwarding
│  │  │
│  │  ├─cohere                           # Cohere AI Channel
│  │  │      adaptor.go                  # Cohere adaptor
│  │  │      constant.go                 # Cohere constants definition
│  │  │      dto.go                      # Cohere Data Transfer Object
│  │  │      relay-cohere.go             # Cohere request forwarding
│  │  │
│  │  ├─deepseek                         # DeepSeek AI Channel
│  │  │      adaptor.go                  # DeepSeek adaptor
│  │  │      constants.go                # DeepSeek constants definition
│  │  │
│  │  ├─dify                             # Dify AI Channel
│  │  │      adaptor.go                  # Dify adaptor
│  │  │      constants.go                # Dify constants definition
│  │  │      dto.go                      # Dify Data Transfer Object
│  │  │      relay-dify.go               # Dify request forwarding
│  │  │
│  │  ├─gemini                           # Google Gemini AI Channel
│  │  │      adaptor.go                  # Gemini adaptor
│  │  │      constant.go                 # Gemini constants definition
│  │  │      dto.go                      # Gemini Data Transfer Object
│  │  │      relay-gemini.go             # Gemini request forwarding
│  │  │
│  │  ├─jina                             # Jina AI Channel
│  │  │      adaptor.go                  # Jina adaptor
│  │  │      constant.go                 # Jina constants definition
│  │  │      relay-jina.go               # Jina request forwarding
│  │  │
│  │  ├─lingyiwanwu                      # Lingyiwanwu AI Channel
│  │  │      constrants.go               # Lingyiwanwu constants definition
│  │  │
│  │  ├─minimax                          # MiniMax AI Channel
│  │  │      constants.go                # MiniMax constants definition
│  │  │      relay-minimax.go            # MiniMax request forwarding
│  │  │
│  │  ├─mistral                          # Mistral AI Channel
│  │  │      adaptor.go                  # Mistral adaptor
│  │  │      constants.go                # Mistral constants definition
│  │  │      text.go                     # Mistral text processing
│  │  │
│  │  ├─mokaai                           # MokaAI Channel
│  │  │      adaptor.go                  # MokaAI adaptor
│  │  │      constants.go                # MokaAI constants definition
│  │  │      relay-mokaai.go             # MokaAI request forwarding
│  │  │
│  │  ├─moonshot                         # Moonshot AI Channel
│  │  │      constants.go                # Moonshot constants definition
│  │  │
│  │  ├─ollama                           # Ollama AI Channel
│  │  │      adaptor.go                  # Ollama adaptor
│  │  │      constants.go                # Ollama constants definition
│  │  │      dto.go                      # Ollama Data Transfer Object
│  │  │      relay-ollama.go             # Ollama request forwarding
│  │  │
│  │  ├─openai                           # OpenAI Channel
│  │  │      adaptor.go                  # OpenAI adaptor
│  │  │      constant.go                 # OpenAI constants definition
│  │  │      relay-openai.go             # OpenAI request forwarding
│  │  │
│  │  ├─openrouter                       # OpenRouter AI Channel
│  │  │      adaptor.go                  # OpenRouter adaptor
│  │  │      constant.go                 # OpenRouter constants definition
│  │  │
│  │  ├─palm                             # Google PaLM AI Channel
│  │  │      adaptor.go                  # PaLM adaptor
│  │  │      constants.go                # PaLM constants definition
│  │  │      dto.go                      # PaLM Data Transfer Object
│  │  │      relay-palm.go               # PaLM request forwarding
│  │  │
│  │  ├─perplexity                       # Perplexity AI Channel
│  │  │      adaptor.go                  # Perplexity adaptor
│  │  │      constants.go                # Perplexity constants definition
│  │  │      relay-perplexity.go         # Perplexity request forwarding
│  │  │
│  │  ├─siliconflow                      # SiliconFlow AI Channel
│  │  │      adaptor.go                  # SiliconFlow adaptor
│  │  │      constant.go                 # SiliconFlow constants definition
│  │  │      dto.go                      # SiliconFlow Data Transfer Object
│  │  │      relay-siliconflow.go        # SiliconFlow request forwarding
│  │  │
│  │  ├─task                             # Task related channel
│  │  │  └─suno                          # Suno audio generation task
│  │  │          adaptor.go              # Suno adaptor
│  │  │          models.go               # Suno model definition
│  │  │
│  │  ├─tencent                          # Tencent AI Channel
│  │  │      adaptor.go                  # Tencent adaptor
│  │  │      constants.go                # Tencent constants definition
│  │  │      dto.go                      # Tencent Data Transfer Object
│  │  │      relay-tencent.go            # Tencent request forwarding
│  │  │
│  │  ├─vertex                           # Google Vertex AI Channel
│  │  │      adaptor.go                  # Vertex adaptor
│  │  │      constants.go                # Vertex constants definition
│  │  │      dto.go                      # Vertex Data Transfer Object
│  │  │      relay-vertex.go             # Vertex request forwarding
│  │  │      service_account.go          # Vertex service account
│  │  │
│  │  ├─volcengine                       # Volcengine AI Channel
│  │  │      adaptor.go                  # Volcengine adaptor
│  │  │      constants.go                # Volcengine constants definition
│  │  │
│  │  ├─xunfei                           # Xunfei AI Channel
│  │  │      adaptor.go                  # Xunfei adaptor
│  │  │      constants.go                # Xunfei constants definition
│  │  │      dto.go                      # Xunfei Data Transfer Object
│  │  │      relay-xunfei.go             # Xunfei request forwarding
│  │  │
│  │  ├─zhipu                            # Zhipu AI Channel
│  │  │      adaptor.go                  # Zhipu adaptor
│  │  │      constants.go                # Zhipu constants definition
│  │  │      dto.go                      # Zhipu Data Transfer Object
│  │  │      relay-zhipu.go              # Zhipu request forwarding
│  │  │
│  │  └─zhipu_4v                         # Zhipu 4.0 Version Channel
│  │          adaptor.go                 # Zhipu 4.0 adaptor
│  │          constants.go               # Zhipu 4.0 constants definition
│  │          dto.go                     # Zhipu 4.0 Data Transfer Object
│  │          relay-zhipu_v4.go          # Zhipu 4.0 request forwarding
│  │
│  ├─common                              # Forwarding common module
│  │      relay_info.go                  # Forwarding information
│  │      relay_utils.go                 # Forwarding utility functions
│  │
│  ├─constant                            # Forwarding constants directory
│  │      api_type.go                    # API type constants
│  │      relay_mode.go                  # Forwarding mode constants
│  │
│  └─helper                              # Forwarding helper functions
│          common.go                     # Common helper functions
│          model_mapped.go               # Model mapping
│          price.go                      # Price calculation
│          stream_scanner.go             # Stream data scanner
│
├─router                                 # Router configuration directory
│      api-router.go                     # API router configuration
│      dashboard.go                      # Dashboard router
│      main.go                           # Main router configuration
│      relay-router.go                   # Relay router configuration
│      web-router.go                     # Web interface router configuration
│
├─service                                # Service layer directory
│      audio.go                          # Audio service
│      cf_worker.go                      # Cloudflare Worker service
│      channel.go                        # Channel service
│      epay.go                           # E-payment service
│      error.go                          # Error handling service
│      file_decoder.go                   # File decoder service
│      http_client.go                    # HTTP client service
│      image.go                          # Image processing service
│      log_info_generate.go              # Log information generation service
│      midjourney.go                     # Midjourney service
│      notify-limit.go                   # Notification limit service
│      quota.go                          # Quota management service
│      sensitive.go                      # Sensitive content filtering service
│      str.go                            # String processing service
│      task.go                           # Task management service
│      token_counter.go                  # Token counting service
│      usage_helpr.go                    # Usage statistics helper service
│      user_notify.go                    # User notification service
│      webhook.go                        # WebHook service
│
├─setting                                # Settings management directory
│  │  chat.go                            # Chat settings
│  │  group_ratio.go                     # User group ratio settings
│  │  midjourney.go                      # Midjourney settings
│  │  payment.go                         # Payment settings
│  │  rate_limit.go                      # Rate limit settings
│  │  sensitive.go                       # Sensitive content settings
│  │  system_setting.go                  # System settings
│  │  user_usable_group.go               # User usable group settings
│  │
│  ├─config                              # Configuration directory
│  │      config.go                      # Configuration loading and processing
│  │
│  ├─model_setting                       # Model settings directory
│  │      claude.go                      # Claude model settings
│  │      gemini.go                      # Gemini model settings
│  │      global.go                      # Global model settings
│  │
│  ├─operation_setting                   # Operation settings directory
│  │      cache_ratio.go                 # Cache ratio settings
│  │      general_setting.go             # General settings
│  │      model-ratio.go                 # Model ratio settings
│  │      operation_setting.go           # Operation settings
│  │
│  └─system_setting                      # System settings directory
│          oidc.go                       # OpenID Connect settings
│
└─web                                    # Frontend Web interface directory
    │  .gitignore                        # Frontend Git ignore file configuration
    │  .prettierrc.mjs                   # Prettier code formatting configuration
    │  bun.lockb                         # Bun package manager lock file
    │  index.html                        # Main HTML file
    │  package.json                      # Frontend dependencies configuration
    │  bun.lockb                         # Bun package manager lock file (binary format, faster)
    │  README.md                         # Frontend README
    │  vercel.json                       # Vercel deployment configuration
    │  vite.config.js                    # Vite build configuration
    │
    ├─public                             # Static assets directory
    │      favicon.ico                   # Website icon
    │      logo.png                      # Website Logo
    │      ratio.png                     # Ratio image
    │      robots.txt                    # Search engine crawler configuration
    │
    └─src                                # Frontend source code directory
        │  App.js                        # Application main component
        │  index.css                     # Main stylesheet
        │  index.js                      # Application entry JS
        │
        ├─components                     # Components directory
        │  │  ChannelsTable.js           # Channels table component
        │  │  fetchTokenKeys.js          # Tool to fetch token keys
        │  │  Footer.js                  # Footer component
        │  │  HeaderBar.js               # Header bar component
        │  │  LinuxDoIcon.js             # LinuxDo icon component
        │  │  Loading.js                 # Loading component
        │  │  LoginForm.js               # Login form component
        │  │  LogsTable.js               # Logs table component
        │  │  MjLogsTable.js             # Midjourney logs table component
        │  │  ModelPricing.js            # Model pricing component
        │  │  ModelSetting.js            # Model settings component
        │  │  OAuth2Callback.js          # OAuth2 callback component
        │  │  OIDCIcon.js                # OIDC icon component
        │  │  OperationSetting.js        # Operation settings component
        │  │  OtherSetting.js            # Other settings component
        │  │  PageLayout.js              # Page layout component
        │  │  PasswordResetConfirm.js    # Password reset confirmation component
        │  │  PasswordResetForm.js       # Password reset form component
        │  │  PersonalSetting.js         # Personal settings component
        │  │  PrivateRoute.js            # Private route component
        │  │  RateLimitSetting.js        # Rate limit settings component
        │  │  RedemptionsTable.js        # Redemptions table component
        │  │  RegisterForm.js            # Register form component
        │  │  SafetySetting.js           # Security settings component
        │  │  SiderBar.js                # Sidebar component
        │  │  SystemSetting.js           # System settings component
        │  │  TaskLogsTable.js           # Task logs table component
        │  │  TokensTable.js             # Token management table component
        │  │  UsersTable.js              # User management table component
        │  │  utils.js                   # General utility functions
        │  │  WeChatIcon.js              # WeChat icon component
        │  │
        │  └─custom                      # Custom components directory
        │          TextInput.js          # Text input component
        │          TextNumberInput.js    # Number input component
        │
        ├─constants                      # Constants definition directory
        │      channel.constants.js      # Channel related constants
        │      common.constant.js        # Common constants
        │      index.js                  # Constants export index
        │      toast.constants.js        # Toast message constants
        │      user.constants.js         # User related constants
        │
        ├─context                        # React Context directory
        │  ├─Status                      # Status context
        │  │      index.js               # Status context entry
        │  │      reducer.js             # Status context reducer
        │  │
        │  ├─Style                       # Style context
        │  │      index.js               # Style context entry
        │  │
        │  ├─Theme                       # Theme context
        │  │      index.js               # Theme context entry
        │  │
        │  └─User                        # User context
        │          index.js              # User context entry
        │          reducer.js            # User context reducer
        │
        ├─helpers                        # Helper functions directory
        │      api.js                    # API request helper functions
        │      auth-header.js            # Authentication header handling
        │      data.js                   # Data processing functions
        │      history.js                # Route history management
        │      index.js                  # Helper functions export index
        │      other.js                  # Other helper functions
        │      render.js                 # Render helper functions
        │      utils.js                   # Utility functions
        │
        ├─i18n                           # Internationalization directory
        │  │  i18n.js                    # Internationalization configuration file
        │  │
        │  └─locales                     # Locales directory
        │          en.json               # English language pack
        │          zh.json               # Chinese language pack
        │
        └─pages                          # Page components directory
            ├─About                      # About page
            │      index.js              # About page entry
            │
            ├─Channel                    # Channel management page
            │      EditChannel.js        # Edit channel component
            │      EditTagModal.js       # Edit tag modal
            │      index.js              # Channel management page entry
            │
            ├─Chat                       # Chat page
            │      index.js              # Chat page entry
            │
            ├─Chat2Link                  # Chat link sharing page
            │      index.js              # Chat link entry
            │
            ├─Detail                     # Detail page
            │      index.js              # Detail page entry
            │
            ├─Home                       # Home page
            │      index.js              # Home page entry
            │
            ├─Log                        # Log page
            │      index.js              # Log page entry
            │
            ├─Midjourney                 # Midjourney management page
            │      index.js              # Midjourney page entry
            │
            ├─NotFound                   # 404 page
            │      index.js              # 404 page entry
            │
            ├─Playground                 # Playground page
            │      Playground.js         # Playground component
            │
            ├─Pricing                    # Pricing management page
            │      index.js              # Pricing management page entry
            │
            ├─Redemption                 # Redemption code management page
            │      EditRedemption.js     # Edit redemption code component
            │      index.js              # Redemption code management page entry
            │
            ├─Setting                    # Settings page
            │  │  index.js               # Settings page entry
            │  │
            │  ├─Model                   # Model settings page
            │  │      SettingClaudeModel.js # Claude model settings component
            │  │      SettingGeminiModel.js # Gemini model settings component
            │  │      SettingGlobalModel.js # Global model settings component
            │  │
            │  ├─Operation               # Operation settings page
            │  │      GroupRatioSettings.js       # User group ratio settings component
            │  │      ModelRationNotSetEditor.js  # Model ratio not set editor
            │  │      ModelRatioSettings.js       # Model ratio settings component
            │  │      ModelSettingsVisualEditor.js # Model settings visual editor
            │  │      SettingsChats.js            # Chat settings component
            │  │      SettingsCreditLimit.js      # Quota limit settings component
            │  │      SettingsDataDashboard.js    # Data dashboard settings component
            │  │      SettingsDrawing.js          # Drawing settings component
            │  │      SettingsGeneral.js          # General settings component
            │  │      SettingsLog.js              # Log settings component
            │  │      SettingsMonitoring.js       # Monitoring settings component
            │  │      SettingsSensitiveWords.js   # Sensitive words settings component
            │  │
            │  └─RateLimit                   # Rate limit settings page
            │          SettingsRequestRateLimit.js # Request rate limit settings component
            │
            ├─Task                           # Task management page
            │      index.js                  # Task management page entry
            │
            ├─Token                          # Token management page
            │      EditToken.js              # Edit token component
            │      index.js                  # Token management page entry
            │
            ├─TopUp                          # Top-up page
            │      index.js                  # Top-up page entry
            │
            └─User                           # User management page
                    AddUser.js               # Add user component
                    EditUser.js              # Edit user component
                    index.js                 # User management page entry
```

<Callout type="info" title="Need Help?">
  If you encounter problems during development, you can:

  1. Check [GitHub Issues](https://github.com/Calcium-Ion/new-api/issues)
  2. Join the [QQ communication group](/en/docs/support/community-interaction)
  3. Submit issues via the [Problem Feedback](/en/docs/support/feedback-issues) page
</Callout>


# Native Gemini Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Gemini audio generation API.
Models such as gemini-2.5-flash-preview-tts can be used.

<APIPage document={"openapi/generated/ai-model/音频（Audio）/post-v1beta-models-model-generatecontent-geminirelayv1beta-383836364-383836364.json"} operations={[{"path":"/v1beta/models/{model}:generateContent","method":"post"}]} />


# Native Claude Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Requests in Anthropic Claude Messages API format.
Requires `anthropic-version` in the request header.

<APIPage document={"openapi/generated/ai-model/聊天（Chat）/post-v1-messages-createmessage-383826476.json"} operations={[{"path":"/v1/messages","method":"post"}]} />


# Native OpenAI Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Create text completions based on a given prompt

<APIPage document={"openapi/generated/ai-model/补全（Completions）/post-v1-completions-createcompletion-383826474.json"} operations={[{"path":"/v1/completions","method":"post"}]} />


# Native OpenAI Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Convert text to vector embeddings

<APIPage document={"openapi/generated/ai-model/嵌入（Embeddings）/post-v1-embeddings-createembedding-383826477.json"} operations={[{"path":"/v1/embeddings","method":"post"}]} />


# Native Gemini Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Create Embeddings using a specified engine/model

<APIPage document={"openapi/generated/ai-model/嵌入（Embeddings）/post-v1-engines-model-embeddings-createengineembedding-383826478.json"} operations={[{"path":"/v1/engines/{model}/embeddings","method":"post"}]} />


# Native OpenAI Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Check if text content violates usage policy

<APIPage document={"openapi/generated/ai-model/审查（Moderations）/post-v1-moderations-createmoderation-383826487.json"} operations={[{"path":"/v1/moderations","method":"post"}]} />


# Native OpenAI Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Establish a WebSocket connection for real-time conversations.

**Note**: This is a WebSocket endpoint and requires a WebSocket protocol connection.

Connection URL example: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`

<APIPage document={"openapi/generated/ai-model/实时语音（Realtime）/get-v1-realtime-createrealtimesession-383826490.json"} operations={[{"path":"/v1/realtime","method":"get"}]} />


# Document Reranking

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Rerank document list by relevance based on query

<APIPage document={"openapi/generated/ai-model/重排序（Rerank）/post-v1-rerank-creatererank-383826486.json"} operations={[{"path":"/v1/rerank","method":"post"}]} />


# Create Video Generation Task

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Submit a video generation task, supporting text-to-video and image-to-video.

Returns the task ID. The task status can be queried via the GET API.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/post-v1-video-generations-createvideogeneration-383844576.json"} operations={[{"path":"/v1/video/generations","method":"post"}]} />


# Get Video Generation Task Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Query the status and results of a video generation task.

Task Status:

* `queued`: Queued
* `in_progress`: In progress
* `completed`: Completed
* `failed`: Failed

<APIPage document={"openapi/generated/ai-model/视频（Videos）/get-v1-video-generations-task-id-getvideogeneration-383844577.json"} operations={[{"path":"/v1/video/generations/{task_id}","method":"get"}]} />


# Redeem Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/default/post-api-user-topup-post-api-user-topup-396792892.json"} operations={[{"path":"/api/user/topup","method":"post"}]} />


# Batch Delete Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-batch-post-api-channel-batch-384083902.json"} operations={[{"path":"/api/channel/batch","method":"post"}]} />


# Batch Set Channel Tags

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-batch-tag-post-api-channel-batch-tag-384083906.json"} operations={[{"path":"/api/channel/batch/tag","method":"post"}]} />


# Copy Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-copy-id-post-api-channel-copy-id-384083911.json"} operations={[{"path":"/api/channel/copy/{id}","method":"post"}]} />


# Delete Disabled Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/渠道管理/delete-api-channel-disabled-delete-api-channel-disabled-384083901.json"} operations={[{"path":"/api/channel/disabled","method":"delete"}]} />


# Get Upstream Model List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-fetch-models-id-get-api-channel-fetch-models-id-384083904.json"} operations={[{"path":"/api/channel/fetch_models/{id}","method":"get"}]} />


# Get Model List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-fetch-models-post-api-channel-fetch-models-384083905.json"} operations={[{"path":"/api/channel/fetch_models","method":"post"}]} />


# Fix Channel Capability

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-fix-post-api-channel-fix-384083903.json"} operations={[{"path":"/api/channel/fix","method":"post"}]} />


# Get All Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-get-api-channel-384083888.json"} operations={[{"path":"/api/channel/","method":"get"}]} />


# Delete Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/delete-api-channel-id-delete-api-channel-id-384083895.json"} operations={[{"path":"/api/channel/{id}","method":"delete"}]} />


# Get Specific Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-id-get-api-channel-id-384083894.json"} operations={[{"path":"/api/channel/{id}","method":"get"}]} />


# Get Channel Key

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Permissions + Security Verification

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-id-key-post-api-channel-id-key-384083896.json"} operations={[{"path":"/api/channel/{id}/key","method":"post"}]} />


# Get Channel Model List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-models-get-api-channel-models-384083892.json"} operations={[{"path":"/api/channel/models","method":"get"}]} />


# Get Enabled Model List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin permissions required

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-models-enabled-get-api-channel-models-enabled-384083893.json"} operations={[{"path":"/api/channel/models_enabled","method":"get"}]} />


# Manage Multiple Keys

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-multi-key-manage-post-api-channel-multi-key-manage-384083912.json"} operations={[{"path":"/api/channel/multi_key/manage","method":"post"}]} />


# Add Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-post-api-channel-384083889.json"} operations={[{"path":"/api/channel/","method":"post"}]} />


# Update Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/put-api-channel-put-api-channel-384083890.json"} operations={[{"path":"/api/channel/","method":"put"}]} />


# Search Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-search-get-api-channel-search-384083891.json"} operations={[{"path":"/api/channel/search","method":"get"}]} />


# Disable Tag Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-tag-disabled-post-api-channel-tag-disabled-384083908.json"} operations={[{"path":"/api/channel/tag/disabled","method":"post"}]} />


# Enable Tag Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/post-api-channel-tag-enabled-post-api-channel-tag-enabled-384083909.json"} operations={[{"path":"/api/channel/tag/enabled","method":"post"}]} />


# Get Tag Models

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-tag-models-get-api-channel-tag-models-384083907.json"} operations={[{"path":"/api/channel/tag/models","method":"get"}]} />


# Edit Tag Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/渠道管理/put-api-channel-tag-put-api-channel-tag-384083910.json"} operations={[{"path":"/api/channel/tag","method":"put"}]} />


# Test All Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-test-get-api-channel-test-384083897.json"} operations={[{"path":"/api/channel/test","method":"get"}]} />


# Test Specific Channel

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-test-id-get-api-channel-test-id-384083898.json"} operations={[{"path":"/api/channel/test/{id}","method":"get"}]} />


# Update All Channel Balances

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-update-balance-get-api-channel-update-balance-384083899.json"} operations={[{"path":"/api/channel/update_balance","method":"get"}]} />


# Update Specified Channel Balance

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/渠道管理/get-api-channel-update-balance-id-get-api-channel-update-balance-id-384083900.json"} operations={[{"path":"/api/channel/update_balance/{id}","method":"get"}]} />


# Get All Groups

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/分组/get-api-group-get-api-group-384083938.json"} operations={[{"path":"/api/group/","method":"get"}]} />


# Get Prefill Group

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/分组/get-api-prefill-group-get-api-prefill-group-384083939.json"} operations={[{"path":"/api/prefill_group/","method":"get"}]} />


# Delete Prefill Group

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/分组/delete-api-prefill-group-id-delete-api-prefill-group-id-384083942.json"} operations={[{"path":"/api/prefill_group/{id}","method":"delete"}]} />


# Create Prefill Group

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin permissions required

<APIPage document={"openapi/generated/management/分组/post-api-prefill-group-post-api-prefill-group-384083940.json"} operations={[{"path":"/api/prefill_group/","method":"post"}]} />


# Update Prefill Group

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin permissions required

<APIPage document={"openapi/generated/management/分组/put-api-prefill-group-put-api-prefill-group-384083941.json"} operations={[{"path":"/api/prefill_group/","method":"put"}]} />


# Delete Historical Logs

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin Privileges Required

<APIPage document={"openapi/generated/management/日志/delete-api-log-delete-api-log-384083929.json"} operations={[{"path":"/api/log/","method":"delete"}]} />


# Get All Logs

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/日志/get-api-log-get-api-log-384083928.json"} operations={[{"path":"/api/log/","method":"get"}]} />


# Search Logs

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin privileges

<APIPage document={"openapi/generated/management/日志/get-api-log-search-get-api-log-search-384083932.json"} operations={[{"path":"/api/log/search","method":"get"}]} />


# Get Personal Logs

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/日志/get-api-log-self-get-api-log-self-384083933.json"} operations={[{"path":"/api/log/self","method":"get"}]} />


# Search Personal Logs

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/日志/get-api-log-self-search-get-api-log-self-search-384083934.json"} operations={[{"path":"/api/log/self/search","method":"get"}]} />


# Get Personal Log Statistics

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/日志/get-api-log-self-stat-get-api-log-self-stat-384083931.json"} operations={[{"path":"/api/log/self/stat","method":"get"}]} />


# Get Log Statistics

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/日志/get-api-log-stat-get-api-log-stat-384083930.json"} operations={[{"path":"/api/log/stat","method":"get"}]} />


# Get Logs by Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Query by Token)

<APIPage document={"openapi/generated/management/日志/get-api-log-token-get-api-log-token-384083935.json"} operations={[{"path":"/api/log/token","method":"get"}]} />


# Get All Model Metadata

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/模型管理/get-api-models-get-api-models-384083953.json"} operations={[{"path":"/api/models/","method":"get"}]} />


# Delete Model

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/模型管理/delete-api-models-id-delete-api-models-id-384083958.json"} operations={[{"path":"/api/models/{id}","method":"delete"}]} />


# Get Specific Model

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/模型管理/get-api-models-id-get-api-models-id-384083957.json"} operations={[{"path":"/api/models/{id}","method":"get"}]} />


# Get Missing Models

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/模型管理/get-api-models-missing-get-api-models-missing-384083961.json"} operations={[{"path":"/api/models/missing","method":"get"}]} />


# Create Model Metadata

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin permissions required

<APIPage document={"openapi/generated/management/模型管理/post-api-models-post-api-models-384083954.json"} operations={[{"path":"/api/models/","method":"post"}]} />


# Update Model Metadata

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/模型管理/put-api-models-put-api-models-384083955.json"} operations={[{"path":"/api/models/","method":"put"}]} />


# Search Models

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/模型管理/get-api-models-search-get-api-models-search-384083956.json"} operations={[{"path":"/api/models/search","method":"get"}]} />


# Sync Upstream Models

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/模型管理/post-api-models-sync-upstream-post-api-models-sync-upstream-384083960.json"} operations={[{"path":"/api/models/sync_upstream","method":"post"}]} />


# Preview Upstream Model Synchronization

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/模型管理/get-api-models-sync-upstream-preview-get-api-models-sync-upstream-preview-384083959.json"} operations={[{"path":"/api/models/sync_upstream/preview","method":"get"}]} />


# Discord OAuth Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-discord-get-api-oauth-discord-384083835.json"} operations={[{"path":"/api/oauth/discord","method":"get"}]} />


# Bind Email

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-email-bind-get-api-oauth-email-bind-384083841.json"} operations={[{"path":"/api/oauth/email/bind","method":"get"}]} />


# GitHub OAuth Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-github-get-api-oauth-github-384083834.json"} operations={[{"path":"/api/oauth/github","method":"get"}]} />


# LinuxDO OAuth Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-linuxdo-get-api-oauth-linuxdo-384083837.json"} operations={[{"path":"/api/oauth/linuxdo","method":"get"}]} />


# OIDC Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-oidc-get-api-oauth-oidc-384083836.json"} operations={[{"path":"/api/oauth/oidc","method":"get"}]} />


# Generate OAuth State

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-state-get-api-oauth-state-384083838.json"} operations={[{"path":"/api/oauth/state","method":"get"}]} />


# Bind Telegram

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-telegram-bind-get-api-oauth-telegram-bind-384083843.json"} operations={[{"path":"/api/oauth/telegram/bind","method":"get"}]} />


# Telegram Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-telegram-login-get-api-oauth-telegram-login-384083842.json"} operations={[{"path":"/api/oauth/telegram/login","method":"get"}]} />


# Bind WeChat

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-wechat-bind-get-api-oauth-wechat-bind-384083840.json"} operations={[{"path":"/api/oauth/wechat/bind","method":"get"}]} />


# WeChat OAuth Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (OAuth Callback)

<APIPage document={"openapi/generated/management/OAuth/get-api-oauth-wechat-get-api-oauth-wechat-384083839.json"} operations={[{"path":"/api/oauth/wechat","method":"get"}]} />


# Creem Webhook

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Webhook Callback)

<APIPage document={"openapi/generated/management/充值/post-api-creem-webhook-post-api-creem-webhook-384083879.json"} operations={[{"path":"/api/creem/webhook","method":"post"}]} />


# Stripe Webhook

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Webhook Callback)

<APIPage document={"openapi/generated/management/充值/post-api-stripe-webhook-post-api-stripe-webhook-384083878.json"} operations={[{"path":"/api/stripe/webhook","method":"post"}]} />


# Get Payment Amount

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/post-api-user-amount-post-api-user-amount-384083873.json"} operations={[{"path":"/api/user/amount","method":"post"}]} />


# Initiate Creem Payment

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/post-api-user-creem-pay-post-api-user-creem-pay-384083876.json"} operations={[{"path":"/api/user/creem/pay","method":"post"}]} />


# Epay Callback

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Payment Callback)

<APIPage document={"openapi/generated/management/充值/get-api-user-epay-notify-get-api-user-epay-notify-384083877.json"} operations={[{"path":"/api/user/epay/notify","method":"get"}]} />


# Initiate Easy Payment

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/post-api-user-pay-post-api-user-pay-384083872.json"} operations={[{"path":"/api/user/pay","method":"post"}]} />


# Get Stripe Payment Amount

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/post-api-user-stripe-amount-post-api-user-stripe-amount-384083875.json"} operations={[{"path":"/api/user/stripe/amount","method":"post"}]} />


# Initiate Stripe Payment

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login required (User permission)

<APIPage document={"openapi/generated/management/充值/post-api-user-stripe-pay-post-api-user-stripe-pay-384083874.json"} operations={[{"path":"/api/user/stripe/pay","method":"post"}]} />


# Get Top-up Information

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/get-api-user-topup-info-get-api-user-topup-info-384083870.json"} operations={[{"path":"/api/user/topup/info","method":"get"}]} />


# Get User Top-up Records

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/充值/get-api-user-topup-self-get-api-user-topup-self-384083871.json"} operations={[{"path":"/api/user/topup/self","method":"get"}]} />


# Get All Redemption Codes

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/兑换码/get-api-redemption-get-api-redemption-384083921.json"} operations={[{"path":"/api/redemption/","method":"get"}]} />


# Delete Redemption Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/兑换码/delete-api-redemption-id-delete-api-redemption-id-384083926.json"} operations={[{"path":"/api/redemption/{id}","method":"delete"}]} />


# Get Specific Redemption Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/兑换码/get-api-redemption-id-get-api-redemption-id-384083925.json"} operations={[{"path":"/api/redemption/{id}","method":"get"}]} />


# Delete Invalid Redemption Codes

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/兑换码/delete-api-redemption-invalid-delete-api-redemption-invalid-384083927.json"} operations={[{"path":"/api/redemption/invalid","method":"delete"}]} />


# Create Redemption Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/兑换码/post-api-redemption-post-api-redemption-384083922.json"} operations={[{"path":"/api/redemption/","method":"post"}]} />


# Update Redemption Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/兑换码/put-api-redemption-put-api-redemption-384083923.json"} operations={[{"path":"/api/redemption/","method":"put"}]} />


# Search Redemption Codes

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/兑换码/get-api-redemption-search-get-api-redemption-search-384083924.json"} operations={[{"path":"/api/redemption/search","method":"get"}]} />


# General Security Verification

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/安全验证/post-api-verify-post-api-verify-384083886.json"} operations={[{"path":"/api/verify","method":"post"}]} />


# Get Verification Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/安全验证/get-api-verify-status-get-api-verify-status-384083887.json"} operations={[{"path":"/api/verify/status","method":"get"}]} />


# Get All Quota Data

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/数据统计/get-api-data-get-api-data-384083936.json"} operations={[{"path":"/api/data/","method":"get"}]} />


# Get Personal Quota Data

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/数据统计/get-api-data-self-get-api-data-self-384083937.json"} operations={[{"path":"/api/data/self","method":"get"}]} />


# Get About Information

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-about-get-api-about-384083819.json"} operations={[{"path":"/api/about","method":"get"}]} />


# Get Home Page Content

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/系统/get-api-home-page-content-get-api-home-page-content-384083820.json"} operations={[{"path":"/api/home_page_content","method":"get"}]} />


# Get Model List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/系统/get-api-models-get-api-models-384083822-384083822.json"} operations={[{"path":"/api/models","method":"get"}]} />


# Get Announcements

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-notice-get-api-notice-384083816.json"} operations={[{"path":"/api/notice","method":"get"}]} />


# Get Pricing Information

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Optional Login)

<APIPage document={"openapi/generated/management/系统/get-api-pricing-get-api-pricing-384083821.json"} operations={[{"path":"/api/pricing","method":"get"}]} />


# Get Privacy Policy

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-privacy-policy-get-api-privacy-policy-384083818.json"} operations={[{"path":"/api/privacy-policy","method":"get"}]} />


# Get Ratio Configuration

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-ratio-config-get-api-ratio-config-384083823.json"} operations={[{"path":"/api/ratio_config","method":"get"}]} />


# Get Initialization Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/系统/get-api-setup-get-api-setup-384083811.json"} operations={[{"path":"/api/setup","method":"get"}]} />


# Initialize System

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/系统/post-api-setup-post-api-setup-384083812.json"} operations={[{"path":"/api/setup","method":"post"}]} />


# Get System Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/系统/get-api-status-get-api-status-384083813.json"} operations={[{"path":"/api/status","method":"get"}]} />


# Test System Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/系统/get-api-status-test-get-api-status-test-384083814.json"} operations={[{"path":"/api/status/test","method":"get"}]} />


# Get Uptime Kuma Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-uptime-status-get-api-uptime-status-384083815.json"} operations={[{"path":"/api/uptime/status","method":"get"}]} />


# Get User Agreement

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/系统/get-api-user-agreement-get-api-user-agreement-384083817.json"} operations={[{"path":"/api/user-agreement","method":"get"}]} />


# Get System Options

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Permissions

<APIPage document={"openapi/generated/management/系统设置/get-api-option-get-api-option-384083962.json"} operations={[{"path":"/api/option/","method":"get"}]} />


# Migrate Console Settings

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Privileges

<APIPage document={"openapi/generated/management/系统设置/post-api-option-migrate-console-setting-post-api-option-migrate-console-setting-384083965.json"} operations={[{"path":"/api/option/migrate_console_setting","method":"post"}]} />


# Update System Options

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Privileges

<APIPage document={"openapi/generated/management/系统设置/put-api-option-put-api-option-384083963.json"} operations={[{"path":"/api/option/","method":"put"}]} />


# Reset Model Ratio

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Permissions

<APIPage document={"openapi/generated/management/系统设置/post-api-option-rest-model-ratio-post-api-option-rest-model-ratio-384083964.json"} operations={[{"path":"/api/option/rest_model_ratio","method":"post"}]} />


# Get Syncable Channels

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Admin (Root) Permissions

<APIPage document={"openapi/generated/management/系统设置/get-api-ratio-sync-channels-get-api-ratio-sync-channels-384083966.json"} operations={[{"path":"/api/ratio_sync/channels","method":"get"}]} />


# Fetch Upstream Ratios

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👑 Requires Super Administrator (Root) Permissions

<APIPage document={"openapi/generated/management/系统设置/post-api-ratio-sync-fetch-post-api-ratio-sync-fetch-384083967.json"} operations={[{"path":"/api/ratio_sync/fetch","method":"post"}]} />


# Get All Midjourney Tasks

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/任务/get-api-mj-get-api-mj-384083943.json"} operations={[{"path":"/api/mj/","method":"get"}]} />


# Get Personal Midjourney Tasks

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/任务/get-api-mj-self-get-api-mj-self-384083944.json"} operations={[{"path":"/api/mj/self","method":"get"}]} />


# Get All Tasks

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/任务/get-api-task-get-api-task-384083945.json"} operations={[{"path":"/api/task/","method":"get"}]} />


# Get Personal Tasks

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/任务/get-api-task-self-get-api-task-self-384083946.json"} operations={[{"path":"/api/task/self","method":"get"}]} />


# Batch Delete Tokens

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/post-api-token-batch-post-api-token-batch-384083919.json"} operations={[{"path":"/api/token/batch","method":"post"}]} />


# Get All Tokens

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/get-api-token-get-api-token-384083913.json"} operations={[{"path":"/api/token/","method":"get"}]} />


# Delete Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/delete-api-token-id-delete-api-token-id-384083918.json"} operations={[{"path":"/api/token/{id}","method":"delete"}]} />


# Get Specified Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/get-api-token-id-get-api-token-id-384083917.json"} operations={[{"path":"/api/token/{id}","method":"get"}]} />


# Create Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/post-api-token-post-api-token-384083914.json"} operations={[{"path":"/api/token/","method":"post"}]} />


# Update Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/put-api-token-put-api-token-384083915.json"} operations={[{"path":"/api/token/","method":"put"}]} />


# Search Tokens

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/令牌管理/get-api-token-search-get-api-token-search-384083916.json"} operations={[{"path":"/api/token/search","method":"get"}]} />


# Get Token Usage

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔑 Token Authentication Required (TokenAuth)

<APIPage document={"openapi/generated/management/令牌管理/get-api-usage-token-get-api-usage-token-384083920.json"} operations={[{"path":"/api/usage/token/","method":"get"}]} />


# Regenerate Backup Codes

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login required (User permission)

<APIPage document={"openapi/generated/management/两步验证/post-api-user-2fa-backup-codes-post-api-user-2fa-backup-codes-384083884.json"} operations={[{"path":"/api/user/2fa/backup_codes","method":"post"}]} />


# Disable 2FA

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login required (User permission)

<APIPage document={"openapi/generated/management/两步验证/post-api-user-2fa-disable-post-api-user-2fa-disable-384083883.json"} operations={[{"path":"/api/user/2fa/disable","method":"post"}]} />


# Enable 2FA

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/两步验证/post-api-user-2fa-enable-post-api-user-2fa-enable-384083882.json"} operations={[{"path":"/api/user/2fa/enable","method":"post"}]} />


# Set Up 2FA

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permissions)

<APIPage document={"openapi/generated/management/两步验证/post-api-user-2fa-setup-post-api-user-2fa-setup-384083881.json"} operations={[{"path":"/api/user/2fa/setup","method":"post"}]} />


# Get 2FA Statistics

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Privileges (Admin)

<APIPage document={"openapi/generated/management/两步验证/get-api-user-2fa-stats-get-api-user-2fa-stats-384083885.json"} operations={[{"path":"/api/user/2fa/stats","method":"get"}]} />


# Get 2FA Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/两步验证/get-api-user-2fa-status-get-api-user-2fa-status-384083880.json"} operations={[{"path":"/api/user/2fa/status","method":"get"}]} />


# Send Password Reset Email

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/get-api-reset-password-get-api-reset-password-384083825.json"} operations={[{"path":"/api/reset_password","method":"get"}]} />


# Get User Group List

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No authentication required

<APIPage document={"openapi/generated/management/用户登陆注册/get-api-user-groups-get-api-user-groups-384083831.json"} operations={[{"path":"/api/user/groups","method":"get"}]} />


# Two-Factor Authentication Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required (Login Process)

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-login-2fa-post-api-user-login-2fa-384083829.json"} operations={[{"path":"/api/user/login/2fa","method":"post"}]} />


# User Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-login-post-api-user-login-384083828.json"} operations={[{"path":"/api/user/login","method":"post"}]} />


# User Logout

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/get-api-user-logout-get-api-user-logout-384083830.json"} operations={[{"path":"/api/user/logout","method":"get"}]} />


# Start Passkey Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-passkey-login-begin-post-api-user-passkey-login-begin-384083832.json"} operations={[{"path":"/api/user/passkey/login/begin","method":"post"}]} />


# Complete Passkey Login

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-passkey-login-finish-post-api-user-passkey-login-finish-384083833.json"} operations={[{"path":"/api/user/passkey/login/finish","method":"post"}]} />


# User Registration

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-register-post-api-user-register-384083827.json"} operations={[{"path":"/api/user/register","method":"post"}]} />


# Reset Password

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/post-api-user-reset-post-api-user-reset-384083826.json"} operations={[{"path":"/api/user/reset","method":"post"}]} />


# Send Email Verification Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔓 No Authentication Required

<APIPage document={"openapi/generated/management/用户登陆注册/get-api-verification-get-api-verification-384083824.json"} operations={[{"path":"/api/verification","method":"get"}]} />


# Get Invitation Code

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-aff-get-api-user-aff-384083856.json"} operations={[{"path":"/api/user/aff","method":"get"}]} />


# Convert Invitation Quota

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-aff-transfer-post-api-user-aff-transfer-384083857.json"} operations={[{"path":"/api/user/aff_transfer","method":"post"}]} />


# Get All Users

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/用户管理/get-api-user-get-api-user-384083860.json"} operations={[{"path":"/api/user/","method":"get"}]} />


# Admin Disable User 2FA

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin Permissions Required (Admin)

<APIPage document={"openapi/generated/management/用户管理/delete-api-user-id-2fa-delete-api-user-id-2fa-384083868.json"} operations={[{"path":"/api/user/{id}/2fa","method":"delete"}]} />


# Delete User

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/用户管理/delete-api-user-id-delete-api-user-id-384083866.json"} operations={[{"path":"/api/user/{id}","method":"delete"}]} />


# Get Specific User

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/用户管理/get-api-user-id-get-api-user-id-384083865.json"} operations={[{"path":"/api/user/{id}","method":"get"}]} />


# Admin Reset User Passkey

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/用户管理/delete-api-user-id-reset-passkey-delete-api-user-id-reset-passkey-384083867.json"} operations={[{"path":"/api/user/{id}/reset_passkey","method":"delete"}]} />


# Manage User Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/用户管理/post-api-user-manage-post-api-user-manage-384083869.json"} operations={[{"path":"/api/user/manage","method":"post"}]} />


# Get User Available Models

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-models-get-api-user-models-384083848.json"} operations={[{"path":"/api/user/models","method":"get"}]} />


# Delete Passkey

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/delete-api-user-passkey-delete-api-user-passkey-384083851.json"} operations={[{"path":"/api/user/passkey","method":"delete"}]} />


# Get Passkey Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login required (User permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-passkey-get-api-user-passkey-384083850.json"} operations={[{"path":"/api/user/passkey","method":"get"}]} />


# Start Passkey Registration

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permissions)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-passkey-register-begin-post-api-user-passkey-register-begin-384083852.json"} operations={[{"path":"/api/user/passkey/register/begin","method":"post"}]} />


# Complete Passkey Registration

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-passkey-register-finish-post-api-user-passkey-register-finish-384083853.json"} operations={[{"path":"/api/user/passkey/register/finish","method":"post"}]} />


# Start Passkey Verification

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-passkey-verify-begin-post-api-user-passkey-verify-begin-384083854.json"} operations={[{"path":"/api/user/passkey/verify/begin","method":"post"}]} />


# Complete Passkey Verification

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-passkey-verify-finish-post-api-user-passkey-verify-finish-384083855.json"} operations={[{"path":"/api/user/passkey/verify/finish","method":"post"}]} />


# Create User

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-post-api-user-384083861.json"} operations={[{"path":"/api/user/","method":"post"}]} />


# Update User

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/用户管理/put-api-user-put-api-user-384083862.json"} operations={[{"path":"/api/user/","method":"put"}]} />


# Search Users

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/用户管理/get-api-user-search-get-api-user-search-384083864.json"} operations={[{"path":"/api/user/search","method":"get"}]} />


# Delete Current User

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/delete-api-user-self-delete-api-user-self-384083847.json"} operations={[{"path":"/api/user/self","method":"delete"}]} />


# Get Current User Information

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-self-get-api-user-self-384083845.json"} operations={[{"path":"/api/user/self","method":"get"}]} />


# Get Current User Groups

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-self-groups-get-api-user-self-groups-384083844.json"} operations={[{"path":"/api/user/self/groups","method":"get"}]} />


# Update Current User Information

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/put-api-user-self-put-api-user-self-384083846.json"} operations={[{"path":"/api/user/self","method":"put"}]} />


# Update User Settings

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/put-api-user-setting-put-api-user-setting-384083858.json"} operations={[{"path":"/api/user/setting","method":"put"}]} />


# Generate Access Token

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

🔐 Login Required (User Permission)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-token-get-api-user-token-384083849.json"} operations={[{"path":"/api/user/token","method":"get"}]} />


# Admin Completes Top-up

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/用户管理/post-api-user-topup-complete-post-api-user-topup-complete-384083863.json"} operations={[{"path":"/api/user/topup/complete","method":"post"}]} />


# Get All Top-up Records

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions (Admin)

<APIPage document={"openapi/generated/management/用户管理/get-api-user-topup-get-api-user-topup-384083859.json"} operations={[{"path":"/api/user/topup","method":"get"}]} />


# Get All Vendors

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/供应商/get-api-vendors-get-api-vendors-384083947.json"} operations={[{"path":"/api/vendors/","method":"get"}]} />


# Delete Vendor

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin Permissions Required

<APIPage document={"openapi/generated/management/供应商/delete-api-vendors-id-delete-api-vendors-id-384083952.json"} operations={[{"path":"/api/vendors/{id}","method":"delete"}]} />


# Get Specific Vendor

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Administrator Permissions (Admin)

<APIPage document={"openapi/generated/management/供应商/get-api-vendors-id-get-api-vendors-id-384083951.json"} operations={[{"path":"/api/vendors/{id}","method":"get"}]} />


# Create Vendor

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin privileges required

<APIPage document={"openapi/generated/management/供应商/post-api-vendors-post-api-vendors-384083948.json"} operations={[{"path":"/api/vendors/","method":"post"}]} />


# Update Vendor

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Admin permissions required

<APIPage document={"openapi/generated/management/供应商/put-api-vendors-put-api-vendors-384083949.json"} operations={[{"path":"/api/vendors/","method":"put"}]} />


# Search Vendors

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

👨‍💼 Requires Admin Permissions

<APIPage document={"openapi/generated/management/供应商/get-api-vendors-search-get-api-vendors-search-384083950.json"} operations={[{"path":"/api/vendors/search","method":"get"}]} />


# Chat Settings



Here you can configure NewAPI's chat integration, using the following variables:

* `{key}`: Replaced with the key
* `{address}`: Replaced with the server address (without / and /v1 at the end)

<img alt="Chat Settings" src={__img0} placeholder="blur" />


# Data Dashboard







Here you can set up and enable the Data Dashboard, System Announcements, API Information Management, FAQ, and Uptime Kuma Monitoring.

<img alt="Data Dashboard 1" src={__img0} placeholder="blur" />

<img alt="Data Dashboard 2" src={__img1} placeholder="blur" />

<img alt="Data Dashboard 3" src={__img2} placeholder="blur" />


# Drawing Settings



Here you can adjust settings related to the drawing function.

<img alt="Drawing Settings" src={__img0} placeholder="blur" />


# Model-Related Settings







Here you can configure request passthrough, connection keep-alive, and settings for specific models.

<img alt="Model Settings 1" src={__img0} placeholder="blur" />
<img alt="Model Settings 2" src={__img1} placeholder="blur" />
<img alt="Model Settings 3" src={__img2} placeholder="blur" />


# Operational Settings







Here you can navigate to operational settings such as top-up links, documentation addresses, blocked words, logging, monitoring, and quotas.

<img alt="运营1" src={__img0} placeholder="blur" />
<img alt="运营2" src={__img1} placeholder="blur" />
<img alt="运营3" src={__img2} placeholder="blur" />


# Other Settings





Here you can check for NewAPI updates, set announcements, and customize pages.

<img alt="Other 1" src={__img0} placeholder="blur" />
<img alt="Other 2" src={__img1} placeholder="blur" />


# Payment Settings





Here you can configure settings related to the top-up function.

<img alt="Payment Settings" src={__img0} placeholder="blur" />

<img alt="Stripe" src={__img1} placeholder="blur" />

## Supported Payment Gateways

* **EPay**
  * Required fields: `API Address`, `Merchant ID (PID)`, `Merchant Key (KEY)`
  * The platform callback parameters include a signature, which the system will verify and automatically credit.
* **Stripe (Optional)**
  * Required fields: `API Key` `WebHook Signing Secret` `Product Price ID`

## What is EPay

`EPay` is a general term for the "third-party aggregated collection gateway/interface" model, not a specific website or company. It can refer to commercial aggregated payment services, or self-built/open-source gateway implementations that follow the "EPay protocol style".

* **Core Function**: Aggregates channels such as WeChat Pay, Alipay, and bank cards, providing merchants with unified order placement, signature verification, and callback interfaces.
* **Compliance Notice**: The gateway itself is not equivalent to a licensed payment institution; fund clearing, settlement, and compliance depend on the licensed channels it integrates with. Please adhere to local regulatory and risk control requirements.

## Top-up Method Settings Template

In "Top-up Methods", you can configure according to the following structure:

```json
[
  {
    "color": "rgba(var(--semi-blue-5), 1)",
    "name": "支付宝",
    "type": "alipay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "微信",
    "type": "wxpay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "Stripe",
    "type": "stripe",
    "min_topup": "50"
  },
  {
    "name": "自定义1",
    "color": "black",
    "type": "custom1",
    "min_topup": "50"
  }
]
```

### Field Description

* name: Display text. Shown on the "Select Payment Method" button (e.g., "Alipay/WeChat/Stripe/Custom1").
* color: Theme color or border color for buttons/badges. Supports any CSS color value, recommending existing design tokens (e.g., `rgba(var(--semi-blue-5), 1)`).
* type: Channel identifier, used for backend routing and order placement.
  * `stripe` → Uses Stripe gateway.
  * Others (e.g., `alipay`, `wxpay`, `custom1`, etc.) → Uses EPay-style gateway, and passes this value as a channel parameter.
  * Detailed logic can be found in the backend controller `controller/topup.go` (Reference: [controller/topup.go](https://github.com/QuantumNous/new-api/blob/main/controller/topup.go)).
* min\_topup: Minimum top-up amount (unit consistent with page currency). If the entered amount is less than this value, the page will prompt "The minimum top-up amount for this payment method is X" and restrict initiating payment; the backend will also perform validation.
* Order: Rendered from left to right according to array order.

## Top-up Amount Configuration

### Custom Top-up Amount Options

Set the top-up amount options available for users to choose, for example:

```json
[10, 20, 50, 100, 200, 500]
```

These values will be displayed in the "Select Top-up Quota" area, and users can directly click to select the corresponding top-up amount.

### Top-up Amount Discount Configuration

Set discounts corresponding to different top-up amounts, where the key is the top-up amount and the value is the discount rate, for example:

```json
{
  "100": 0.95,
  "200": 0.9,
  "500": 0.85
}
```

* Key: Top-up amount (string format)
* Value: Discount rate (decimal between 0-1, e.g., 0.95 means 95% of the price, i.e., 5% discount)
* The system will automatically calculate the actual payment amount and savings based on the configuration.
* Detailed implementation logic can be found in the backend controller [controller/topup.go](https://github.com/QuantumNous/new-api/blob/main/controller/topup.go)


# Rate Limit Settings



Here you can configure model request rate limit related settings.

Group Rate Limit Example:

```json
{
  "default": [200, 100],
  "vip": [0, 1000]
}
```

<img alt="Rate Limit Settings" src={__img0} placeholder="blur" />


# Ratio Settings











Ratio settings are a core configuration of the NewAPI billing system, allowing flexible control over the billing standards for various models and user groups by setting different ratios.

## Ratio System Overview

NewAPI uses a three-tier ratio system to calculate user quota consumption:

1. Model Ratio - Defines the base billing multiplier for different AI models
2. Completion Ratio - Applies additional billing adjustments to output tokens
3. Group Ratio - Sets differentiated billing multipliers for different user groups

### Relationship Between Quota and Ratios

In the New API system, ratios are key parameters for calculating quota consumption. Quota is an internal billing unit of the system, and all API calls are ultimately converted into quota points for deduction.

### Quota Unit Conversion:

* 1 USD = 500,000 quota points
* Quota points are the basic unit for internal system billing
* User balances and consumption records are based on quota points

### Quota Calculation Formulas

#### Pay-as-you-go Models (Based on Token Consumption)

```
配额消耗 = (输入token数 + 输出token数 × 补全倍率) × 模型倍率 × 分组倍率
```

#### Per-call Billing Models (Fixed Price)

```
配额消耗 = 模型固定价格 × 分组倍率 × 配额单位(500,000)
```

#### Audio Models (Special handling, automatically processed internally by NewAPI)

```
配额消耗 = (文本输入token + 文本输出token × 补全倍率 + 音频输入token × 音频倍率 + 音频输出token × 音频倍率 × 音频补全倍率) × 模型倍率 × 分组倍率
```

#### Pre-consumption and Post-consumption Mechanism

New API adopts a dual billing mechanism of pre-consumption and post-consumption:

1. **Pre-consumption phase**: Before an API call, quota consumption is calculated based on estimated token count and pre-deducted.
2. **Post-consumption phase**: After an API call is completed, quota consumption is recalculated based on the actual token count.
3. **Difference adjustment**: If the actual consumption differs from the pre-consumption, the system automatically adjusts the user's quota balance.

```
预消费配额 = 预估token数 × 模型倍率 × 分组倍率
实际配额 = 实际token数 × 模型倍率 × 分组倍率
配额调整 = 实际配额 - 预消费配额
```

## Model Ratio Settings

Model ratios define the base billing multipliers for different AI models, and the system pre-sets default ratios for various models.

### Common Model Ratio Examples

| Model Name    | Model Ratio | Completion Ratio | Official Price (Input) | Official Price (Output) |
| ------------- | ----------- | ---------------- | ---------------------- | ----------------------- |
| gpt-4o        | 1.25        | 4                | $2.5/1M Tokens         | $10/1M Tokens           |
| gpt-3.5-turbo | 0.25        | 1.33             | $0.5/1M Tokens         | $1.5/1M Tokens          |
| gpt-4o-mini   | 0.075       | 4                | $0.15/1M Tokens        | $0.6/1M Tokens          |
| o1            | 7.5         | 4                | $15/1M Tokens          | $60/1M Tokens           |

Ratio Meaning Explanation:

* Model Ratio: A multiplier relative to the base billing unit, reflecting cost differences between models
* Completion Ratio: The billing multiplier for output tokens relative to input tokens, reflecting output cost differences
* Higher ratios consume more quota; lower ratios consume less quota

### Setup Methods

1. JSON Format Setting: Directly edit the model ratio JSON configuration
2. Visual Editor: Set ratios via a graphical interface

<img alt="倍率1" src={__img0} placeholder="blur" />

## Completion Ratio Settings

Completion ratios are used for additional billing of output tokens, primarily to balance the input and output cost differences across various models.

### Default Completion Ratios

| Model Type    | Official Price (Input) | Official Price (Output) | Completion Ratio | Description        |
| ------------- | ---------------------- | ----------------------- | ---------------- | ------------------ |
| gpt-4o        | 2.5$/1M Tokens         | 10$/1M Tokens           | 4                | Output is 4x input |
| gpt-3.5-turbo | 0.5$/1M Tokens         | 1$/1M Tokens            | 2                | Output is 2x input |
| gpt-image-1   | 5$/1M Tokens           | 40$/1M Tokens           | 8                | Output is 8x input |
| gpt-4o-mini   | 0.15$/1M Tokens        | 0.6$/1M Tokens          | 4                | Output is 4x input |
| Other Models  | 1                      | 1                       | 1                | Output is 1x input |

### Setup Instructions

* Completion ratios primarily affect the billing of output tokens
* Setting to 1 means output token billing is the same as input token billing
* Greater than 1 means higher billing for output tokens, less than 1 means lower billing for output tokens

## Group Ratio Settings

Group ratios allow setting differentiated billing multipliers for different user groups, enabling flexible pricing strategies.

### Group Ratio Configuration

```json
{
  "vip": 0.5,
  "premium": 0.8,
  "standard": 1.0,
  "trial": 2.0
}
```

### Group Ratio Priority

1. User-specific Ratio: Personal ratio set for a specific user
2. Group Ratio: The ratio of the group the user belongs to
3. Default Ratio: System default ratio (usually 1.0)

<img alt="倍率2" src={__img1} placeholder="blur" />

## Visual Ratio Settings

The visual editor provides an intuitive ratio management interface, supporting:

* Batch editing of model ratios
* Real-time preview of ratio configurations
* Conflict detection and prompts
* One-click synchronization of upstream ratios

<img alt="倍率3" src={__img2} placeholder="blur" />

## Models Without Ratio Settings

For models without ratio settings, the system will:

1. Self-use mode: Use the default ratio of 37.5
2. Commercial mode: Prompt "Ratio or price not configured" error
3. Automatic detection: Display unconfigured models in the management interface

<img alt="倍率4" src={__img3} placeholder="blur" />

## Upstream Ratio Synchronization

The system supports automatic synchronization of ratio settings from upstream channels:

* Automatically retrieve upstream model ratios
* Batch update local ratio configurations
* Stay synchronized with upstream prices
* Supports manual adjustment and override

<img alt="倍率5" src={__img4} placeholder="blur" />

## Frequently Asked Questions

### Q: How to set ratios for new models?

A: You can add new models via the visual editor or directly in the JSON configuration. It is recommended to set a conservative ratio first and adjust it based on actual usage.

### Q: How do group ratios take effect?

A: Group ratios are multiplied by model ratios, ultimately affecting the calculation of user quota consumption. A user's effective ratio = Model Ratio × Group Ratio.

### Q: What is the purpose of the completion ratio?

A: The completion ratio is mainly used to balance the cost differences between input and output tokens. For some models, the output cost is significantly higher than the input cost, requiring adjustment via the completion ratio.

### Q: How to batch set ratios for similar models?

A: You can perform batch operations through the visual editor, or directly add ratio settings for similar models in bulk within the JSON configuration.

## Quota Calculation Examples

### Example 1: GPT-4 Standard User Conversation

#### Scenario Parameters:

* Input tokens: 1,000
* Output tokens: 500
* Model Ratio: 15
* Completion Ratio: 2
* Group Ratio: 1.0 (Standard user)

#### Calculation Process:

```
配额消耗 = (1,000 + 500 × 2) × 15 × 1.0
         = (1,000 + 1,000) × 15
         = 2,000 × 15
         = 30,000 配额点数
```

Equivalent USD Cost: 30,000 ÷ 500,000 = $0.06

### Example 2: GPT-3.5 VIP User Conversation

#### Scenario Parameters:

* Input tokens: 2,000
* Output tokens: 1,000
* Model Ratio: 0.25
* Completion Ratio: 1.33
* Group Ratio: 0.5 (VIP user 50% discount)

#### Calculation Process:

```
配额消耗 = (2,000 + 1,000 × 1.33) × 0.25 × 0.5
         = (2,000 + 1,330) × 0.125
         = 3,330 × 0.125
         = 416.25 配额点数
```

Equivalent USD Cost: 416.25 ÷ 500,000 = $0.00083

### Example 3: Per-call Billing Model (e.g., Midjourney)

#### Scenario Parameters:

* Model Fixed Price: $0.02
* Group Ratio: 1.0 (Standard user)
* Quota Unit: 500,000

#### Calculation Process:

```
配额消耗 = 0.02 × 1.0 × 500,000
         = 10,000 配额点数
```

Equivalent USD Cost: 10,000 ÷ 500,000 = $0.02

For more billing rules, please refer to [Frequently Asked Questions](/en/docs/support/faq)


# System Settings









Here you can configure NewAPI worker, mail server, and login and registration related settings.

<img alt="System Settings 1" src={__img0} placeholder="blur" />

<img alt="System Settings 2" src={__img1} placeholder="blur" />

<img alt="System Settings 3" src={__img2} placeholder="blur" />

<img alt="System Settings 4" src={__img3} placeholder="blur" />


# Analytics Tool Setup Guide

### Overview

New API now supports integration with popular analytics platforms to help you track user behavior and website performance:

* **Google Analytics 4 (GA4)**: The latest version of Google's analytics platform
* **Umami Analytics**: A privacy-focused, open-source analytics tool

Both analytics tools can be enabled simultaneously without conflict.

### Features

✅ Zero-code integration - configured solely via environment variables\
✅ Automatic script injection into the web interface\
✅ Supports Docker and standalone deployments\
✅ Privacy-focused implementation\
✅ No front-end code modification required

***

### Google Analytics 4 Setup

#### 1. Obtain Your Measurement ID

1. Visit [Google Analytics](https://analytics.google.com/)
2. Create a new property or select an existing one
3. Go to **Admin** → **Data Streams**
4. Create or select a web data stream
5. Copy your **Measurement ID** (format: `G-XXXXXXXXXX`)

#### 2. Configure Environment Variables

**Using Docker Compose:**

Edit the `docker-compose.yml` file and uncomment the Google Analytics line:

```yaml
environment:
  - GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX # Replace with your actual Measurement ID
```

**Standalone Deployment:**

Add to the `.env` file or set as an environment variable:

```bash
export GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX
```

**Using Docker Run:**

```bash
docker run -d \
  -e GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX \
  ...其他选项...
  calciumion/new-api:latest
```

#### 3. Restart the Application

```bash
# Docker Compose
docker-compose down && docker-compose up -d

# Standalone Deployment
# Directly restart your application
```

***

### Umami Analytics Setup

#### 1. Obtain Umami Credentials

**Option A: Using Umami Cloud**

1. Register on [Umami Cloud](https://cloud.umami.is/)
2. Add a new website
3. Copy your **Website ID** (UUID format)

**Option B: Self-hosting Umami**

1. Deploy your own [Umami instance](https://umami.is/docs/install)
2. Create a website in the dashboard
3. Copy your **Website ID** and **Script URL**

#### 2. Configure Environment Variables

**Using Docker Compose:**

Edit the `docker-compose.yml` file:

```yaml
environment:
  - UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  # Optional: Only required for self-hosted instances
  - UMAMI_SCRIPT_URL=https://<your-umami-domain>/script.js
```

**Standalone Deployment:**

Add to the `.env` file:

```bash
export UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export UMAMI_SCRIPT_URL=https://<your-umami-domain>/script.js  # Optional
```

**Note:** If using Umami Cloud, you do not need to set `UMAMI_SCRIPT_URL`, as it uses the official URL by default.

#### 3. Restart the Application

Same as Google Analytics - restart the application to apply changes.

***

### Using Both Analytics Tools Simultaneously

You can enable both Google Analytics and Umami simultaneously:

```yaml
environment:
  - GOOGLE_ANALYTICS_ID=G-ABC123XYZ
  - UMAMI_WEBSITE_ID=a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6
  - UMAMI_SCRIPT_URL=https://analytics.umami.is/script.js
```

***

### Verification

After restarting the application:

1. Open the web interface in your browser
2. Open browser developer tools (F12) → **Network** tab
3. Refresh the page
4. Look for the following requests:
   * Google Analytics: `https://www.googletagmanager.com/gtag/js`
   * Umami: Your configured script URL

You can also view the page source code and look for the injected scripts in the `<head>` section.

***

### Troubleshooting

**Analytics tools not working?**

1. ✅ Verify environment variables are set correctly
2. ✅ Restart the application after changing variables
3. ✅ Check browser console for errors
4. ✅ Ensure Measurement ID/Website ID format is correct
5. ✅ Check if ad blockers are interfering

**Docker Users:**

```bash
# Check if environment variables are set
docker exec new-api env | grep -E "GOOGLE_ANALYTICS|UMAMI"
```

***

### Privacy Considerations

* Google Analytics collects user data according to [Google's Privacy Policy](https://policies.google.com/privacy)
* Umami is privacy-focused and does not collect personal data
* If using analytics tools, consider adding a privacy policy to your website
* Both tools are GDPR compliant when configured correctly

***

## Environment Variable Reference

| Variable              | Required | Default Value                          | Description                                                |
| --------------------- | -------- | -------------------------------------- | ---------------------------------------------------------- |
| `GOOGLE_ANALYTICS_ID` | No       | -                                      | Google Analytics 4 Measurement ID (format: G-XXXXXXXXXX)   |
| `UMAMI_WEBSITE_ID`    | No       | -                                      | Umami Website ID (UUID format)                             |
| `UMAMI_SCRIPT_URL`    | No       | `https://analytics.umami.is/script.js` | Umami Script URL (only required for self-hosted instances) |

***

## Related Links

* [Google Analytics](https://analytics.google.com/)
* [Umami Analytics](https://umami.is/)
* [Umami Documentation](https://umami.is/docs)
* [Google Analytics Privacy](https://support.google.com/analytics/answer/6004245)


# Feature Description

1. 🎨 Brand new UI interface (some interfaces are still pending updates)
2. 🌍 Multi-language support (to be improved)
3. 🎨 Added [Midjourney-Proxy(Plus)](https://github.com/novicezk/midjourney-proxy) API support
4. 💰 Supports online top-up functionality, configurable in System Settings:
   * * [x] Epay
5. 🔍 Supports querying usage Quota by key:
   * In conjunction with the project [neko-api-key-tool](https://github.com/Calcium-Ion/neko-api-key-tool), querying usage by key can be achieved.
6. 📑 Pagination supports selecting the number of items displayed per page
7. 🔄 SQLite database storage support, ready to use out of the box, lightweight and convenient
8. 💵 Supports model billing by usage count, configurable in System Settings - Operation Settings
9. ⚖️ Supports **weighted random** Channel selection
10. 📈 Data Dashboard (Console)
11. 🔒 Configurable models that a Token can call
12. 🤖 Supports Telegram authorized login:
    1. System Settings - Configure Login & Registration - Allow login via Telegram
    2. Enter command /setdomain to [@Botfather](https://t.me/botfather)
    3. Select your bot, then enter http(s)://your\_website\_address/login
    4. The Telegram Bot Name is the bot username string without the @
13. 🎵 Added [Suno API](https://github.com/Suno-API/Suno-API) API support
14. 🔄 Supports Rerank models, currently compatible with Cohere and Jina, and can be integrated with Dify
15. ⚡ **[OpenAI Realtime API](https://platform.openai.com/docs/guides/realtime/integration)** - Supports OpenAI's Realtime API, supports Azure Channel
16. Supports using the route /chat2link to enter the chat interface
17. 🧠 Supports setting reasoning effort via model name suffix:
    1. OpenAI o-series models
       * * Add suffix `-high` to set as high reasoning effort (e.g.: `o3-mini-high`)
       * * Add suffix `-medium` to set as medium reasoning effort (e.g.: `o3-mini-medium`)
       * * Add suffix `-low` to set as low reasoning effort (e.g.: `o3-mini-low`)
    2. Claude thinking models
       * * Add suffix `-thinking` to enable thinking mode (e.g.: `claude-3-7-sonnet-20250219-thinking`)
18. 🔄 Thinking to Content, supports setting the `thinking_to_content` option in `Channel - Edit - Channel Extra Settings`, default `false`. When enabled, it will convert the thinking content `reasoning_content` into a `<think>` tag and append it to the returned content.
19. 🔄 Model Rate Limiting, supports setting model rate limits in `System Settings - Rate Limit Settings`, including total request count limit and successful request count limit.
20. 💰 Cache Billing Support, when enabled, billing can occur at a set Ratio upon cache hit:
    1. Set the Prompt Cache Ratio option in `System Settings - Operation Settings`
    2. Set the Prompt Cache Ratio in the Channel, range 0-1. For example, setting it to 0.5 means billing at 50% upon cache hit.
    3. Supported Channels:
       * * [x] OpenAI
       * * [x] Azure
       * * [x] DeepSeek
       * * [ ] Claude


# Performance Analysis Setup Guide

### Overview

New API provides two types of performance analysis capabilities:

* **pprof (Built-in)**: Suitable for temporary diagnosis and offline analysis
* **Pyroscope (Optional)**: Suitable for online continuous analysis and flame graph visualization

Both can be enabled simultaneously without conflict.

### Features

✅ Zero-code integration - configured solely via environment variables\
✅ Supports Docker and standalone deployment\
✅ Supports coexisting temporary diagnosis and continuous analysis\
✅ Optional authentication and instance differentiation

***

### pprof (Built-in) Setup

#### 1. Configure Environment Variables

**Using Docker Compose:**

```yaml
environment:
  - ENABLE_PPROF=true
```

**Standalone Deployment:**

```bash
export ENABLE_PPROF=true
```

#### 2. Restart Application

Restart the application to apply changes.

#### 3. Verification

If the route is not modified, it can usually be accessed at `/debug/pprof/` (subject to actual deployment).

***

### Pyroscope Setup

#### 1. Prepare Pyroscope Service

Ensure the Pyroscope service is accessible and record its address (e.g., `http://localhost:4040`).

#### 2. Configure Environment Variables

**Using Docker Compose:**

```yaml
environment:
  - PYROSCOPE_URL=http://localhost:4040
  - PYROSCOPE_APP_NAME=new-api
  - PYROSCOPE_BASIC_AUTH_USER=your-user
  - PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
  - PYROSCOPE_MUTEX_RATE=5
  - PYROSCOPE_BLOCK_RATE=5
  - HOSTNAME=your-hostname
```

**Standalone Deployment:**

```bash
export PYROSCOPE_URL=http://localhost:4040
export PYROSCOPE_APP_NAME=new-api
export PYROSCOPE_BASIC_AUTH_USER=your-user
export PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
export PYROSCOPE_MUTEX_RATE=5
export PYROSCOPE_BLOCK_RATE=5
export HOSTNAME=your-hostname
```

#### 3. Restart Application

Restart the application to apply changes.

#### 4. Verification

1. Open Pyroscope UI
2. Select the application corresponding to `PYROSCOPE_APP_NAME`
3. If `HOSTNAME` is set, sources can be differentiated by instance dimension

***

### Troubleshooting

**Performance analysis not working?**

1. ✅ Verify environment variables are set correctly
2. ✅ Restart the application after changing variables
3. ✅ Check network connectivity and authentication configuration
4. ✅ Confirm `PYROSCOPE_APP_NAME` naming consistency

**Docker Users:**

```bash
# Check env vars
docker exec new-api env | grep -E "PPROF|PYROSCOPE"
```

***

## Environment Variables Reference

| Variable                        | Required | Default Value | Description                       |
| ------------------------------- | -------- | ------------- | --------------------------------- |
| `ENABLE_PPROF`                  | No       | `false`       | Enable pprof performance analysis |
| `PYROSCOPE_URL`                 | No       | -             | Pyroscope service address         |
| `PYROSCOPE_APP_NAME`            | No       | -             | Pyroscope application identifier  |
| `PYROSCOPE_BASIC_AUTH_USER`     | No       | -             | Pyroscope Basic Auth username     |
| `PYROSCOPE_BASIC_AUTH_PASSWORD` | No       | -             | Pyroscope Basic Auth password     |
| `PYROSCOPE_MUTEX_RATE`          | No       | -             | Mutex sampling rate               |
| `PYROSCOPE_BLOCK_RATE`          | No       | -             | Block sampling rate               |
| `HOSTNAME`                      | No       | -             | Instance identifier (optional)    |

***

## Related Links

* [Pyroscope](https://pyroscope.io/)
* [Pyroscope Documentation](https://pyroscope.io/docs/)


# Project Introduction

import { Callout } from 'fumadocs-ui/components/callout';

<div className="my-8 text-center">
  <img src="/assets/logo.png" alt="New API Logo" className="mx-auto" width="120" height="120" />

  <h1 className="mt-4 mb-2 text-4xl font-bold">
    New API
  </h1>

  <img src="/assets/trendshift.svg" alt="NewAPI Trendshift Badge" className="mx-auto mt-4" style={{ width: '250px', height: '55px' }} width="250" height="55" />
</div>

## Overview

New API is a next-generation AI foundation platform, providing unified infrastructure for your AI applications. It hosts all AI applications, manages your digital assets, and connects to a future unified interface platform.

<Callout type="info">
  New API seamlessly integrates with mainstream global AI service providers, including OpenAI, Anthropic, Google
  Gemini, DeepSeek, Midjourney, Suno, and 30+ other model services.
</Callout>

### Core Features

* **Unified Interface**: A single API endpoint to access all AI services, compatible with OpenAI standard format
* **Intelligent Routing**: Multi-channel load balancing, automatic failover, weighted random distribution
* **Granular Billing**: Supports per-call/per-volume billing, prepaid top-ups, multi-ratio configuration
* **Security Control**: Token permission management, model access control, API call auditing
* **Data Insights**: Real-time dashboards, usage statistics, cost analysis
* **Multi-tenant Architecture**: Perfectly suited for individual developers, team collaboration, and enterprise-level deployment

## License

New API adopts the **GNU AGPLv3** open-source license, which can be used for free as long as the terms of the open-source license are followed.

<Callout type="warn">
  Before using New API, please read the complete license terms in the [Project
  LICENSE](https://github.com/QuantumNous/new-api/blob/main/LICENSE).
</Callout>

### Open Source License (AGPLv3)

Under AGPLv3, you are free to use, modify, and distribute New API.

**Key Terms:**

* Free to use, modify, and distribute
* Full license text: [GNU AGPLv3](https://www.gnu.org/licenses/agpl-3.0.html)
* **Core Obligation**: If you modify and deploy it as a network service (SaaS), you must provide the complete source code under AGPLv3

### Commercial Licensing

If your organization's policy does not permit the use of AGPLv3 licensed software, or if you wish to circumvent the open-source obligations of AGPLv3, please send an email to: [support@quantumnous.com](mailto:support@quantumnous.com)

### Contributions

All contributions to New API are licensed under AGPLv3.

**By submitting contributions, you agree that:**

* Your code is licensed under AGPLv3 to this project and all users
* You retain the copyright to your contributions

### Additional Terms

* License policies may be updated through official channels (GitHub, website)
* In case of dispute, please refer to the official [LICENSE](https://github.com/QuantumNous/new-api/blob/main/LICENSE) document

## Disclaimer

<Callout type="error">
  Before using New API, please read and understand these important statements.
</Callout>

**1. AI Provider Terms of Service**

Users must comply with all applicable AI provider terms of service, including [OpenAI Terms of Use](https://openai.com/policies/terms-of-use), Anthropic policies, and other relevant provider agreements.

**2. Educational and Personal Use**

This project is primarily intended for personal learning and research. Stability is not guaranteed, and official technical support may not be provided under the open-source license.

**3. AI Regulatory Compliance**

Users must comply with relevant AI regulations, including the [Interim Measures for the Management of Generative Artificial Intelligence Services](http://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm) and other applicable AI governance frameworks.

**4. Local Laws and Regulations**

Users are responsible for ensuring compliance with all local, national, and international laws and regulations applicable to their jurisdiction and use case.

<Callout type="warn">
  New API is provided "as is" without any warranties of any kind. Developers and maintainers are not liable for any damages or legal issues arising from the use of this software.
</Callout>


# Technical Architecture



<img alt="technical-architecture.svg" src={__img0} />


# Changelog

import { Callout } from 'fumadocs-ui/components/callout';

<Callout type="warn" title="Version Log Information · Data updated on 2025-11-14 01:31:26">
  For all historical versions, please visit the [GitHub Releases
  page](https://github.com/QuantumNous/new-api/releases). This page periodically
  fetches the latest updates from there.
</Callout>

## v0.9.20-patch.2

<Callout type="info" title="Latest Official Version · Released on 2025-11-12 17:24:49 (China Time)">
  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.20-patch.1...v0.9.20-patch.2](https://github.com/QuantumNous/new-api/compare/v0.9.20-patch.1...v0.9.20-patch.2)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.2/new-api-arm64-v0.9.20-patch.2">
        new-api-arm64-v0.9.20-patch.2
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.2/new-api-macos-v0.9.20-patch.2">
        new-api-macos-v0.9.20-patch.2
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.2/new-api-v0.9.20-patch.2">
        new-api-v0.9.20-patch.2
      </a>

      {' '}

      (56.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.2/new-api-v0.9.20-patch.2.exe">
        new-api-v0.9.20-patch.2.exe
      </a>

      {' '}

      (58.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20-patch.2.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20-patch.2.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.20-patch.1

<Callout type="note" title="Official Version · Released on 2025-11-11 21:46:34 (China Time)">
  ### What's Changed

  * fix GetChannelKey AdminAuth -> RootAuth by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2209](https://github.com/QuantumNous/new-api/pull/2209)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.20...v0.9.20-patch.1](https://github.com/QuantumNous/new-api/compare/v0.9.20...v0.9.20-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.1/new-api-arm64-v0.9.20-patch.1">
        new-api-arm64-v0.9.20-patch.1
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.1/new-api-macos-v0.9.20-patch.1">
        new-api-macos-v0.9.20-patch.1
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.1/new-api-v0.9.20-patch.1">
        new-api-v0.9.20-patch.1
      </a>

      {' '}

      (56.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20-patch.1/new-api-v0.9.20-patch.1.exe">
        new-api-v0.9.20-patch.1.exe
      </a>

      {' '}

      (58.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.20

<Callout type="note" title="Official Version · Released on 2025-11-11 21:45:27 (China Time)">
  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20/New-API-App.0.9.20.exe">
        New-API-App.0.9.20.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20/New-API-App.Setup.0.9.20.exe">
        New-API-App.Setup.0.9.20.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.20/new-api-v0.9.20.exe">
        new-api-v0.9.20.exe
      </a>

      {' '}

      (58.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.20.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.19

<Callout type="note" title="Official Version · Released on 2025-11-10 17:22:53 (China Time)">
  ### What's Changed

  * Fix the issue where viduq2 does not support reference video generation by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2204](https://github.com/QuantumNous/new-api/pull/2204)
  * feat: replicate channel flux model by @Sh1n3zZ in [https://github.com/QuantumNous/new-api/pull/2190](https://github.com/QuantumNous/new-api/pull/2190)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.18...v0.9.19](https://github.com/QuantumNous/new-api/compare/v0.9.18...v0.9.19)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/New-API-App.0.9.19.exe">
        New-API-App.0.9.19.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/New-API-App.Setup.0.9.19.exe">
        New-API-App.Setup.0.9.19.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/new-api-arm64-v0.9.19">
        new-api-arm64-v0.9.19
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/new-api-macos-v0.9.19">
        new-api-macos-v0.9.19
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/new-api-v0.9.19">
        new-api-v0.9.19
      </a>

      {' '}

      (56.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.19/new-api-v0.9.19.exe">
        new-api-v0.9.19.exe
      </a>

      {' '}

      (58.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.19.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.19.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.18

<Callout type="note" title="Official Version · Released on 2025-11-07 17:54:00 (China Time)">
  ### What's Changed

  * fix: tag splitting by whitespace by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2156](https://github.com/QuantumNous/new-api/pull/2156)
  * fix(channel): Return error instead of first key when no available key by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2188](https://github.com/QuantumNous/new-api/pull/2188)
  * feat: Allow setting a blacklist for not removing the thinking suffix by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2189](https://github.com/QuantumNous/new-api/pull/2189)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.17...v0.9.18](https://github.com/QuantumNous/new-api/compare/v0.9.17...v0.9.18)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/New-API-App.0.9.18.exe">
        New-API-App.0.9.18.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/New-API-App.Setup.0.9.18.exe">
        New-API-App.Setup.0.9.18.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/new-api-arm64-v0.9.18">
        new-api-arm64-v0.9.18
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/new-api-macos-v0.9.18">
        new-api-macos-v0.9.18
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/new-api-v0.9.18">
        new-api-v0.9.18
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.18/new-api-v0.9.18.exe">
        new-api-v0.9.18.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.18.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.18.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.17

<Callout type="note" title="Official Version · Released on 2025-11-06 20:20:28 (China Time)">
  ### What's Changed

  * feat: Default unlimited Quota for user-created Tokens in EditTokenModal by @zhaolion in [https://github.com/QuantumNous/new-api/pull/2182](https://github.com/QuantumNous/new-api/pull/2182)
  * feat: add environment variable switch for critical rate limit by @LeonDevLifeLog in [https://github.com/QuantumNous/new-api/pull/2178](https://github.com/QuantumNous/new-api/pull/2178)
  * fix: trim suffix p for jimeng image model by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2168](https://github.com/QuantumNous/new-api/pull/2168)
  * fix playground by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2153](https://github.com/QuantumNous/new-api/pull/2153)
  * feat: openai custom tool by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2157](https://github.com/QuantumNous/new-api/pull/2157)
  * feat: EditTagModal header && param by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2159](https://github.com/QuantumNous/new-api/pull/2159)

  ### New Contributors

  * @zhaolion made their first contribution in [https://github.com/QuantumNous/new-api/pull/2182](https://github.com/QuantumNous/new-api/pull/2182)
  * @LeonDevLifeLog made their first contribution in [https://github.com/QuantumNous/new-api/pull/2178](https://github.com/QuantumNous/new-api/pull/2178)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.16...v0.9.17](https://github.com/QuantumNous/new-api/compare/v0.9.16...v0.9.17)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/New-API-App.0.9.17.exe">
        New-API-App.0.9.17.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/New-API-App.Setup.0.9.17.exe">
        New-API-App.Setup.0.9.17.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/new-api-arm64-v0.9.17">
        new-api-arm64-v0.9.17
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/new-api-macos-v0.9.17">
        new-api-macos-v0.9.17
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/new-api-v0.9.17">
        new-api-v0.9.17
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.17/new-api-v0.9.17.exe">
        new-api-v0.9.17.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.17.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.17.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.16-patch.1

<Callout type="note" title="Official Version · Released on 2025-11-05 14:50:56 (China Time)">
  ### What's Changed

  * Fix Jimeng v30-pro video generation failure by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2167](https://github.com/QuantumNous/new-api/pull/2167)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.16...v0.9.16-patch.1](https://github.com/QuantumNous/new-api/compare/v0.9.16...v0.9.16-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16-patch.1/new-api-arm64-v0.9.16-patch.1">
        new-api-arm64-v0.9.16-patch.1
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16-patch.1/new-api-macos-v0.9.16-patch.1">
        new-api-macos-v0.9.16-patch.1
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16-patch.1/new-api-v0.9.16-patch.1">
        new-api-v0.9.16-patch.1
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16-patch.1/new-api-v0.9.16-patch.1.exe">
        new-api-v0.9.16-patch.1.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.16-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.16-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.16

<Callout type="note" title="Official Version · Released on 2025-11-04 14:58:18 (China Time)">
  ### What's Changed

  * feat: claude 1h cache by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2155](https://github.com/QuantumNous/new-api/pull/2155)
  * fix: openai audio model streaming mode not correctly billed by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2160](https://github.com/QuantumNous/new-api/pull/2160)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.15...v0.9.16](https://github.com/QuantumNous/new-api/compare/v0.9.15...v0.9.16)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/New-API-App.0.9.16.exe">
        New-API-App.0.9.16.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/New-API-App.Setup.0.9.16.exe">
        New-API-App.Setup.0.9.16.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/new-api-arm64-v0.9.16">
        new-api-arm64-v0.9.16
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/new-api-macos-v0.9.16">
        new-api-macos-v0.9.16
      </a>

      {' '}

      (69.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/new-api-v0.9.16">
        new-api-v0.9.16
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.16/new-api-v0.9.16.exe">
        new-api-v0.9.16.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.16.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.16.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.15-patch.2

<Callout type="note" title="Official Version · Released on 2025-11-01 14:34:32 (China Time)">
  feat: Qwen image editing multi-image support

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.2/new-api-arm64-v0.9.15-patch.2">
        new-api-arm64-v0.9.15-patch.2
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.2/new-api-macos-v0.9.15-patch.2">
        new-api-macos-v0.9.15-patch.2
      </a>

      {' '}

      (69.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.2/new-api-v0.9.15-patch.2">
        new-api-v0.9.15-patch.2
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.2/new-api-v0.9.15-patch.2.exe">
        new-api-v0.9.15-patch.2.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15-patch.2.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15-patch.2.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.15-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-31 22:41:42 (China Time)">
  feat: Improve Ali Wan video generation billing

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.1/new-api-arm64-v0.9.15-patch.1">
        new-api-arm64-v0.9.15-patch.1
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.1/new-api-macos-v0.9.15-patch.1">
        new-api-macos-v0.9.15-patch.1
      </a>

      {' '}

      (69.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.1/new-api-v0.9.15-patch.1">
        new-api-v0.9.15-patch.1
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15-patch.1/new-api-v0.9.15-patch.1.exe">
        new-api-v0.9.15-patch.1.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.15

<Callout type="note" title="Official Version · Released on 2025-10-31 16:53:05 (China Time)">
  ### What's Changed

  * fix: correct topUp link by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2124](https://github.com/QuantumNous/new-api/pull/2124)
  * feat: Gemini Channel supports Veo video generation by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2075](https://github.com/QuantumNous/new-api/pull/2075)
  * feat: add ali wan video by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2141](https://github.com/QuantumNous/new-api/pull/2141)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.14...v0.9.15](https://github.com/QuantumNous/new-api/compare/v0.9.14...v0.9.15)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/New-API-App.0.9.15.exe">
        New-API-App.0.9.15.exe
      </a>

      {' '}

      (95.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/New-API-App.Setup.0.9.15.exe">
        New-API-App.Setup.0.9.15.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/new-api-arm64-v0.9.15">
        new-api-arm64-v0.9.15
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/new-api-macos-v0.9.15">
        new-api-macos-v0.9.15
      </a>

      {' '}

      (69.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/new-api-v0.9.15">
        new-api-v0.9.15
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.15/new-api-v0.9.15.exe">
        new-api-v0.9.15.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.15.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.14-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-30 21:17:39 (China Time)">
  Fix the invalid false proposition of playground Group selection

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14-patch.1/new-api-arm64-v0.9.14-patch.1">
        new-api-arm64-v0.9.14-patch.1
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14-patch.1/new-api-macos-v0.9.14-patch.1">
        new-api-macos-v0.9.14-patch.1
      </a>

      {' '}

      (69.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14-patch.1/new-api-v0.9.14-patch.1">
        new-api-v0.9.14-patch.1
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14-patch.1/new-api-v0.9.14-patch.1.exe">
        new-api-v0.9.14-patch.1.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.14-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.14-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.14

<Callout type="note" title="Official Version · Released on 2025-10-29 23:59:01 (China Time)">
  ### What's Changed

  * feat(language): add Japanese language support by @Calcium-Ion in [https://github.com/QuantumNous/new-api/pull/2131](https://github.com/QuantumNous/new-api/pull/2131)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.13...v0.9.14](https://github.com/QuantumNous/new-api/compare/v0.9.13...v0.9.14)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/New-API-App.0.9.14.exe">
        New-API-App.0.9.14.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/New-API-App.Setup.0.9.14.exe">
        New-API-App.Setup.0.9.14.exe
      </a>

      {' '}

      (95.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/new-api-arm64-v0.9.14">
        new-api-arm64-v0.9.14
      </a>

      {' '}

      (54.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/new-api-macos-v0.9.14">
        new-api-macos-v0.9.14
      </a>

      {' '}

      (69.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/new-api-v0.9.14">
        new-api-v0.9.14
      </a>

      {' '}

      (56.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.14/new-api-v0.9.14.exe">
        new-api-v0.9.14.exe
      </a>

      {' '}

      (58.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.14.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.14.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.13

<Callout type="note" title="Official Version · Released on 2025-10-29 23:39:40 (China Time)">
  ### What's Changed

  * feat: Adapt SiliconFlow Channel speech-to-text model

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.12...v0.9.13](https://github.com/QuantumNous/new-api/compare/v0.9.12...v0.9.13)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/New-API-App.0.9.13.exe">
        New-API-App.0.9.13.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/New-API-App.Setup.0.9.13.exe">
        New-API-App.Setup.0.9.13.exe
      </a>

      {' '}

      (95.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/new-api-arm64-v0.9.13">
        new-api-arm64-v0.9.13
      </a>

      {' '}

      (54.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/new-api-macos-v0.9.13">
        new-api-macos-v0.9.13
      </a>

      {' '}

      (69.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/new-api-v0.9.13">
        new-api-v0.9.13
      </a>

      {' '}

      (56.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.13/new-api-v0.9.13.exe">
        new-api-v0.9.13.exe
      </a>

      {' '}

      (57.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.13.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.13.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.12-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-29 20:03:39 (China Time)">
  ### What's Changed

  * fix: Randomly select Channel when totalWeight is less than or equal to 0 by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2126](https://github.com/QuantumNous/new-api/pull/2126)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.12...v0.9.12-patch.1](https://github.com/QuantumNous/new-api/compare/v0.9.12...v0.9.12-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12-patch.1/new-api-arm64-v0.9.12-patch.1">
        new-api-arm64-v0.9.12-patch.1
      </a>

      {' '}

      (54.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12-patch.1/new-api-macos-v0.9.12-patch.1">
        new-api-macos-v0.9.12-patch.1
      </a>

      {' '}

      (69.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12-patch.1/new-api-v0.9.12-patch.1">
        new-api-v0.9.12-patch.1
      </a>

      {' '}

      (56.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12-patch.1/new-api-v0.9.12-patch.1.exe">
        new-api-v0.9.12-patch.1.exe
      </a>

      {' '}

      (57.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.12-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.12-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.12

<Callout type="note" title="Official Version · Released on 2025-10-29 17:55:39 (China Time)">
  ### What's Changed

  * feat(i-18n): Add Japanese localization by @LainCyberia in [https://github.com/QuantumNous/new-api/pull/2109](https://github.com/QuantumNous/new-api/pull/2109)
  * feat: topUp show correct symbol by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2111](https://github.com/QuantumNous/new-api/pull/2111)
  * feat: aws client supports proxy settings by @wuhan005 in [https://github.com/QuantumNous/new-api/pull/2107](https://github.com/QuantumNous/new-api/pull/2107)
  * chore: Update AWS claude 4.5 haiku model's information by @HynoR in [https://github.com/QuantumNous/new-api/pull/2098](https://github.com/QuantumNous/new-api/pull/2098)
  * chore: Ignore .zed and debug binaries in .gitignore by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2084](https://github.com/QuantumNous/new-api/pull/2084)
  * feat: add image handling to image request for form-data by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2092](https://github.com/QuantumNous/new-api/pull/2092)
  * feat: vertex veo sora-compatible video output by @Sh1n3zZ in [https://github.com/QuantumNous/new-api/pull/2102](https://github.com/QuantumNous/new-api/pull/2102)
  * Added Creem payment by @littlewrite in [https://github.com/QuantumNous/new-api/pull/1823](https://github.com/QuantumNous/new-api/pull/1823)
  * fix: test channel frequency by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2119](https://github.com/QuantumNous/new-api/pull/2119)
  * feat: add special user usable Group setting by @Calcium-Ion in [https://github.com/QuantumNous/new-api/pull/2121](https://github.com/QuantumNous/new-api/pull/2121)

  ### New Contributors

  * @LainCyberia made their first contribution in [https://github.com/QuantumNous/new-api/pull/2109](https://github.com/QuantumNous/new-api/pull/2109)
  * @wuhan005 made their first contribution in [https://github.com/QuantumNous/new-api/pull/2107](https://github.com/QuantumNous/new-api/pull/2107)
  * @littlewrite made their first contribution in [https://github.com/QuantumNous/new-api/pull/1823](https://github.com/QuantumNous/new-api/pull/1823)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.11...v0.9.12](https://github.com/QuantumNous/new-api/compare/v0.9.11...v0.9.12)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/New-API-App.0.9.12.exe">
        New-API-App.0.9.12.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/New-API-App.Setup.0.9.12.exe">
        New-API-App.Setup.0.9.12.exe
      </a>

      {' '}

      (95.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/new-api-arm64-v0.9.12">
        new-api-arm64-v0.9.12
      </a>

      {' '}

      (54.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/new-api-macos-v0.9.12">
        new-api-macos-v0.9.12
      </a>

      {' '}

      (69.1 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/new-api-v0.9.12">
        new-api-v0.9.12
      </a>

      {' '}

      (56.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.12/new-api-v0.9.12.exe">
        new-api-v0.9.12.exe
      </a>

      {' '}

      (57.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.12.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.12.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.11

<Callout type="note" title="Official Version · Released on 2025-10-28 15:51:51 (China Time)">
  ### What's Changed

  * Remove ffmpeg
  * Add MiniMax Speech Synthesis TTS support by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2081](https://github.com/QuantumNous/new-api/pull/2081)
  * Ali Channel support stream options by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2070](https://github.com/QuantumNous/new-api/pull/2070)
  * feat: openai tts support streaming realtime audio by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2086](https://github.com/QuantumNous/new-api/pull/2086)
  * feat: doubao tts support streaming realtime audio by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2087](https://github.com/QuantumNous/new-api/pull/2087)
  * Fix Doubao image editing (image-to-image) function by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2090](https://github.com/QuantumNous/new-api/pull/2090)
  * fix: correct bool value for watermark by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2103](https://github.com/QuantumNous/new-api/pull/2103)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.10...v0.9.11](https://github.com/QuantumNous/new-api/compare/v0.9.10...v0.9.11)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/New-API-App.0.9.11.exe">
        New-API-App.0.9.11.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/New-API-App.Setup.0.9.11.exe">
        New-API-App.Setup.0.9.11.exe
      </a>

      {' '}

      (95.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/new-api-arm64-v0.9.11">
        new-api-arm64-v0.9.11
      </a>

      {' '}

      (54.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/new-api-macos-v0.9.11">
        new-api-macos-v0.9.11
      </a>

      {' '}

      (69.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/new-api-v0.9.11">
        new-api-v0.9.11
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.11/new-api-v0.9.11.exe">
        new-api-v0.9.11.exe
      </a>

      {' '}

      (57.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.11.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.11.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.10

<Callout type="note" title="Official Version · Released on 2025-10-18 15:43:48 (China Time)">
  ### What's Changed

  * feat: Add support for Doubao Speech Synthesis 2.0 function by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2067](https://github.com/QuantumNous/new-api/pull/2067)
  * fix: gemini batch embedding Token not counted by @creamlike1024 in [https://github.com/QuantumNous/new-api/pull/2061](https://github.com/QuantumNous/new-api/pull/2061)
  * fix: handle JSON parsing for thinking content in ollama stream by @somnifex in [https://github.com/QuantumNous/new-api/pull/2065](https://github.com/QuantumNous/new-api/pull/2065)
  * feat: Doubao Speech 2.0 voice supports emotion, mood, volume by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2068](https://github.com/QuantumNous/new-api/pull/2068)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.9...v0.9.10](https://github.com/QuantumNous/new-api/compare/v0.9.9...v0.9.10)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/New-API-App.0.9.10.exe">
        New-API-App.0.9.10.exe
      </a>

      {' '}

      (94.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/New-API-App.Setup.0.9.10.exe">
        New-API-App.Setup.0.9.10.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/new-api-arm64-v0.9.10">
        new-api-arm64-v0.9.10
      </a>

      {' '}

      (53.6 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/new-api-macos-v0.9.10">
        new-api-macos-v0.9.10
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/new-api-v0.9.10">
        new-api-v0.9.10
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.10/new-api-v0.9.10.exe">
        new-api-v0.9.10.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.10.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.10.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.9-patch.4

<Callout type="note" title="Official Version · Released on 2025-10-17 13:55:44 (China Time)">
  feat: Fool-proofing optimization, allow OpenAI Channels to call Sora asynchronous tasks

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.4/new-api-arm64-v0.9.9-patch.4">
        new-api-arm64-v0.9.9-patch.4
      </a>

      {' '}

      (53.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.4/new-api-macos-v0.9.9-patch.4">
        new-api-macos-v0.9.9-patch.4
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.4/new-api-v0.9.9-patch.4">
        new-api-v0.9.9-patch.4
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.4/new-api-v0.9.9-patch.4.exe">
        new-api-v0.9.9-patch.4.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.4.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.4.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.9-patch.3

<Callout type="note" title="Official Version · Released on 2025-10-16 22:02:17 (China Time)">
  feat: Add pay-per-use solution for the Sora model

  ### How to Use

  Environment variable setting `TASK_PRICE_PATCH=sora-2,sora-2-pro`
  This applies to all task operations, with model names separated by English commas `,`.
  After setting, tasks will not be automatically calculated by duration, size, etc.

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.3/new-api-arm64-v0.9.9-patch.3">
        new-api-arm64-v0.9.9-patch.3
      </a>

      {' '}

      (53.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.3/new-api-macos-v0.9.9-patch.3">
        new-api-macos-v0.9.9-patch.3
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.3/new-api-v0.9.9-patch.3">
        new-api-v0.9.9-patch.3
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.3/new-api-v0.9.9-patch.3.exe">
        new-api-v0.9.9-patch.3.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.3.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.3.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.9-patch.2

<Callout type="note" title="Official Version · Released on 2025-10-16 12:39:39 (China Time)">
  fix: Fix the issue of not refunding for /v1/videos failure

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.2/new-api-arm64-v0.9.9-patch.2">
        new-api-arm64-v0.9.9-patch.2
      </a>

      {' '}

      (53.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.2/new-api-macos-v0.9.9-patch.2">
        new-api-macos-v0.9.9-patch.2
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.2/new-api-v0.9.9-patch.2">
        new-api-v0.9.9-patch.2
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.2/new-api-v0.9.9-patch.2.exe">
        new-api-v0.9.9-patch.2.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.2.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.2.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.9-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-15 21:50:09 (China Time)">
  fix: Fix the issue where Gemini embedding cannot be used

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.1/new-api-arm64-v0.9.9-patch.1">
        new-api-arm64-v0.9.9-patch.1
      </a>

      {' '}

      (53.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.1/new-api-macos-v0.9.9-patch.1">
        new-api-macos-v0.9.9-patch.1
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.1/new-api-v0.9.9-patch.1">
        new-api-v0.9.9-patch.1
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9-patch.1/new-api-v0.9.9-patch.1.exe">
        new-api-v0.9.9-patch.1.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.9

<Callout type="note" title="Official Version · Released on 2025-10-15 19:49:01 (China Time)">
  feat: Fix the issue where the AWS Channel -thinking suffix does not take effect
  feat: Support AWS Channel using API key
  feat: Support AWS Channel using linked media

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/New-API-App.0.9.9.exe">
        New-API-App.0.9.9.exe
      </a>

      {' '}

      (94.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/New-API-App.Setup.0.9.9.exe">
        New-API-App.Setup.0.9.9.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/new-api-arm64-v0.9.9">
        new-api-arm64-v0.9.9
      </a>

      {' '}

      (53.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/new-api-macos-v0.9.9">
        new-api-macos-v0.9.9
      </a>

      {' '}

      (67.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/new-api-v0.9.9">
        new-api-v0.9.9
      </a>

      {' '}

      (55.4 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.9/new-api-v0.9.9.exe">
        new-api-v0.9.9.exe
      </a>

      {' '}

      (57.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.9.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.8-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-14 23:04:27 (China Time)">
  feat: Sora task optimization

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/New-API-App.0.9.8-patch.1.exe">
        New-API-App.0.9.8-patch.1.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/New-API-App.Setup.0.9.8-patch.1.exe">
        New-API-App.Setup.0.9.8-patch.1.exe
      </a>

      {' '}

      (94.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/new-api-arm64-v0.9.8-patch.1">
        new-api-arm64-v0.9.8-patch.1
      </a>

      {' '}

      (52.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/new-api-macos-v0.9.8-patch.1">
        new-api-macos-v0.9.8-patch.1
      </a>

      {' '}

      (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/new-api-v0.9.8-patch.1">
        new-api-v0.9.8-patch.1
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8-patch.1/new-api-v0.9.8-patch.1.exe">
        new-api-v0.9.8-patch.1.exe
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.8-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.8-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.8

<Callout type="note" title="Official Version · Released on 2025-10-14 17:46:39 (China Time)">
  ### What's Changed

  * feat: jimeng use openai sdk input\_reference i2v by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2029](https://github.com/QuantumNous/new-api/pull/2029)
  * fix: Video tasks in different Groups may lead to incorrect Quota recalculation by @xyfacai in [https://github.com/QuantumNous/new-api/pull/2030](https://github.com/QuantumNous/new-api/pull/2030)
  * feat: jimeng images base64 limit by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2032](https://github.com/QuantumNous/new-api/pull/2032)
  * fix(convert): Fix format issue with thinking blocks when converting OpenAI to Claude stream by @Inblac in [https://github.com/QuantumNous/new-api/pull/2035](https://github.com/QuantumNous/new-api/pull/2035)
  * feat: Add automatic conversion support for SiliconFlow image generation interface by @etnAtker in [https://github.com/QuantumNous/new-api/pull/2036](https://github.com/QuantumNous/new-api/pull/2036)
  * feat: endpoint type log by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2038](https://github.com/QuantumNous/new-api/pull/2038)
  * feat: Support Google Analytics and Umami Analytics

  ### Google Analytics Setup Documentation

  [https://docs.newapi.pro/wiki/analytics-setup/](https://docs.newapi.pro/wiki/analytics-setup/)

  ### New Contributors

  * @Inblac made their first contribution in [https://github.com/QuantumNous/new-api/pull/2035](https://github.com/QuantumNous/new-api/pull/2035)
  * @etnAtker made their first contribution in [https://github.com/QuantumNous/new-api/pull/2036](https://github.com/QuantumNous/new-api/pull/2036)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.7...v0.9.8](https://github.com/QuantumNous/new-api/compare/v0.9.7...v0.9.8)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/New-API-App.0.9.8.exe">
        New-API-App.0.9.8.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/New-API-App.Setup.0.9.8.exe">
        New-API-App.Setup.0.9.8.exe
      </a>

      {' '}

      (94.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/new-api-arm64-v0.9.8">
        new-api-arm64-v0.9.8
      </a>

      {' '}

      (52.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/new-api-macos-v0.9.8">
        new-api-macos-v0.9.8
      </a>

      {' '}

      (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/new-api-v0.9.8">
        new-api-v0.9.8
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.8/new-api-v0.9.8.exe">
        new-api-v0.9.8.exe
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.8.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.8.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.7-patch.2

<Callout type="note" title="Official Version · Released on 2025-10-13 15:19:00 (China Time)">
  ### What's Changed

  * fix: empty version by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2024](https://github.com/QuantumNous/new-api/pull/2024)
  * feat: Add pre-status protection for IncreaseUserQuota by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2025](https://github.com/QuantumNous/new-api/pull/2025)
  * refactor: Openai video model moved to dto by @xyfacai in [https://github.com/QuantumNous/new-api/pull/2027](https://github.com/QuantumNous/new-api/pull/2027)
  * feat: jimeng use openai sdk input\_reference i2v by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2029](https://github.com/QuantumNous/new-api/pull/2029)
  * fix: Video tasks in different Groups may lead to incorrect Quota recalculation by @xyfacai in [https://github.com/QuantumNous/new-api/pull/2030](https://github.com/QuantumNous/new-api/pull/2030)
  * feat: jimeng images base64 limit by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2032](https://github.com/QuantumNous/new-api/pull/2032)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.7-patch.1...v0.9.7-patch.2](https://github.com/QuantumNous/new-api/compare/v0.9.7-patch.1...v0.9.7-patch.2)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/New-API-App.0.9.7-patch.2.exe">
        New-API-App.0.9.7-patch.2.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/New-API-App.Setup.0.9.7-patch.2.exe">
        New-API-App.Setup.0.9.7-patch.2.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/new-api-arm64-v0.9.7-patch.2">
        new-api-arm64-v0.9.7-patch.2
      </a>

      {' '}

      (52.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/new-api-macos-v0.9.7-patch.2">
        new-api-macos-v0.9.7-patch.2
      </a>

      {' '}

      (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/new-api-v0.9.7-patch.2">
        new-api-v0.9.7-patch.2
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.2/new-api-v0.9.7-patch.2.exe">
        new-api-v0.9.7-patch.2.exe
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7-patch.2.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7-patch.2.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.7-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-12 13:57:48 (China Time)">
  ### What's Changed

  * fix: ignore ghcr by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2022](https://github.com/QuantumNous/new-api/pull/2022)
  * fix: version by @seefs001 in [https://github.com/QuantumNous/new-api/pull/2023](https://github.com/QuantumNous/new-api/pull/2023)
  * feat: feat: support free model setting

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.7...v0.9.7-patch.1](https://github.com/QuantumNous/new-api/compare/v0.9.7...v0.9.7-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/New-API-App.0.9.7-patch.1.exe">
        New-API-App.0.9.7-patch.1.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/New-API-App.Setup.0.9.7-patch.1.exe">
        New-API-App.Setup.0.9.7-patch.1.exe
      </a>

      {' '}

      (95.0 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/new-api-arm64-v0.9.7-patch.1">
        new-api-arm64-v0.9.7-patch.1
      </a>

      {' '}

      (52.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/new-api-macos-v0.9.7-patch.1">
        new-api-macos-v0.9.7-patch.1
      </a>

      {' '}

      (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/new-api-v0.9.7-patch.1">
        new-api-v0.9.7-patch.1
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7-patch.1/new-api-v0.9.7-patch.1.exe">
        new-api-v0.9.7-patch.1.exe
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.7

<Callout type="note" title="Official Version · Released on 2025-10-12 12:33:35 (China Time)">
  ### What's Changed

  * feat: complete English, French and Russian translation and add i18n configuration by @Sacode in [https://github.com/QuantumNous/new-api/pull/1991](https://github.com/QuantumNous/new-api/pull/1991)
  * feat: Jimeng and Vidu support OpenAI SDK for video generation and querying by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2018](https://github.com/QuantumNous/new-api/pull/2018)

  ### New Contributors

  * @Sacode made their first contribution in [https://github.com/QuantumNous/new-api/pull/1991](https://github.com/QuantumNous/new-api/pull/1991)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.6...v0.9.7](https://github.com/QuantumNous/new-api/compare/v0.9.6...v0.9.7)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/New-API-App.0.9.7.exe">
        New-API-App.0.9.7.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/New-API-App.Setup.0.9.7.exe">
        New-API-App.Setup.0.9.7.exe
      </a>

      {' '}

      (94.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/new-api-arm64-v0.9.7">
        new-api-arm64-v0.9.7
      </a>

      {' '}

      (52.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/new-api-macos-v0.9.7">
        new-api-macos-v0.9.7
      </a>

      {' '}

      (66.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/new-api-v0.9.7">
        new-api-v0.9.7
      </a>

      {' '}

      (54.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.7/new-api-v0.9.7.exe">
        new-api-v0.9.7.exe
      </a>

      {' '}

      (56.2 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.7.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.6-patch.1

<Callout type="note" title="Official Version · Released on 2025-10-11 12:04:44 (China Time)">
  ### What's Changed

  * fix(channel): handle dynamic frequency updates by @qixing-jk in [https://github.com/QuantumNous/new-api/pull/2002](https://github.com/QuantumNous/new-api/pull/2002)
  * Support Keling using OpenAI SDK for video generation by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2004](https://github.com/QuantumNous/new-api/pull/2004)
  * feat: Sora: Add parameter validation and billing by @xyfacai in [https://github.com/QuantumNous/new-api/pull/2006](https://github.com/QuantumNous/new-api/pull/2006)

  ### New Contributors

  * @qixing-jk made their first contribution in [https://github.com/QuantumNous/new-api/pull/2002](https://github.com/QuantumNous/new-api/pull/2002)

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.6...v0.9.6-patch.1](https://github.com/QuantumNous/new-api/compare/v0.9.6...v0.9.6-patch.1)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/New-API-App.0.9.6-patch.1.exe">
        New-API-App.0.9.6-patch.1.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/New-API-App.Setup.0.9.6-patch.1.exe">
        New-API-App.Setup.0.9.6-patch.1.exe
      </a>

      {' '}

      (94.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/new-api-arm64-v0.9.6-patch.1">
        new-api-arm64-v0.9.6-patch.1
      </a>

      {' '}

      (52.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/new-api-macos-v0.9.6-patch.1">
        new-api-macos-v0.9.6-patch.1
      </a>

      {' '}

      (66.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/new-api-v0.9.6-patch.1">
        new-api-v0.9.6-patch.1
      </a>

      {' '}

      (54.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6-patch.1/new-api-v0.9.6-patch.1.exe">
        new-api-v0.9.6-patch.1.exe
      </a>

      {' '}

      (55.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.6-patch.1.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.6-patch.1.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***

## v0.9.6

<Callout type="note" title="Official Version · Released on 2025-10-10 19:41:44 (China Time)">
  ### What's Changed

  * fix: avoid get model consuming body by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/1994](https://github.com/QuantumNous/new-api/pull/1994)
  * fix: test model #1993 by @seefs001 in [https://github.com/QuantumNous/new-api/pull/1995](https://github.com/QuantumNous/new-api/pull/1995)
  * Feat: user agreement and privacy policy settings by @kyubibii in [https://github.com/QuantumNous/new-api/pull/1981](https://github.com/QuantumNous/new-api/pull/1981)
  * fix: channel remark ignore issue by @seefs001 in [https://github.com/QuantumNous/new-api/pull/1996](https://github.com/QuantumNous/new-api/pull/1996)
  * fix: Support Sora as an upstream Channel by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/1997](https://github.com/QuantumNous/new-api/pull/1997)
  * feat: pplx channel by @seefs001 in [https://github.com/QuantumNous/new-api/pull/1998](https://github.com/QuantumNous/new-api/pull/1998)
  * feat: add qwen channel auto disabled by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/1401](https://github.com/QuantumNous/new-api/pull/1401)
  * feat: support openAI sdk retrieve videos by @feitianbubu in [https://github.com/QuantumNous/new-api/pull/2000](https://github.com/QuantumNous/new-api/pull/2000)

  ### Key Changes

  Fix the Sora Channel bug

  **Full Changelog**: [https://github.com/QuantumNous/new-api/compare/v0.9.5...v0.9.6](https://github.com/QuantumNous/new-api/compare/v0.9.5...v0.9.6)

  **Download Resources**

  <ul>
    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/New-API-App.0.9.6.exe">
        New-API-App.0.9.6.exe
      </a>

      {' '}

      (94.7 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/New-API-App.Setup.0.9.6.exe">
        New-API-App.Setup.0.9.6.exe
      </a>

      {' '}

      (94.9 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/new-api-arm64-v0.9.6">
        new-api-arm64-v0.9.6
      </a>

      {' '}

      (52.5 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/new-api-macos-v0.9.6">
        new-api-macos-v0.9.6
      </a>

      {' '}

      (66.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/new-api-v0.9.6">
        new-api-v0.9.6
      </a>

      {' '}

      (54.3 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/releases/download/v0.9.6/new-api-v0.9.6.exe">
        new-api-v0.9.6.exe
      </a>

      {' '}

      (55.8 MB)
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.6.zip">
        Source code (zip)
      </a>
    </li>

    <li>
      <a href="https://github.com/QuantumNous/new-api/archive/refs/tags/v0.9.6.tar.gz">
        Source code (tar.gz)
      </a>
    </li>
  </ul>
</Callout>

***


# Special Thanks

import { Callout } from 'fumadocs-ui/components/callout';

The development of New API would not be possible without the support and contributions of the community. We would like to express our special thanks to all individuals and organizations who have helped with the project.

## 👨‍💻 Development Contributors

Below is a list of all developers who have contributed to the project. We thank them for their hard work and creativity!

<Callout title="Contributor Information · Data updated on 2025-11-14 01:31:25 (UTC+8)">
  The following contributor data is automatically retrieved from the top 50 on
  the [GitHub Contributors
  page](https://github.com/QuantumNous/new-api/graphs/contributors). The top
  three contributors are identified with gold, silver, and bronze borders,
  respectively. If you would like to contribute to the project as well, we
  welcome you to submit a Pull Request.
</Callout>

### 🥇 Calcium-Ion

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/61247483?v=4" alt="Calcium-Ion" className="h-16 w-16 rounded-full border-4 border-yellow-400 shadow-lg shadow-yellow-400/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Calcium-Ion" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Calcium-Ion
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 2192
    </span>
  </div>
</div>

***

### 🥈 songquanpeng

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/39998050?v=4" alt="songquanpeng" className="h-16 w-16 rounded-full border-4 border-gray-400 shadow-lg shadow-gray-400/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/songquanpeng" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      songquanpeng
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 509
    </span>
  </div>
</div>

***

### 🥉 t0ng7u

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/133845290?v=4" alt="t0ng7u" className="h-16 w-16 rounded-full border-4 border-orange-600 shadow-lg shadow-orange-600/50" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/t0ng7u" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      t0ng7u
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 396
    </span>
  </div>
</div>

***

### seefs001

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/40468931?v=4" alt="seefs001" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/seefs001" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      seefs001
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 181
    </span>
  </div>
</div>

***

### creamlike1024

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/25699126?v=4" alt="creamlike1024" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/creamlike1024" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      creamlike1024
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 176
    </span>
  </div>
</div>

***

### feitianbubu

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/6916415?v=4" alt="feitianbubu" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/feitianbubu" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      feitianbubu
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 114
    </span>
  </div>
</div>

***

### RedwindA

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/128586631?v=4" alt="RedwindA" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/RedwindA" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      RedwindA
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 79
    </span>
  </div>
</div>

***

### xyfacai

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/52985669?v=4" alt="xyfacai" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xyfacai" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      xyfacai
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 49
    </span>
  </div>
</div>

***

### HynoR

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/20227709?v=4" alt="HynoR" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/HynoR" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      HynoR
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 41
    </span>
  </div>
</div>

***

### QuentinHsu

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/21162238?v=4" alt="QuentinHsu" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/QuentinHsu" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      QuentinHsu
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 31
    </span>
  </div>
</div>

***

### guoruqiang

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/61670021?v=4" alt="guoruqiang" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/guoruqiang" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      guoruqiang
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 25
    </span>
  </div>
</div>

***

### somnifex

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/98788152?v=4" alt="somnifex" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/somnifex" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      somnifex
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 24
    </span>
  </div>
</div>

***

### wzxjohn

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1193593?v=4" alt="wzxjohn" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/wzxjohn" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      wzxjohn
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 20
    </span>
  </div>
</div>

***

### tbphp

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17903218?v=4" alt="tbphp" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/tbphp" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      tbphp
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 19
    </span>
  </div>
</div>

***

### iszcz

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/74706321?v=4" alt="iszcz" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/iszcz" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      iszcz
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 18
    </span>
  </div>
</div>

***

### mrhaoji

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/483419?v=4" alt="mrhaoji" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/mrhaoji" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      mrhaoji
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 15
    </span>
  </div>
</div>

***

### neotf

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/10400594?v=4" alt="neotf" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/neotf" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      neotf
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 14
    </span>
  </div>
</div>

***

### nekohy

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/152958106?v=4" alt="nekohy" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/nekohy" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      nekohy
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 14
    </span>
  </div>
</div>

***

### bubblepipe

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/30717258?v=4" alt="bubblepipe" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/bubblepipe" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      bubblepipe
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 13
    </span>
  </div>
</div>

***

### luxlzz6

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/53847251?v=4" alt="luxlzz6" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/luxlzz6" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      luxlzz6
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 12
    </span>
  </div>
</div>

***

### danding5

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/9128697?v=4" alt="danding5" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/danding5" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      danding5
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 12
    </span>
  </div>
</div>

***

### MapleEve

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1845053?v=4" alt="MapleEve" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/MapleEve" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      MapleEve
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 12
    </span>
  </div>
</div>

***

### Yan-Zero

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/32036413?v=4" alt="Yan-Zero" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Yan-Zero" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Yan-Zero
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 11
    </span>
  </div>
</div>

***

### littlewrite

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/9785694?v=4" alt="littlewrite" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/littlewrite" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      littlewrite
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 11
    </span>
  </div>
</div>

***

### Sh1n3zZ

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/110708622?v=4" alt="Sh1n3zZ" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Sh1n3zZ" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Sh1n3zZ
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 10
    </span>
  </div>
</div>

***

### quzard

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/30899719?v=4" alt="quzard" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/quzard" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      quzard
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 9
    </span>
  </div>
</div>

***

### comeback01

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17897116?v=4" alt="comeback01" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/comeback01" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      comeback01
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 8
    </span>
  </div>
</div>

***

### Licoy

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/20410697?v=4" alt="Licoy" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Licoy" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Licoy
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 8
    </span>
  </div>
</div>

***

### Ehco1996

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/24697284?v=4" alt="Ehco1996" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Ehco1996" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Ehco1996
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 7
    </span>
  </div>
</div>

***

### JoeyLearnsToCode

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/11903658?v=4" alt="JoeyLearnsToCode" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/JoeyLearnsToCode" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      JoeyLearnsToCode
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 7
    </span>
  </div>
</div>

***

### igophper

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/34326532?v=4" alt="igophper" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/igophper" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      igophper
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 7
    </span>
  </div>
</div>

***

### Sacode

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1641279?v=4" alt="Sacode" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/Sacode" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      Sacode
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 7
    </span>
  </div>
</div>

***

### xiangyuanliu

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/93586556?v=4" alt="xiangyuanliu" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xiangyuanliu" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      xiangyuanliu
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### xixingya

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/37765666?v=4" alt="xixingya" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xixingya" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      xixingya
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### liusanp

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/13930358?v=4" alt="liusanp" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/liusanp" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      liusanp
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### google-labs-jules\[bot]

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/in/842251?v=4" alt="google-labs-jules[bot]" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/apps/google-labs-jules" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      google-labs-jules\[bot]
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### glzjin

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/7975407?v=4" alt="glzjin" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/glzjin" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      glzjin
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### ckt1031

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/65409152?v=4" alt="ckt1031" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/ckt1031" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      ckt1031
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### fevrax

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/58434904?v=4" alt="fevrax" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/fevrax" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      fevrax
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 6
    </span>
  </div>
</div>

***

### x-Ai

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/5061489?v=4" alt="x-Ai" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/x-Ai" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      x-Ai
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 5
    </span>
  </div>
</div>

***

### xqx333

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/141810964?v=4" alt="xqx333" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xqx333" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      xqx333
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 5
    </span>
  </div>
</div>

***

### p3psi-boo

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/43925055?v=4" alt="p3psi-boo" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/p3psi-boo" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      p3psi-boo
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 5
    </span>
  </div>
</div>

***

### OswinWu

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/22212484?v=4" alt="OswinWu" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/OswinWu" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      OswinWu
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 5
    </span>
  </div>
</div>

***

### prnake

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/52364396?v=4" alt="prnake" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/prnake" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      prnake
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 4
    </span>
  </div>
</div>

***

### kuwork

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/6893350?v=4" alt="kuwork" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/kuwork" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      kuwork
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 4
    </span>
  </div>
</div>

***

### daggeryu

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/17616921?v=4" alt="daggeryu" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/daggeryu" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      daggeryu
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 4
    </span>
  </div>
</div>

***

### QAbot-zh

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/40236765?v=4" alt="QAbot-zh" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/QAbot-zh" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      QAbot-zh
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 3
    </span>
  </div>
</div>

***

### kyubibii

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/208148478?v=4" alt="kyubibii" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/kyubibii" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      kyubibii
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 3
    </span>
  </div>
</div>

***

### xqx121

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/78908927?v=4" alt="xqx121" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/xqx121" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      xqx121
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 3
    </span>
  </div>
</div>

***

### duyazhe

<div className="mb-5 flex items-center">
  <div className="mr-4">
    <img src="https://avatars.githubusercontent.com/u/1854124?v=4" alt="duyazhe" className="h-16 w-16 rounded-full" />
  </div>

  <div className="flex flex-col">
    <a href="https://github.com/duyazhe" target="_blank" rel="noopener noreferrer" className="mb-1 font-medium no-underline">
      duyazhe
    </a>

    <span className="text-muted-foreground text-sm">
      Contributions: 3
    </span>
  </div>
</div>

***


# Text-to-Speech

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Converts text into audio

<APIPage document={"openapi/generated/ai-model/音频（Audio）/原生OpenAI格式/post-v1-audio-speech-createspeech-383826485.json"} operations={[{"path":"/v1/audio/speech","method":"post"}]} />


# Audio Transcriptions

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Convert audio to text

<APIPage document={"openapi/generated/ai-model/音频（Audio）/原生OpenAI格式/post-v1-audio-transcriptions-createtranscription-383826483.json"} operations={[{"path":"/v1/audio/transcriptions","method":"post"}]} />


# Audio Translation

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Translates audio into English text

<APIPage document={"openapi/generated/ai-model/音频（Audio）/原生OpenAI格式/post-v1-audio-translations-createtranslation-383826484.json"} operations={[{"path":"/v1/audio/translations","method":"post"}]} />


# Gemini Media Recognition

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Gemini Image, PDF, Audio, Video Recognition Request

⚠️Note: Only supports uploading images, PDFs, audio, and video via inlineData in base64 format. fileData.fileUri or File API are not supported.

<APIPage document={"openapi/generated/ai-model/聊天（Chat）/原生Gemini格式/post-v1beta-models-model-generatecontent-geminirelayv1beta-391536411-391536411.json"} operations={[{"path":"/v1beta/models/{model}:generateContent","method":"post"}]} />


# Gemini Text Chat

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Proxy Gemini API requests.
Path format: `/v1beta/models/{model_name}:{action}`

For example:

* `/v1beta/models/gemini-2.5-pro:generateContent`
* `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`

<APIPage document={"openapi/generated/ai-model/聊天（Chat）/原生Gemini格式/post-v1beta-models-model-generatecontent-geminirelayv1beta-383826489.json"} operations={[{"path":"/v1beta/models/{model}:generateContent","method":"post"}]} />


# ChatCompletions Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Creates model responses based on chat history. Supports streaming and non-streaming responses.

Compatible with OpenAI Chat Completions API.

<APIPage document={"openapi/generated/ai-model/聊天（Chat）/原生OpenAI格式/post-v1-chat-completions-createchatcompletion-383826473.json"} operations={[{"path":"/v1/chat/completions","method":"post"}]} />


# Responses Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

OpenAI Responses API, used to create model responses.
Supports multi-turn conversations, tool calling, reasoning, and other features.

<APIPage document={"openapi/generated/ai-model/聊天（Chat）/原生OpenAI格式/post-v1-responses-createresponse-383826475.json"} operations={[{"path":"/v1/responses","method":"post"}]} />


# Gemini Native Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Gemini Image Generation

<APIPage document={"openapi/generated/ai-model/图像（Images）/原生Gemini格式/post-v1beta-models-model-generatecontent-geminirelayv1beta-383837589-383837589.json"} operations={[{"path":"/v1beta/models/{model}:generateContent/","method":"post"}]} />


# OpenAI Chat Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Gemini Image Generation

<APIPage document={"openapi/generated/ai-model/图像（Images）/原生Gemini格式/post-v1-chat-completions-geminirelayv1beta-389846313-389846313.json"} operations={[{"path":"/v1/chat/completions","method":"post"}]} />


# Edit Image

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Creates an edited or extended image given an original image and a prompt.

<APIPage document={"openapi/generated/ai-model/图像（Images）/原生OpenAI格式/post-v1-images-edits-post-v1-images-edits-385320133.json"} operations={[{"path":"/v1/images/edits/","method":"post"}]} />


# Generate Images

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Creates an image given a prompt. [Learn more](https://platform.openai.com/docs/guides/images).

<APIPage document={"openapi/generated/ai-model/图像（Images）/原生OpenAI格式/post-v1-images-generations-post-v1-images-generations-385320132.json"} operations={[{"path":"/v1/images/generations/","method":"post"}]} />


# Generate Images

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Bailian qwen-image series image generation

<APIPage document={"openapi/generated/ai-model/图像（Images）/通义千问OpenAI格式/post-v1-images-generations-createimage-383833512.json"} operations={[{"path":"/v1/images/generations","method":"post"}]} />


# Edit Image

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

百炼qwen-image series image editing

<APIPage document={"openapi/generated/ai-model/图像（Images）/通义千问OpenAI格式/post-v1-images-edits-editimage-383834049.json"} operations={[{"path":"/v1/images/edits","method":"post"}]} />


# Native OpenAI Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Get a list of currently available models.

Automatically identify the return format based on the request headers:

* Returns Anthropic format when `x-api-key` and `anthropic-version` headers are present
* Returns Gemini format when `x-goog-api-key` header or `key` query parameter is present
* Returns OpenAI format in other cases

<APIPage document={"openapi/generated/ai-model/模型（Models）/列出模型/get-v1-models-listmodels-383826468.json"} operations={[{"path":"/v1/models","method":"get"}]} />


# Native Gemini Format

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Returns a list of available models in Gemini API format

<APIPage document={"openapi/generated/ai-model/模型（Models）/列出模型/get-v1beta-models-listmodelsgemini-383826471.json"} operations={[{"path":"/v1beta/models","method":"get"}]} />


# Upload File (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface has not been implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/文件（Files）/post-v1-files-createfile-383826492.json"} operations={[{"path":"/v1/files","method":"post"}]} />


# Delete File (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/文件（Files）/delete-v1-files-file-id-deletefile-383826494.json"} operations={[{"path":"/v1/files/{file_id}","method":"delete"}]} />


# Get File Content (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/文件（Files）/get-v1-files-file-id-content-downloadfile-383826495.json"} operations={[{"path":"/v1/files/{file_id}/content","method":"get"}]} />


# List Files (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface has not been implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/文件（Files）/get-v1-files-listfiles-383826491.json"} operations={[{"path":"/v1/files","method":"get"}]} />


# Get File Information (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/文件（Files）/get-v1-files-file-id-retrievefile-383826493.json"} operations={[{"path":"/v1/files/{file_id}","method":"get"}]} />


# Cancel Fine-tuning Task (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/微调（Fine-tuning）/post-v1-fine-tunes-fine-tune-id-cancel-cancelfinetune-383826499.json"} operations={[{"path":"/v1/fine-tunes/{fine_tune_id}/cancel","method":"post"}]} />


# Create Fine-tuning Task (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/微调（Fine-tuning）/post-v1-fine-tunes-createfinetune-383826497.json"} operations={[{"path":"/v1/fine-tunes","method":"post"}]} />


# Get Fine-tune Job Events (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/微调（Fine-tuning）/get-v1-fine-tunes-fine-tune-id-events-listfinetuneevents-383826500.json"} operations={[{"path":"/v1/fine-tunes/{fine_tune_id}/events","method":"get"}]} />


# List Fine-tuning Jobs (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/微调（Fine-tuning）/get-v1-fine-tunes-listfinetunes-383826496.json"} operations={[{"path":"/v1/fine-tunes","method":"get"}]} />


# Get Fine-tuning Job Details (Unimplemented)

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

This interface is not yet implemented

<APIPage document={"openapi/generated/ai-model/未实现（Unimplemented）/微调（Fine-tuning）/get-v1-fine-tunes-fine-tune-id-retrievefinetune-383826498.json"} operations={[{"path":"/v1/fine-tunes/{fine_tune_id}","method":"get"}]} />


# Jimeng Video Generation

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Jimeng official API format video generation interface.

Supports specifying operation types via the Action parameter:

* `CVSync2AsyncSubmitTask`: Submit video generation task
* `CVSync2AsyncGetResult`: Get task result

Action and Version need to be specified in the query parameters.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/即梦格式/post-jimeng-createjimengvideo-383844643.json"} operations={[{"path":"/jimeng/","method":"post"}]} />


# Kling Image to Video

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Generate video from images using the Kling model.

Supports passing image URLs or Base64 encoded image data via the image parameter.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/可灵格式/post-kling-v1-videos-image2video-createklingimage2video-383844641.json"} operations={[{"path":"/kling/v1/videos/image2video","method":"post"}]} />


# Kling Text-to-Video

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Generate videos from text descriptions using the Kling model.

Supported models: kling-v1, kling-v1-5, etc.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/可灵格式/post-kling-v1-videos-text2video-createklingtext2video-383844639.json"} operations={[{"path":"/kling/v1/videos/text2video","method":"post"}]} />


# Get Kling Image-to-Video Task Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Query the status and results of a Kling image-to-video task.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/可灵格式/get-kling-v1-videos-image2video-task-id-getklingimage2video-383844642.json"} operations={[{"path":"/kling/v1/videos/image2video/{task_id}","method":"get"}]} />


# Get Kling Text-to-Video Task Status

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Query the status and results of a Kling text-to-video task.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/可灵格式/get-kling-v1-videos-text2video-task-id-getklingtext2video-383844640.json"} operations={[{"path":"/kling/v1/videos/text2video/{task_id}","method":"get"}]} />


# Create Video 

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

OpenAI-compatible video generation API.

Reference documentation: [https://platform.openai.com/docs/api-reference/videos/create](https://platform.openai.com/docs/api-reference/videos/create)

<APIPage document={"openapi/generated/ai-model/视频（Videos）/Sora格式/post-v1-videos-createvideo-383844578.json"} operations={[{"path":"/v1/videos","method":"post"}]} />


# Get Video Task Status 

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

OpenAI-compatible video task status query interface.

Returns detailed status information for video tasks.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/Sora格式/get-v1-videos-task-id-getvideo-383844579.json"} operations={[{"path":"/v1/videos/{task_id}","method":"get"}]} />


# Get Video Content

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Retrieves the video file content for a completed video task.

This interface proxies and returns the video file stream.

<APIPage document={"openapi/generated/ai-model/视频（Videos）/Sora格式/get-v1-videos-task-id-content-getvideocontent-383844580.json"} operations={[{"path":"/v1/videos/{task_id}/content","method":"get"}]} />