---
title: "Chatbox One-Click Import and Configuration"
description: "Import Chatbox from the API Key page and verify API Host, path, model, and key."
headingIds: {"One-Click Import":"section-1","Clipboard and Manual Configuration":"section-2","Troubleshooting":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintained by [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources and corrections](https://1zheai.com/en/editorial/).

Found an error? [Contact support](mailto:support@1zheai.com) with the page address and a description. Do not send API keys or account credentials.

</aside>
Chatbox 1.15.1 and later supports provider JSON and `chatbox://provider/import`. The desktop version must be installed and launched once first. For the web version or systems without a registered protocol, use clipboard import.

## One-Click Import

1. Open **API Keys** in the console, find the key you want to use, and go to **Use Tools → Chatbox**.
2. Select a chat model available for this key, then click **Open Chatbox** and allow the browser to open the app.
3. Confirm the import in Chatbox and check the provider address and model. If a configuration with the same name already exists, first verify the scope of the overwrite.
4. Send a short message and check the model and request time in the call logs on this site.

## Clipboard and Manual Configuration

If the app does not launch, copy **Chatbox JSON** from the same panel, then go to provider management in Chatbox settings and choose to import from the clipboard. You must delete `settings.apiKey` before sharing with others.

| Field | Value |
| --- | --- |
| Type | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | Current key |
| Model ID | Chat model available for the current key |

Fill in Host and Path separately; do not add `/v1` to both fields at once. If there is no model, first fetch the model list or add one manually; capabilities such as images, embeddings, and tool calls must each be verified separately — do not treat an arbitrary model as a chat model.

## Troubleshooting

- App does not open: confirm the app is installed and has been launched, unblock this protocol in the browser, or use clipboard import.
- 401 after import: check whether the key is valid and contains no spaces.
- 404: confirm the final path is `/v1/chat/completions` and has not been concatenated twice.
- Model does not exist: use the exact ID from the model list; do not guess based on the display nickname.

Official: [Configuration import protocol ](https://docs.chatboxai.app/guides/providers/import-config), [Client source code ](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).

<Note> protocol verified against official materials on 2026-10-19. This site has implemented configuration generation and frontend regression testing; real inference verification across all clients, systems, and models has not been completed. Please re-verify after client upgrades. Custom integration does not imply official partnership or built-in recommendation. </Note>

More: [API Keys ](/en/docs/api-keys/), [Model list ](/en/docs/models/), [Call logs ](/en/docs/usage-logs/), [Address notes ](/en/docs/base-url/).