---
title: "Chatbox API: Add FreeTheAI as a Custom Provider"
description: "Use AI models in Chatbox on Windows, Mac, Linux, Android, and iOS. Add FreeTheAI with the OpenAI API Compatible mode."
url: https://freetheai.org/setup/chatbox
language: en
updated: 2026-09-29
---

# Chatbox API: Add FreeTheAI as a Custom Provider

Chatbox adds FreeTheAI as a custom provider in OpenAI API Compatible mode. It works on desktop, mobile, and the web app.

## Settings

- Name: `FreeTheAI`
- API Mode: `OpenAI API Compatible`
- API Host: `https://api.freetheai.org/v1`
- API Path: `/chat/completions`
- API Key: `your FreeTheAI key (ftai_..., 53 characters)`

## Steps

1. **Add a provider.** Open Settings, then Model Provider, and press Add. Enter the name and choose OpenAI API Compatible.
2. **Enter the connection.** Paste your key, the API Host, and keep the API Path as /chat/completions. The preview should show https://api.freetheai.org/v1/chat/completions.
3. **Add models and check.** Fetch the model list or add a model ID by hand, then press Check.

## Tips

- Chatbox needs at least one model added before Check works.

## Troubleshooting

**What should the Chatbox preview URL look like?**

https://api.freetheai.org/v1/chat/completions. If it shows /v1 twice, remove it from the API Path.

Checked: Checked against Chatbox's source (provider settings and URL handling) on 2026-09-29.
