AI Chat Applications

Overview

Most general AI chat apps connect to AI Sonar through the standard OpenAI-compatible chat path. In practice that means:

use https://api.aisonar.dev/v1 as the base URL unless the app explicitly asks for a full endpoint URL
use your AI Sonar API key as the OpenAI-style API key
pick models that the app can use in a standard chat workflow

General chat apps are usually chat-completions oriented, not Codex Responses WebSocket clients. For Codex CLI/App, Cursor, or other coding tools that need Responses-specific behavior, use the dedicated integration guides instead.

Type: Chat AppPrimary Path: OpenAI-compatible chat-completionsSupport Confidence: Supported path

Supported Applications

Application	Platform	Notes
Open WebUI	Web, Self-hosted	Popular self-hosted choice with OpenAI-compatible connections
LibreChat	Web, Self-hosted	Multi-provider chat workspace with custom OpenAI endpoints
LobeChat	Web, Desktop, Self-hosted	Strong custom-provider support
Cherry Studio	Windows, macOS, Linux	Good OpenAI-compatible provider flow
Chatbox	Windows, macOS, Linux	Simple OpenAI-compatible setup
DeepChat	Windows, macOS, Linux	Desktop client with OpenAI-compatible provider settings
Jan	Desktop, Self-hosted	Local-first app with remote OpenAI-compatible providers
TypingMind	Web, Desktop	Uses a custom endpoint style
NextChat	Web, Self-hosted	Lightweight ChatGPT-style client with base-URL overrides
ChatWise	Windows, macOS	Standard custom provider pattern

Default Connection Values

Field	Value
Base URL	`https://api.aisonar.dev/v1`
API Key	`sk-your-api-key`
API Type	OpenAI Compatible

If an app asks for a full endpoint URL instead of a base URL, use:

Chat Completions: https://api.aisonar.dev/v1/chat/completions

Example App Setups

Self-hosted LobeChat

OPENAI_API_KEY=sk-your-api-key
OPENAI_PROXY_URL=https://api.aisonar.dev/v1

LobeChat Cloud

Open Settings → AI Service Provider
Select OpenAI
Enter your AI Sonar API key
Set the custom endpoint to https://api.aisonar.dev/v1

Open Settings → Model Provider
Add an OpenAI-compatible provider
Enter:
- Name: AI Sonar
- API Base URL: https://api.aisonar.dev/v1
- API Key: sk-your-api-key
Add the models you want to use

Open Settings → AI Model
Choose OpenAI API Compatible
Enter:
- API Host: https://api.aisonar.dev/v1
- API Key: sk-your-api-key
- Model: gpt-5.4-mini or claude-sonnet-5

Open Settings
Choose Custom Endpoint
Enter:
- Endpoint URL: https://api.aisonar.dev/v1/chat/completions
- API Key: sk-your-api-key
Configure the models you want to expose

Open Admin Settings → Connections
Add an OpenAI-compatible connection
Enter:
- Base URL: https://api.aisonar.dev/v1
- API Key: sk-your-api-key
Save and select the models you want to expose

Open Settings -> Model Provider
Add an OpenAI-compatible provider
Enter:
- Base URL: https://api.aisonar.dev/v1
- API Key: sk-your-api-key
- Model: gpt-5.4-mini
Save and run a test chat

Open Settings -> Providers
Add a remote OpenAI-compatible provider
Enter:
- Provider name: AI Sonar
- Base URL: https://api.aisonar.dev/v1
- API Key: sk-your-api-key
Select gpt-5.4-mini or another AI Sonar model

Add an OpenAI-compatible endpoint in your LibreChat provider config and point it to:

customEndpoints:
  - name: AI Sonar
    apiKey: '${OPENAI_API_KEY}'
    baseURL: 'https://api.aisonar.dev/v1'
    models:
      default: ['gpt-5.4-mini', 'gpt-5.4', 'claude-sonnet-5']
      fetch: false

Safer Model Defaults

Category	Suggested Models
General default	`gpt-5.4-mini`, `gpt-5.4`, `gpt-5.5`
Anthropic	`claude-sonnet-5`, `claude-opus-4-8`, `claude-fable-5`
Google	`gemini-3.5-flash`, `gemini-3.1-flash-lite`
DeepSeek	`deepseek-v4-flash`, `deepseek-v4-pro`

Tips

Prefer base URL when the app supports it

Most apps are easier to configure and less fragile when you provide https://api.aisonar.dev/v1 as a base URL instead of a full endpoint URL.

Use smaller models first

Start with gpt-5.4-mini or deepseek-v4-flash for everyday chat, then move heavier reasoning tasks to gpt-5.4 or claude-opus-4-8.

Keep coding tools separate

General chat apps and coding agents often need different endpoint behavior. Keep Codex/Cursor-style tools on their dedicated integration pages.

Troubleshooting

Connection Error

Verify the base URL is exactly https://api.aisonar.dev/v1
Remove trailing slashes if the app auto-appends paths
If the app wants a full endpoint URL, use https://api.aisonar.dev/v1/chat/completions

401 Unauthorized

Double-check your API key
Confirm the key is active in AI Sonar dashboard
Make sure there are no extra spaces or line breaks

Model Not Available

Verify the model name exactly
Try a widely supported default like gpt-5.4-mini, deepseek-v4-flash, or claude-sonnet-5
Check current availability in AI Sonar docs or dashboard

Compatibility Matrix

Coding Tools

Native SDKs

Frameworks & Platforms

Chat Apps

AI Chat Applications

Overview

Supported Applications

Default Connection Values

Example App Setups

Safer Model Defaults

Tips

Troubleshooting

​Overview

​Supported Applications

​Default Connection Values

​Example App Setups

​Safer Model Defaults

​Tips

​Troubleshooting

Overview

Supported Applications

Default Connection Values

Example App Setups

Safer Model Defaults

Tips

Troubleshooting