Skip to main content

​
Overview

Workshop supports three AI model providers — Anthropic (Claude), OpenAI (GPT), and Google Gemini. For each provider you can choose between two connection modes:
ModeAPI KeyBillingSetup
Workshop-managedNone neededWorkshop creditsOne-click enable
BYOK (Bring Your Own Key)Your own keyDirectly by the providerPaste your API key
You can enable multiple connectors — even both managed and BYOK for the same provider — and switch between them per project.

​
Workshop-Managed Connectors

Workshop-managed connectors (memex-anthropic, memex-openai, memex-gemini) let you add AI features to your apps without creating accounts at each provider or managing API keys.

​
How They Work

  1. Click the provider tile in the Connectors tab (under AI Models)
  2. Click Create Connection
  3. Workshop generates a secure API key behind the scenes, tests the connection, and activates the connector
That’s it. Your apps can now call that provider’s models, with usage billed to your Workshop credits.

​
Disabling a Managed Connector

Open the provider tile and click Delete Connection. The associated API key is automatically revoked and the connector is removed.

​
Available Models

ModelDescription
claude-haiku-4-5-20251001Fast, cost-effective
claude-sonnet-4-5-20250929Balanced
claude-sonnet-4-6Latest balanced
claude-opus-4-6Most capable
Capabilities: Extended thinking, PDF and image analysis, structured JSON output.

​
Publishing with Managed Connectors

When you publish an app that uses a Workshop-managed connector, Workshop generates fresh API keys for the deployed environment. Visitors to your published app consume your Workshop credits — you don’t need to manage or expose any API keys.

​
Credit Usage

Each API call consumes Workshop credits based on the model used and the number of tokens processed. Monitor your usage in Settings > Usage and Billing.

​
BYOK (Bring Your Own Key)

If you already have an API key from Anthropic, OpenAI, or Google, you can use it directly. Usage is billed by the provider, not Workshop.
ProviderSetup Guide
AnthropicAnthropic BYOK Guide
OpenAIOpenAI BYOK Guide
Google GeminiGemini BYOK Guide
Published apps use your API key. If you publish an app that uses a BYOK connector, visitors make requests using your key. You will be billed by the provider for all usage.

​
When to Use Each Mode

  • You want the simplest setup with no external accounts to manage
  • You’re prototyping or building apps for personal use
  • You want a single billing source (Workshop credits)
  • You’re publishing apps where you want Workshop to handle key lifecycle
  • You already have a provider account with credits or a billing agreement
  • You need access to models not available through Workshop-managed connectors
  • You want usage billed directly to your provider account
  • Your organization requires direct provider relationships for compliance

​
Choosing a Provider

All three providers work the same way within Workshop. The main differences are the models available and their strengths:
  • Anthropic (Claude): Strong at careful reasoning, long-form writing, and nuanced instruction following.
  • OpenAI (GPT): Broad general-purpose capabilities including image generation and function calling.
  • Google Gemini: Excellent at multimodal tasks, very long context windows, and grounded responses.
You can enable multiple providers simultaneously and switch between them per conversation or project.
Switching providers: Each provider has a different SDK and API format. If you want to switch an app from one provider to another, ask the Workshop agent — for example, “Switch this app from OpenAI to Anthropic” — and it will handle the code migration.

​
Security

Workshop handles API key management for managed connectors automatically:
  • Keys are generated securely on your behalf
  • Keys are stored encrypted (SHA-256 hashed server-side)
  • Keys are automatically revoked when you delete a connector
  • You never need to manage or rotate keys manually
For BYOK connectors, your API key is encrypted in Workshop’s storage and never exposed to the AI agent directly.

​
Troubleshooting

​
”Connection Failed” Error

  • Verify your internet connection
  • For managed connectors, try deleting and re-enabling the connector
  • For BYOK, verify your API key is valid and has not been revoked

​
”Insufficient Credits” Error

  • For managed connectors: check your Workshop credit balance in Settings > Usage and Billing
  • For BYOK: check your balance with the provider (Anthropic console, OpenAI platform, or Google Cloud console)

​
Learn More