Skip to content

AI Providers ​

Kuse Cowork supports multiple AI providers, giving you flexibility in choosing the right model for your needs.

Supported Providers ​

Official API Providers ​

These providers require API keys from the respective companies.

Anthropic Claude ​

The default and recommended provider for most tasks.

ModelDescriptionBest For
claude-opus-4-5-20251101Most capableComplex reasoning, creative tasks
claude-sonnet-4-5-20250929BalancedGeneral use (recommended)

Configuration:

Base URL: https://api.anthropic.com
Auth: x-api-key header

Get your API key at console.anthropic.com

OpenAI ​

Support for GPT models including the latest GPT-5 series.

ModelDescriptionAPI Format
gpt-5Latest flagshipResponses API
gpt-5-miniFast and efficientResponses API
gpt-5-nanoUltra-fastResponses API
gpt-4oMultimodalChat Completions
gpt-4-turboFast GPT-4Chat Completions

GPT-5 Responses API

GPT-5 models use OpenAI's new Responses API format, which is automatically detected and handled.

Get your API key at platform.openai.com

Google Gemini ​

Google's latest AI models with thinking capabilities.

ModelDescription
gemini-3-pro-previewGoogle's latest model

Special Features:

  • Thinking/reasoning mode with thoughtSignature support
  • Function calling with thought signatures

Get your API key at ai.google.dev

Minimax ​

Advanced Chinese language model provider.

ModelDescription
minimax-m2.1Advanced Chinese model

Local Inference ​

Run models locally for privacy and offline use.

Ollama ​

The easiest way to run local models.

Setup:

bash
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Pull a model
ollama pull llama3.3:latest

Available Models:

ModelSizeDescription
llama3.3:latest8BMeta's latest
llama3.3:70b70BRequires 32GB+ RAM
qwen2.5:latest7BGood for Chinese
deepseek-r1:latestVariousStrong reasoning
codellama:latest7BCode-specialized
mistral:latest7BEfficient European model
phi3:latest3.8BMicrosoft small model

Configuration:

Base URL: http://localhost:11434
Auth: None required

LocalAI ​

OpenAI-compatible local inference server.

Base URL: http://localhost:8080
Auth: None required

vLLM / SGLang / TGI ​

High-performance inference servers:

ServerDefault PortDescription
vLLM8000High-performance inference
SGLang30000Structured generation
TGI8080HuggingFace inference

Aggregation Services ​

Access multiple models through a single API.

OpenRouter ​

Access 100+ models through one API.

ModelDescription
anthropic/claude-3.5-sonnetClaude via OpenRouter
openai/gpt-4oGPT-4o via OpenRouter
meta-llama/llama-3.3-70b-instructLlama 3.3
deepseek/deepseek-r1DeepSeek R1

Get your API key at openrouter.ai

Groq ​

Ultra-fast inference with specialized hardware.

ModelDescription
llama-3.3-70b-versatileLlama 3.3 70B
mixtral-8x7b-32768Mixtral MoE

Get your API key at console.groq.com

Together AI ​

Cloud inference for open-source models.

ModelDescription
meta-llama/Llama-3.3-70B-Instruct-TurboLlama 3.3 Turbo
Qwen/Qwen2.5-72B-Instruct-TurboQwen 2.5 Turbo

DeepSeek ​

Chinese AI provider with strong coding models.

ModelDescription
deepseek-chatGeneral chat
deepseek-reasonerEnhanced reasoning

SiliconFlow ​

Cloud inference service with Chinese model focus.

ModelDescription
Qwen/Qwen2.5-72B-InstructQwen 2.5
deepseek-ai/DeepSeek-V3DeepSeek V3

Provider Configuration ​

Switching Providers ​

  1. Open Settings (⚙️)
  2. Select provider from the dropdown
  3. Enter API key (if required)
  4. Select model
  5. Click "Test Connection"

API Key Storage ​

API keys are stored in:

~/.kuse-cowork/settings.db

Keys are:

  • Stored locally only
  • Never sent to third parties
  • Associated with specific providers

Per-Provider Keys ​

You can configure different API keys for each provider:

json
{
  "providerKeys": {
    "anthropic": "sk-ant-...",
    "openai": "sk-...",
    "openrouter": "sk-or-..."
  }
}

When switching models, the appropriate key is automatically selected.

Custom Providers ​

OpenAI-Compatible Endpoints ​

Connect to any OpenAI-compatible API:

  1. Select "Custom Service" as provider
  2. Enter base URL
  3. Configure authentication
  4. Enter model ID

Example: LM Studio

Base URL: http://localhost:1234/v1
Auth: None
Model: local-model

Enterprise Deployments ​

For Azure OpenAI or self-hosted deployments:

Base URL: https://your-deployment.openai.azure.com
Auth: Bearer token
Model: your-deployment-name

Reasoning Models ​

Some models have special requirements:

Temperature Restrictions ​

The following models don't support custom temperature:

  • OpenAI: o1-*, o3-*, gpt-5*
  • DeepSeek: deepseek-reasoner

Temperature is automatically ignored for these models.

Extended Thinking ​

Some models support extended thinking/reasoning:

  • Gemini 3: Uses thoughtSignature for function calling
  • Claude: Uses extended thinking mode

Best Practices ​

Choosing a Provider ​

Use CaseRecommended Provider
General codingClaude Sonnet
Complex reasoningClaude Opus or GPT-5
Fast iterationGroq or Ollama
Privacy-focusedLocal models (Ollama)
Cost optimizationOpenRouter
Chinese contentQwen or DeepSeek

Cost Management ​

  • Use smaller models for simple tasks
  • Use local models for development/testing
  • Monitor usage through provider dashboards

Performance Tips ​

  • Groq offers fastest cloud inference
  • Ollama is fastest for local (if you have GPU)
  • Use streaming for better UX

Troubleshooting ​

Connection test fails ​

1. Verify API key is correct
2. Check base URL format
3. Ensure network connectivity
4. Check provider status page

Model not found ​

1. Verify model ID spelling
2. Check if model is available in your plan
3. For Ollama, ensure model is pulled

Rate limit errors ​

1. Reduce request frequency
2. Upgrade provider plan
3. Use multiple provider keys

Next Steps ​

Released under the MIT License.