메인 콘텐츠로 건너뛰기

Prerequisites

Before getting started, make sure you have:
  1. Cherry Studio installed Download and install Cherry Studio from the official website
  2. A ToAPIs API key Sign in to the ToAPIs Console to obtain your API key (starts with sk-)
Note: If you don’t have a ToAPIs account yet, register at ToAPIs first.

Setup Steps

Step 1: Open 모델 Provider Settings

  1. Launch Cherry Studio
  2. Click the Settings icon (gear icon) in the bottom-left corner
  3. Navigate to 모델 Services or Providers

Step 2: Add ToAPIs as a Provider

  1. Click the + button in the top-right of the provider list
  2. In the dialog that appears:
    • Name: Enter ToAPIs (or any name you prefer)
    • Provider Type: Select New API (OpenAI-compatible)
  3. Click Confirm to create the provider

Step 3: Fill in API Configuration

On the ToAPIs provider configuration page, enter the following:
FieldValue
API KeyYour ToAPIs API key (sk-xxxxxxxxxxxx)
API Addresshttps://toapis.com/v1/

Step 4: Add 모델

  1. On the provider config page, click Add 모델
  2. Fill in the model details:
    • 모델 ID: Enter the model ID you want to use (see recommended models below)
    • 엔드포인트 Type: Select OpenAI
  3. Click Save
Recommended 모델:
모델 Name모델 ID설명
Claude Opus 4.6claude-opus-4-6Most capable, best for complex tasks
Claude Sonnet 4.6claude-sonnet-4-6Balanced performance and speed — recommended for daily use
Claude Haiku 4.5claude-haiku-4-5-20251001Fastest, best for lightweight tasks
GPT-5gpt-5Latest OpenAI flagship model
GPT-4ogpt-4oHigh-quality conversations and multimodal
GPT-4o Minigpt-4o-miniFast and cost-effective
Gemini 2.5 Progemini-2.5-proGoogle multimodal flagship
Repeat the above steps to add as many models as you need.

Step 5: Enable and Verify

  1. Make sure the toggle next to the provider is enabled
  2. Click Check Connection or Test to verify the configuration
  3. A success message confirms everything is working correctly

Start Using

Once configured:
  1. Return to the Cherry Studio main interface
  2. Select your ToAPIs model from the model picker at the top of the chat window
  3. Start chatting

Troubleshooting

Connection test fails?

  1. Double-check the API Key — it must start with sk-
  2. Confirm the API Address is https://toapis.com/v1/ (note the trailing slash)
  3. Verify the key is active in the ToAPIs Console and your account has sufficient balance
  4. Check your network connection and ensure https://toapis.com is reachable

Can’t find my model in the list?

Cherry Studio uses manually added models. Simply type the model ID directly when adding a model. You can find all available model IDs in the ToAPIs model list.

Common error codes

오류CauseFix
401 UnauthorizedInvalid or expired API keyGenerate a new API key
429 Too Many RequestsRate limit exceededWait a moment and retry
500 Internal Server 오류Temporary server issueRetry in a few minutes
insufficient_quotaInsufficient account balanceTop up in the console

Support

If you encounter any issues:
[## Get Started with ToAPIs Sign up for ToAPIs, get your API key, and supercharge your AI workflow with Cherry Studio!](https://toapis.com)