Compositev12
forum App guide

Use Composite as your ChubAI proxy

ChubAI accepts any OpenAI-compatible provider under its API settings. Point it at Composite's OpenAI-compatible base URL to run community presets, lorebooks and plugins on your own provider key, or on Synth, LuciditySH's creative model, free on Composite, with no key at all, in your existing chats and personas.

What "ChubAI proxy" means

ChubAI does not run its own models. Under its API settings you point it at an OpenAI-compatible endpoint, and every message you send is forwarded there and the reply shown in your chat. That forwarding service is what people mean by a "proxy" for ChubAI. It sits between the interface you write in and the model actually generating replies. Composite is one such proxy: it authenticates your API key, applies the presets, lorebooks and plugins attached to it, sends the request to your own provider or to the model you picked, and returns a standard OpenAI-formatted response. One Composite key reaches every model on the platform and works across ChubAI, SillyTavern, and other OpenAI-compatible frontends, so switching characters or apps does not mean a new key or a new setup.

Paste values

Copy these directly into ChubAI's API settings panel. Choose OpenAI (or Custom OpenAI-compatible) as the connection type.

forum

ChubAI

Use these fields when adding a custom OpenAI-compatible provider in ChubAI.

API TypeOpenAI
Base URLhttps://composite.lucidity.sh/v1
API KeyYOUR_API_KEY
Modelminimax/minimax-m3

Setup steps

forumChubAI
Connect Composite as an OpenAI-compatible API in ChubAI.
expand_more
  1. Open ChubAI's API settings and choose an OpenAI-compatible connection.
  2. Paste https://composite.lucidity.sh/v1 as the API base URL.
  3. Paste your Composite API key into the key field.
  4. Select or type a model ID, such as minimax/minimax-m3, from the Models page.
Settings Reference
API Type:     OpenAI
API Base URL: https://composite.lucidity.sh/v1
API Key:      YOUR_API_KEY
Model:        minimax/minimax-m3
Which key and model Accounts are free, and you make a key on the Keys page. Bind it to your own provider on the API Keys page (the BYOK quickstart takes two minutes) and use one of that provider's model ids, listed under Your provider on the Models page. With no provider, use lucidityai/synth-2.5-flash, LuciditySH's creative model, free on Composite.

Troubleshooting

The most common problems when using Composite as a ChubAI proxy, and how to fix them.

link_offChubAI proxy not working
The connection fails or no models appear.
expand_more

Confirm the connection type is set to OpenAI (or Custom OpenAI-compatible), the base URL is exactly https://composite.lucidity.sh/v1 with nothing appended after it, and the API key was pasted with no leading or trailing spaces. If no models appear after connecting, the base URL is the most likely cause: ChubAI needs the base URL here, not the full chat-completions path. Send a short test message before trusting a longer chat to the connection.

speed429 errors and rate limits
What a 429 means on Synth and on your own provider.
expand_more

A 429 response on Synth means today's Synth requests are used up: 80 a day, or 300 a day in your first week after joining with a referral code. They reset once a day at the time shown on your account page, and credits or a plan make Synth unlimited. A key bound to your own provider has no Composite daily limit, so a 429 there is your provider's own rate limit.

key_offInvalid API key error
Key format, the Bearer header, and key scoping.
expand_more

Composite API keys start with cmp- and are sent as a bearer token, so the API key field should hold only the key itself. ChubAI adds the Bearer header for you. An invalid-key error usually means the key was revoked, mistyped, or deleted; generate a fresh one on the API Keys page. Each key can also be scoped to specific models, so a key that works for one model can still fail on another it is not allowed to use.

auto_awesomeWhich model should I use?
A short starting point for roleplay on ChubAI.
expand_more
Use caseSuggestion
General roleplay, default choiceminimax/minimax-m3
No provider key yetlucidityai/synth-2.5-flash (Synth), free on every account
Long-running character or campaignA higher context-length model from the Models page, paired with a memory-layer setting on the key
Highest reply quality, budget flexibleCompare current premium models on the Models page

The catalog changes as models are added, so treat the Models page as the source of truth rather than a fixed list.

historyContext window on long chats
What happens when a chat outgrows the model's context.
expand_more

Every model has a fixed context window. Once a conversation exceeds it, Composite trims older messages to keep the request within limits, so long-running characters can start losing early details unless the key is set to one of Composite's memory-layer modes, which summarize and retrieve older history instead of dropping it outright. If replies start ignoring established facts in a long ChubAI chat, check the key's memory-layer setting before assuming the model itself is at fault.

Still stuck after working through the above? The full docs cover account setup, API keys, and model access in more detail, and the feedback page reaches Composite directly if something looks broken rather than misconfigured. If you also use SillyTavern, the setup is nearly identical; see the SillyTavern proxy guide.