Getting StartedConnecting your services

Connecting your services

Connect the AI services and accounts you already use, from Higgsfield and fal to Meta, choose which one pays, and switch any of them off.

BosOn works through the accounts you already pay for. Connect them in Settings, Connections: click your initial at the top right, then Connections. Or click the gear at the top right and choose Connections on the left, or press Ctrl+K and type Connections. Each connection is kept encrypted on your computer, never in your library folder or anywhere else.

AI apps on your computer, such as Claude and Codex, can also send what they make straight into BosOn: see Sending to BosOn from Claude, Codex and other AI apps.

The services you can connect

Settings, Connections: the rail on the left with Connections chosen, how many are connected at the top right, then AI apps, with Claude connected and Codex not installed, and Another AI app; Save from the web, with BosOn for your browser; and Make pictures, video and voice, starting with ElevenLabs and fal API, each with a Connect button
Settings, Connections: the rail on the left with Connections chosen, how many are connected at the top right, then AI apps, with Claude connected and Codex not installed, and Another AI app; Save from the web, with BosOn for your browser; and Make pictures, video and voice, starting with ElevenLabs and fal API, each with a Connect button
ServiceHow it connectsWhat it's for
Higgsfield planSign in with HiggsfieldHiggsfield's models and presets, paid from your plan's credits
falAn API keyPictures, video, Collider, voices, music and upscaling from many makers, on one key, paid in dollars
Higgsfield APIAn API keyPay-as-you-go Higgsfield models, for when the plan runs out of credits
GeminiAn API keyNano Banana pictures and edits, and music for explainers
ElevenLabsAn API keyVoiceovers in your own ElevenLabs voices, cloned ones included
Kie.ai (coming soon)An API keySeedance, Kling, MiniMax, Wan and more video models, voices and writing, on your own Kie credits
OpenRouterConnect with OpenRouter, or an API keySeedance, Kling and Veo video, Micro Studio's pictures, ElevenLabs voices and writing, on your OpenRouter credit
OpenAI APIAn API keyGPT Image pictures, and writing when Claude isn't available
ClaudeConnectCaptions, checks, angles and descriptions, on your Claude plan; and sending what Claude makes into BosOn
CodexSign in with ChatGPT, through the Codex appThe same writing on your ChatGPT plan; and sending what Codex makes into BosOn
Anthropic APIAn API keyPay-per-use Claude, for when your Claude plan isn't available
Meta adsSign in with MetaYour ads' results, launching ads, and posting to Facebook and Instagram
YouTubeConnect, then sign in with GooglePosting videos and Shorts to your channel, and their views, likes and comments: see Posting to YouTube
TikTok (coming soon)Connect, then sign in with TikTokSending your clips to TikTok, to post from the app

A service marked Coming soon in Connections can't be connected yet. Connect only the ones you use. Anything that needs a service you haven't connected says so and points you to Connections. The count at the top right of Settings says how many you've connected.

Adding an API key

For a service that uses an API key, click its tile in Connections to open its panel. Get a key, beside API key, opens our guide to making one (for fal, fal's own keys page). Paste the key into the box and click Save.

Each service asks its own questions when you make a key. These guides say exactly what to choose: fal, ElevenLabs, Kie.ai, OpenRouter, Gemini, OpenAI, Anthropic and the Higgsfield API.

Gemini's panel in Connections, not connected: what it makes, API key with a Get a key link, a box to paste the key and a Save button
Gemini's panel in Connections, not connected: what it makes, API key with a Get a key link, a box to paste the key and a Save button

Switching a service off

Every service has an on and off switch, on its tile and at the top of its panel (Use and its name). Switched off, BosOn stops using it but keeps its key or sign-in, so switching it back on needs nothing else.

Who pays

When more than one connected service can make something, Settings, Who pays (on the left, under Making) says which pays. This part shows once you've connected something that can pay, such as your Higgsfield plan, fal, Kie.ai or OpenRouter.

  • Primary: everything runs on it.
  • Secondary: if the Primary runs out of credit, BosOn stops and offers to carry on with the Secondary. Choose None to stop and say so instead.
  • Use my Higgsfield plan's credits first in the last 5 days before they reset shows when your Higgsfield plan is one of them. Plan credits don't carry over, so using them then costs nothing more. Type the day your plan renews, so BosOn knows when.

A model only one of your services makes always runs there.

Prices and balance checks (coming in the next desktop build)

Prices come from one price list that BosOn keeps and updates daily. Every price shown is the supplier's own. A model not on the list yet shows an estimate.

Before a job starts, BosOn checks the whole job's cost against the balance of whoever pays, where it can read one: your Higgsfield plan, Kie.ai, OpenRouter, and fal with a Full access key. If there isn't enough, it stops before anything is spent.

In the next desktop build, the balance beside your profile, top right, is whoever pays first. Click it to see every balance, and click one to top it up.

Settings, Who pays: an Ultra plan with 2,140 credits left that renews on the 1st, Primary set to fal API, Secondary set to Higgsfield plan, and the switch to use the Higgsfield plan's credits first in the last 5 days before they reset, on
Settings, Who pays: an Ultra plan with 2,140 credits left that renews on the 1st, Primary set to fal API, Secondary set to Higgsfield plan, and the switch to use the Higgsfield plan's credits first in the last 5 days before they reset, on

If Claude Code or Codex says it isn't on this computer

Your Claude and ChatGPT plans work through apps on your computer: Claude Code and Codex. If BosOn can't find one, its panel says so. Install the app and sign in to it, then click Check again.

If it's already installed somewhere BosOn didn't look, click Find it and choose the program: claude.exe or codex.exe (on a Mac, the app). BosOn checks it and remembers it on this computer.

Codex's panel saying Codex is not on this computer, with Installed somewhere BosOn didn't look? and a Find it button, and a Check again button
Codex's panel saying Codex is not on this computer, with Installed somewhere BosOn didn't look? and a Find it button, and a Check again button

Choosing which AI writes and describes

If you've connected more than one AI, choose which one does each job. Open Settings (the gear, or Ctrl+,), then AI on the left:

  • Model for captions, checks and angles: the model that writes for you. Picking a model picks its AI too.
  • Model for describing pictures: the model that describes your pictures, so you can search them. A quick one is plenty.

Each list shows the models of every AI you've connected, grouped by where they come from: your Claude plan, Codex (ChatGPT plan), or an API key. Models on your Claude or ChatGPT plan cost nothing extra.

When it runs out, with Switch to another connected AI on, BosOn hands the job to another AI you've connected if yours runs out or isn't available. That AI uses its own standard model.

Settings, AI: Model for captions, checks and angles set to Claude Sonnet: recommended, Model for describing pictures set to Claude Haiku: quickest, When it runs out with Switch to another connected AI on, Daily limit for AI apps, Suggest tags, and Today with a link to the AI log
Settings, AI: Model for captions, checks and angles set to Claude Sonnet: recommended, Model for describing pictures set to Claude Haiku: quickest, When it runs out with Switch to another connected AI on, Daily limit for AI apps, Suggest tags, and Today with a link to the AI log

Sign in with Meta

Start the sign-in

In Connections, open Meta ads and click Sign in with Meta.

The Meta ads panel in Connections, not connected
The Meta ads panel in Connections, not connected

Choose your accounts

Meta's own sign-in page opens in your browser. Choose the ad accounts, Pages and Instagram accounts BosOn may use, and confirm.

Back in BosOn

The browser says you're connected. BosOn picks the connection up by itself and asks which ad account, Page and Instagram account to use.

When your Meta connection is ending

Meta lets BosOn reach your accounts for 90 days from each time you sign in, and signing in again starts the 90 days afresh. BosOn tells you before they run out.

In the last week, an amber dot shows on the gear at the top right, and beside Connections in the menu under your initial. Connections shows a line at the top with a Reconnect button. Click it to sign in with Meta again.

The top right of BosOn: the bell, the gear with an amber dot, and your initial with Pro
The top right of BosOn: the bell, the gear with an amber dot, and your initial with Pro
The menu under your initial, with an amber dot beside Connections
The menu under your initial, with an amber dot beside Connections
The line at the top of Connections: Your Meta ads connection ends on 8 November 2026. Reconnect to keep posting and reading results, with a Reconnect button
The line at the top of Connections: Your Meta ads connection ends on 8 November 2026. Reconnect to keep posting and reading results, with a Reconnect button

If the 90 days run out, the line turns red: BosOn can't post or read results on Meta until you sign in again. Reconnect puts it right.

The line at the top of Connections, in red: Your Meta ads connection has run out, so BosOn can't post or read results there until you sign in again, with a Reconnect button
The line at the top of Connections, in red: Your Meta ads connection has run out, so BosOn can't post or read results there until you sign in again, with a Reconnect button

The dot turns red if any other service you've connected becomes disconnected. And if you schedule a post for after your Meta connection ends, the post box tells you the date and offers Reconnect there too.

Disconnecting

To disconnect, open Meta ads in Connections and click Disconnect. To remove BosOn from your Facebook account as well, go to Facebook Settings and privacy, Settings, Business integrations.