Skip to Content

Using 123API in Cherry Studio

Configure 123API in Cherry Studio to access OpenAI-compatible chat models through one provider entry.

Prerequisites

  1. Install Cherry Studio
  2. Create a 123API API key
  3. Prepare one or more model IDs you plan to use

Step 1: Open Settings

After launching Cherry Studio:

  1. Click the settings icon in the top-right corner
  2. Open the Model Service page

Step 2: Add 123API as a Provider

Add a new provider and fill in:

FieldValue
Provider Name123API
Provider TypeOpenAI
API KeyYour 123API key
API URLhttps://123api.co

Some clients expect the host without /v1, while others require the full https://123api.co/v1 base URL. Follow the input label shown in Cherry Studio and test once after saving.

Step 3: Add Models

Use the model management window to add the models you want, for example:

Step 4: Start Chatting

  1. Return to the main page
  2. Create a new chat
  3. Choose a model under the 123API provider
  4. Send a small test prompt to verify the provider is working

FAQ

The model list is empty+

Add the model IDs manually and verify your API key can access them through GET /v1/models.

Connection test fails+

Double-check the host value, API key and whether your local network can reach https://123api.co.

Why does one model work and another fail?+

Different model families may have different routing requirements or availability. Always validate the exact model ID with GET /v1/models.