/v1, Claude Code and Gemini CLI use the gateway root, and Codex CLI uses /v1 with Responses.
Protocol quick reference
| Client or use case | Protocol | Base URL | Common group |
|---|---|---|---|
| Claude Code | Claude Messages | https://api.aiohub.org | anthropic, claude-bedrock, claude-kiro |
| Codex CLI | OpenAI Responses | https://api.aiohub.org/v1 | codex, codex-passthrough |
| OpenCode | OpenAI Chat Completions or OpenAI Responses | https://api.aiohub.org/v1 | openai, codex, opensource |
| Gemini CLI | Gemini API | https://api.aiohub.org | gemini |
| VS Code (Claude Code) | Claude Messages | https://api.aiohub.org | anthropic, claude-bedrock, claude-kiro |
| VS Code (Codex) | OpenAI Responses | https://api.aiohub.org/v1 | codex, codex-passthrough |
| OpenAI SDK / general apps | OpenAI Chat Completions | https://api.aiohub.org/v1 | openai |
| Embedded GIP | OpenAI Images | https://api.aiohub.org | openai, codex* |
| Self-hosted GIP | OpenAI Images | https://api.aiohub.org | openai, codex* |
| Claude Cowork 3P | Claude Messages | https://api.aiohub.org | anthropic, claude-bedrock, claude-kiro |
| Chatbox | OpenAI Chat Completions | https://api.aiohub.org/v1 | openai, auto |
| Open-source model clients | OpenAI Chat Completions or Claude Messages | Depends on the client protocol | opensource, opensource-discount, opensource-economy |
All API keys use the
sk- format, but assigned groups control visible models, endpoints, and pricing. auto is a routing control value, not a fixed group; verify the client, model, and endpoint you plan to use.
Claude Code
Uses Claude Messages. Set
ANTHROPIC_BASE_URL to https://api.aiohub.org.
Codex CLI
Uses OpenAI Responses. Configure a separate
aiohub provider.
OpenCode
Configure an OpenCode provider and choose Chat Completions or Responses by model.
Gemini CLI
Uses the Gemini API. Set
GOOGLE_GEMINI_BASE_URL to the gateway root.
VS Code
Use AIOHub in VS Code through the Claude Code and Codex extensions.
OpenAI-compatible apps
Use this for Cline, Cursor, Continue, Aider, Open WebUI, LibreChat, and similar apps.
Embedded GIP
Use AIOHub’s embedded page for image generation and editing.
Self-host GIP
Deploy your own GPT Image Playground and connect it to AIOHub.
Cherry Studio
Desktop chat client. Fill the provider fields in the app.
LobeHub
Use
https://chat.aiohub.org and configure AIOHub in language model settings.Claude Cowork 3P
Connect the Cowork and Code tabs in Claude Desktop to the AIOHub gateway.
Chatbox
Use an OpenAI-compatible custom provider on mobile, desktop, or web.
Writing SDK code or direct API calls
If you are writing code instead of configuring an existing app, start with API overview and Authentication. Client pages cover app fields and tool-specific setup.Common setup symptoms
| Symptom | Check first |
|---|---|
Error path includes /v1/v1 | Base URL has an extra /v1 |
Error path repeats /chat/completions | Base URL was set to a full endpoint |
| Model not found | The group assigned to the API key may not include that model |
| Client cannot connect | Check local environment variables, proxy settings, and client configuration |
| Service returns normally but the client shows failure | Check client response parsing and retry settings |