Getting Started

An open-source browser extension designed to optimize the experience of managing AI proxy service accounts like New API. Users can easily centralize management and view account balances, models, and keys, and automatically add new sites. It supports use on mobile devices via Kiwi or mobile Firefox browsers.

1. Download

Channel Version Comparison

Channel	Download Link	Current Version
GitHub Release	Release Download
Chrome Store	Chrome Store
Edge Store	Edge Store
Firefox Store	Firefox Store

Tip

Store versions may experience a 1-3 day delay during the review process. To experience new features or fixes first-hand, it is recommended to prioritize using the GitHub Release version or building from the repository source code.

2. Supported Sites

Supports proxy services deployed based on the following projects:

Warning

If a site has undergone custom development, causing some key interfaces (e.g., /api/user) to change, the extension may not be able to add this site normally.

3. Adding Sites

Tip

You must first log in to the target proxy service yourself using your browser, so that the extension's automatic recognition feature can obtain your account's Access Token via Cookie.

3.1 Automatic Recognition and Addition

Open the extension's main page and click Add Account.

Enter the proxy service address and click Auto-recognize.

After confirming that the automatic recognition is correct, click Confirm Add.

Tip

The extension will automatically recognize various information about your account, such as:

Username
User ID
Access Token
Recharge amount ratio

If the target site has Cloudflare's 5-second challenge enabled, the extension will automatically pop up a separate window to help bypass the challenge; once bypassed, the recognition process can continue. If the IP quality is poor or due to other reasons, you will need to manually complete the bypass in the pop-up window before timeout.

3.2 Cloudflare Bypass Assistant Overview

When a Cloudflare 5-second challenge is detected, the extension will automatically launch a temporary window to help complete the verification; if the challenge requires manual intervention, please click verify in the pop-up.
After successful verification, it will automatically return to the original process to continue obtaining the Access Token and site information.
More details can be found in Cloudflare Protection and Temporary Window Downgrade.

3.3 Manual Addition

Tip

If automatic recognition fails, you can manually enter and add site accounts. You will need to obtain the following information first. (The UI may vary for each site, please find it yourself.)

用户信息

If the target site is a modified version (e.g., AnyRouter), please manually switch to Cookie Mode when adding the account, then perform automatic recognition or manual entry. When encountering sites with strict protection, you can also use it in conjunction with the Cloudflare Bypass Assistant. For details, please refer to FAQ.

4. Quick Export Sites

This extension supports one-click export of API configurations for added sites to CherryStudio, CC Switch, and New API, thereby simplifying the process of adding upstream providers to these platforms.

4.1 Configuration

Before using the quick export feature, you need to configure the Server Address, Admin Token, and User ID of the target platform (New API) on the extension's Basic Settings page.

4.2 Export Process

Navigate to Key Management: On the extension's Key Management page, find the API key corresponding to the site you want to export.
Click Export: In the key operation menu, select "Export to CherryStudio / CC Switch / New API".
Automatic Processing:
- For New API: The extension will automatically detect if a channel with the same Base URL already exists on the target platform to avoid duplicate additions. If it does not exist, a new channel will be created, and the site name, Base URL, API key, and list of available models will be automatically populated.
- For CherryStudio / CC Switch: The extension will send the site and key directly to the local program or clipboard according to the target application's protocol, eliminating the need for item-by-item pasting.

This feature allows you to easily import API provider configurations into other platforms without manual copy-pasting, improving work efficiency.

5. Feature Overview

5.1 Auto-Refresh and Health Status

Go to Settings → Auto-Refresh to enable timed refresh of account data, with a default interval of 6 minutes (360 seconds), supporting a minimum of 60 seconds.
Check "Auto-refresh when opening plugin" to synchronize data when the pop-up is opened.
After enabling "Show Health Status", account cards will display health status indicators (Normal/Warning/Error/Unknown).

5.2 Check-in Detection

Check "Enable Check-in Detection" in the account information to track site check-in status.
Supports setting Custom Check-in URL and Custom Recharge URL to adapt to modified sites.
Accounts requiring check-in will display a prompt in the list; click to jump to the check-in page.

5.3 WebDAV Backup and Multi-Device Sync

Go to Settings → WebDAV Backup to configure the WebDAV address, username, and password.
You can choose a sync strategy (Merge/Upload Only/Download Only) and set the auto-sync interval.
It is recommended to use it with JSON import/export to achieve double backup.

5.4 Sorting Priority

Adjust account sorting logic in Settings → Sorting Priority Settings.
Supports combining conditions such as current site, health status, check-in requirements, and custom fields.
Drag to adjust priority and disable unnecessary sorting rules at any time.

5.5 Data Import/Export

In the "Import and Export" area under Settings → Data and Backup, you can one-click export all current account configurations as JSON.
Supports importing data exported from older versions or other devices, facilitating quick migration or recovery.

5.6 New API Model List Sync

For detailed documentation on the New API model list sync feature, please refer to New API Model List Sync.

5.7 New API Channel Management (Beta)

Create/edit/delete channels directly within the extension. Combined with model whitelisting and single-channel sync debugging, this can significantly reduce the frequency of going back and forth to the New API backend. See New API Channel Management for detailed operations and precautions.

5.8 Cloudflare Protection and Temporary Window Downgrade

When detection or API calls are intercepted by Cloudflare (common status codes 401/403/429), it will automatically switch to a temporary window to retry, maintaining the target domain Cookie; generally, no manual operation is required. For principle details, see Cloudflare Bypass Assistant.
In scenarios requiring human-machine verification, please complete the challenge in the popped-up assistance window; if it frequently fails, try changing the network or reducing the request frequency.

6. In-depth Documentation

7. FAQ and Support

View more detailed FAQ to learn about authentication methods, AnyRouter adaptation, feature usage tips, and more.
If you encounter problems or need new features, feel free to provide feedback on GitHub Issues.
For historical updates, please refer to the Changelog.

Next Steps

After completing the basic settings, you can continue to configure auto-refresh, check-in detection, or WebDAV sync for a more complete user experience.