---
url: https://docs.freetheai.org/guides/cherry-studio.md
description: >-
  Add FreeTheAI to Cherry Studio as an OpenAI-type provider. The API address to
  enter, how Cherry adds /v1, and how to enable free models.
---

# Cherry Studio

Cherry Studio adds FreeTheAI as an OpenAI-type model service. Enter the root address; Cherry adds /v1 itself.

Category: [Chat apps](/guides/#chat-apps). Before you start, you need a FreeTheAI account, an API key, and today's [check-in](/getting-started/check-in).

## Settings

| Setting | Value |
| --- | --- |
| Provider type | `OpenAI` |
| API Address | `https://api.freetheai.org` |
| API Key | Your FreeTheAI key (`ftai_...`, 53 characters) |

## Steps

### Add the provider

Open Settings, then Model Services, and press + Add. Name it FreeTheAI and choose the OpenAI type.

### Enter the address and key

Enter the root address [api.freetheai.org](https://api.freetheai.org) and your key. Cherry Studio adds /v1 automatically; do not end the address with #.

### Add models and enable

Use Manage to fetch models (or add an ID by hand), run the check, then turn on the switch at the top right.

## Common questions

### Should I enter /v1 in Cherry Studio?

No. Enter [api.freetheai.org](https://api.freetheai.org) and Cherry Studio adds /v1. Entering /v1 as well can produce `/v1/v`1.

## More help

* [Every API error and its fix](/errors)
* [Limits and the daily reset](/concepts/limits)
* [Cherry Studio website](https://cherry-ai.com) and [source code](https://github.com/CherryHQ/cherry-studio)

::: info How this guide was checked
Checked against Cherry Studio's docs and API address handling on 2026-09-29.
:::