Skip to content

AI Providers: Your Own Key

The call path — providers plug into the highlighted hop

AI providers plug into the highlighted hop: Parrot Cloud connects each call to the vendor that voices it.

Every call is voiced by an AI vendor's realtime voice model — OpenAI Realtime, Gemini Live, Ultravox, Doubao, Grok, Qwen, or any endpoint that speaks the OpenAI Realtime protocol. Out of the box your assistants run on Parrot's shared keys (currently OpenAI, Gemini, Ultravox and Doubao), billed through your credits. The AI providers page is where you see those lines, what each is good at — and where you plug in your own vendor key so calls run on your account instead.

The AI providers page

Open AI providers in the console. Your own keys are pinned first, then the shared-key lines this server carries, then the providers you can only use with a key of your own (such as Grok, Qwen or a custom endpoint):

AI providers: your keys first, then the shared lines

Each shared line is ready to use with no setup and shows its price per minute and an honest description of what that vendor can and can't do on a phone call — they are genuinely different:

  • Ultravox — a speech-native model built for real-time phone calls; the most controllable (temperature, language hint, first-speaker control, and urgent steering that can interrupt the AI mid-sentence).
  • OpenAI Realtime — strong general-purpose conversation with a large voice roster; live steering is delivered but acted on only after the current sentence.
  • Gemini Live — on Gemini assistants you create, the AI greets first: the console offers no "caller speaks first" option for Gemini. (The Gemini templates that place calls, Ask a Business a Question and Deliver a Message, come set to let the other side speak first.) Context compression and session resumption carry a call past Google's 15-minute session limit, up to your account's maximum call duration. Every live instruction interrupts the AI immediately, mid-sentence.
  • Doubao — ByteDance's end-to-end voice model, the most natural Chinese voice. Chinese and English only, and no tool calls, so the AI cannot hang up by itself; the call ends when the other side hangs up, you end it, or it reaches its time limit.

The assistant editor's provider picker mirrors these cards — one group per vendor, holding the shared line and your working keys. A provider from the last section appears there once you add your key.

Adding your own key

Click Add your provider (or use your key on a vendor's card), paste the API key, and save. Parrot validates the key against the vendor with a real request before keeping it — if the vendor rejects it, you see the vendor's own error and nothing is saved, so you find out now rather than on your next call.

Once added:

  • Your key is stored encrypted and never shown again in full — only its last few characters, for recognition.
  • Point any assistant at it in the editor's provider picker. From then on that assistant's AI usage is billed by your vendor directly. Check Billing for the applicable Parrot charges. Every call's ledger row shows whether it ran on your key or the shared one, so billing is never ambiguous.
  • The key's page shows its last-30-days usage and which assistants run on it. To replace the key, paste the new one into API key and choose Validate & save — it is checked the same way before it replaces the old one. If a key stops working, its card shows it as invalid, and the editor won't let an assistant save onto a broken key.
  • Delete is refused while assistants still reference the key — the console names them so you can repoint before removing it.

Where this fits

Providers set whose account voices the call; the assistant decides everything else. Back to Customizing your assistant, or see what a call costs in Billing, credits & API keys.