Twincan and AI

Twincan can summarize a voice note, pull out its key points, rewrite it as bullets, paraphrase it, and find the questions in it. These are the note tools. This page explains where they run, what leaves your iPhone when they do, and how to use your own AI providers if you want to.

The short version: on an iPhone with Apple Intelligence and no API keys, the note tools run on the iPhone and nothing leaves it. If you add an API key from Anthropic, Google, OpenAI, or OpenRouter, the tools run through that company too, in an order you control: the note's transcript goes straight from your iPhone to it, and the usage is billed to your key. Twincan has no servers of its own, so nothing passes through Twincan on the way. You can also turn the tools off entirely.

What the note tools do

Long-press a note, or open its transcript, and pick a tool:

ToolWhat you get
SummarizeA few sentences on what the note is about.
Key PointsThe main points, most with a button that jumps to that moment in the audio.
Bullet PointsThe note rewritten as a short list.
ParaphraseThe note said again in plainer words.
Extract QuestionsThe questions in the note, including indirect ones ("let me know if Thursday works"), most with a button to hear it.

The tools only read. They can't send notes, change anything in your can, or act on your behalf, and their results are stored on your iPhone. They aren't shared through iCloud with your notes, though like the rest of Twincan's data they can be part of your iPhone's backups. Results usually name the provider and model that wrote them at the bottom, such as APPLE INTELLIGENCE · ON THIS IPHONE or CLAUDE SONNET 5.5 · ANTHROPIC.

Where the tools run

Everything lives in Twincan's Settings, under AI:

Twincan tries the first provider in the list. If it can't produce a result (it's down, it declines the note, or the key has run out of credits), Twincan tries the next one, and so on. A provider whose key was rejected or needs credits is skipped until you fix it, and you can switch any provider off in the list without removing its key. The footer under AI in Settings spells out the current order in a sentence.

Unless you've moved Apple Intelligence up, a new key goes just ahead of it. If you'd rather notes stay on your iPhone whenever possible, drag Apple Intelligence to the top: a provider further down then sees a note only when Apple Intelligence can't handle it.

Without Apple Intelligence or a working key, the tools don't appear (a tool you already have open keeps its message and Try Again button). Adding a key is how you get them on an iPhone without Apple Intelligence.

Supported providers

ProviderModel Twincan usesKey starts with
Apple IntelligenceApple's on-device modelNo key
AnthropicClaude Sonnet 5.5sk-ant-
GoogleGemini 3.8 FlashAIza
OpenAIGPT-5.6 Terrask-
OpenRouterClaude Sonnet 5.5, through OpenRoutersk-or-

Twincan chooses the model for each provider; there is no model picker. If you don't already have an account with any of these, OpenRouter is the easiest start: Twincan can connect to it without you copying a key at all (see below). If you already pay for Anthropic's API, use an Anthropic key, since the request then goes to one company instead of two.

Getting an API key

An API key is a password that lets an app use your account with an AI company. It's separate from a ChatGPT, Claude, or Gemini subscription: those plans don't include API usage, which is billed on its own.

Each provider's page in Twincan (Settings → AI → Custom API Keys) has a Manage in button that opens the page where you make a key, in a sheet you can swipe away to get back to Twincan.

Anthropic

  1. Go to platform.claude.com and sign in, or create an account.
  2. Add credits under Billing. Keys don't work until the account can pay.
  3. Open API keys, click Create key, and name it "Twincan".
  4. Copy the key. Anthropic shows it only once; if you lose it, make a new one.

Google

  1. Go to Google AI Studio and sign in with your Google account.
  2. Click Create API key. If asked, let it create a new project.
  3. Copy the key.

Google's API works without billing, on a free tier with lower limits. Read the note on Google's free tier under "What providers do with it" before you choose it.

OpenAI

  1. Go to platform.openai.com and sign in, or create an account.
  2. Add credits or a payment method under Billing.
  3. Open API keys, click Create new secret key, and name it "Twincan".
  4. Copy the key. OpenAI shows it only once.

OpenRouter

You can skip the key entirely: on OpenRouter's page in Twincan, tap Connect OpenRouter Account, sign in on openrouter.ai, and approve Twincan. OpenRouter hands Twincan a key of its own, which is checked and stored like a pasted one. You still need credits on your OpenRouter account.

To make a key by hand instead:

  1. Go to openrouter.ai and sign in, or create an account.
  2. Add credits under Credits.
  3. Open Keys and click Create key. You can give it a credit limit here.
  4. Copy the key.

Adding a key to Twincan

  1. Open Settings in Twincan and go to AI → Custom API Keys.
  2. Tap the provider.
  3. Paste your key into the API Key field.
  4. Tap Verify.

Verify sends the provider one tiny test request (the word "Hi", nothing from your notes) to check that the key works and the account can pay for it. For OpenRouter it first looks up the key's remaining allowance, and it checks again each time you open OpenRouter's page in Settings; each of those test requests is billed like any other, though it is tiny. The key is saved only if the provider recognizes it. The provider's row then shows its status:

StatusWhat it means
✓ VerifiedThe key works. For OpenRouter, the page also shows how much is left on the key if it has a credit limit.
Needs creditsThe key is real but the account can't pay. Twincan skips it until you add credits, then tap the refresh button to check again.
RejectedThe provider turned the key down. Paste a new one.
Not verified yetA key saved by an earlier version of Twincan. It's used until a request or Verify says otherwise.

To replace a key, paste a new one into the same field and tap Verify. To remove it, tap Remove at the bottom of the provider's page.

What is sent, and when

Nothing is sent while a note runs on Apple Intelligence. When a note runs through a provider with your key, here is what leaves your iPhone:

WhatSent?When
The note's transcript, as textYesWhen you use a tool on it
Received notes' transcriptsYesAutomatically, after they arrive and while Twincan is open, to check them for questions
Instructions telling the model what to doYesWith every request
The sender's name as it appears in Twincan (tidied), and their pronouns if knownYes, for received notesWith the request, so the result can refer to them correctly
The note's audioNever
Its title, date, or lengthNever
Your other notes, your photo, or your contactsNever
Anything about your iCloud accountNever

The sender's name is tidied before it's sent: it keeps only letters, numbers, apostrophes and hyphens, and at most three words.

Because Twincan falls back down your Provider Priority list, a note one provider couldn't handle can be sent to the next one. Apple Intelligence is tried only if your iPhone has it, and other providers only if you've added a key for them; either way, only if you've left them switched on. A result whose footer says Apple Intelligence may still have been tried elsewhere first: if Apple Intelligence produces only part of an answer, Twincan tries the next providers, and shows Apple's partial answer only if none of them does better.

Two things happen without you tapping a tool:

Results are kept, so a note isn't re-sent every time you open the app. A note is sent again when its result goes out of date: after you add, remove, switch, or reorder providers, when the sender's pronouns change, when Twincan's instructions change in an update, or when an earlier try didn't finish. On Apple Intelligence all of this happens on your iPhone.

Requests go directly from your iPhone to each provider. If Google rejects the format Twincan asks for, Twincan sends the request once more in a simpler form. Requests to OpenRouter name Twincan as the app making them. OpenRouter is a router, not a model: it passes your request on to the model provider it routes to (Twincan asks it for Anthropic's Claude), so both OpenRouter's and that provider's policies apply.

Your keys

Your keys are stored in your iPhone's keychain, the same place iOS keeps passwords. They stay on this iPhone: they aren't synced to iCloud Keychain, aren't included in a backup that can be restored to another phone, and each is sent only to the company it belongs to. Keychain items can outlast an app, so remove your keys in Settings before deleting Twincan.

What providers do with it

What a provider does with what it receives is governed by its own terms. As of this writing, Anthropic, OpenAI, and OpenRouter say they don't train models on API data by default.

Google's free tier is different. Under Google's Gemini API terms, if your Google key is on the free tier, Google may use what it receives, transcripts included, to improve its products, and people may review it. Turning on billing for the key's project moves it to Google's paid terms, which don't. If that matters to you, turn on billing, or use another provider.

Check each company's current terms rather than taking our word for it:

Twincan's own privacy policy covers all of this too.

What it costs

Twincan doesn't charge for the note tools. With your own key, each provider bills your account for each request, by the amount of text in and out, at its standard rates. A voice note's transcript is short, so each tool is a small charge, but the automatic question check adds a request for most notes you receive, and a note can be sent to more than one provider when one falls back to the next. See each provider's pricing page for current rates.

If you want a ceiling, set a spending limit in your provider's dashboard, or a credit limit on the OpenRouter key.

Troubleshooting

When a tool can't finish, the note shows a message and a Try Again button.

"Couldn't finish just now." Twincan couldn't get a result this time: you're offline, a provider is busy or rate-limiting you, a key stopped working, providers were skipped because they're out of credits or busy, or something went wrong saving the result. Wait a moment and tap Try Again. If it keeps happening, open Settings → AI → Custom API Keys and look for a key marked Needs credits or Rejected.

"None of your AI providers could read this one." Every provider that tried couldn't handle this note: a content filter declined it, it's too long, it's in a language the model doesn't support, or the answer came back unusable. Adding another provider may help.

"Add a provider in Settings → AI." AI Features is on, but there's nothing to run on: no Apple Intelligence and no key, or you've switched every provider off in Provider Priority.

"Your AI providers need attention in Settings → AI." You have providers switched on, but none can be used right now, usually because each key needs credits or was rejected.

When you tap Verify:

The tools don't appear. Check that AI Features is on, and that you have Apple Intelligence turned on or a verified key. The tools also stay hidden on your draft, until a note's transcript is ready, on notes with very little speech, and in the Red Room.

Questions

Is my data used to train AI models?

Not by Apple Intelligence, which never sends your note anywhere. Anthropic, OpenAI, and OpenRouter each say API data isn't used for training by default. Google's free tier may use it; its paid tier doesn't. Their terms above are the final word.

Can I use a free key?

Google's free tier works without billing, with the training caveat above. Anthropic and OpenAI require credits before a key works. OpenRouter has free models, but Twincan asks it for Claude, which is paid, so you need credits there too.

Which should I choose?

If your iPhone has Apple Intelligence and you'd rather nothing left it, don't add a key, or put Apple Intelligence first. If you want sharper summaries or your iPhone doesn't have Apple Intelligence, Connect OpenRouter Account is the quickest way in, and an Anthropic key is the most direct. You can add more than one and let Twincan fall back between them.

Questions or problems

Get in touch at chrismessina.me/contact.