ChatspeedChatspeed
Guide
ccproxy
MCP Proxy
Proxy API
  • English
  • 简体中文
GitHub
Guide
ccproxy
MCP Proxy
Proxy API
  • English
  • 简体中文
GitHub
  • API Reference

    • API Introduction

API Introduction

The Chatspeed ccproxy module provides flexible and powerful API access rules for easy invocation by various clients. This section details these rules, helping you understand how to access and combine various AI models and tools via ccproxy.

Core Concepts

API access in ccproxy is primarily based on the following two core concepts:

  1. Grouping (Group) You can set up independent model groups for different clients or use cases. By including the group name in the API path, you can easily isolate different clients' access capabilities to models and quickly switch models as needed.

    • Example: If your group name is gemini, to access the Claude protocol chat interface, you can use /gemini/v1/messages.
  2. Tool Compatibility Mode For models that do not natively support tool calling (Function Calling), ccproxy provides a tool compatibility mode, allowing them to gain and execute tool calling capabilities. To enable tool compatibility mode, simply add compat_mode to the API entry endpoint.

    • Example: /gemini/compat_mode/v1/messages

API Access Endpoints

Below are the basic API entry points provided by ccproxy:

  • /sse: MCP Proxy Entry (Server-Sent Events)
  • /v1/models: OpenAI compatible interface and Claude format model list interface
  • /v1/chat/completions: OpenAI compatible interface chat entry
  • /v1/messages: Claude native protocol message interface
  • /v1beta/models: Gemini chat model list interface
  • /v1beta/models/{model}/generateContent: Gemini chat synchronous access interface
  • /v1beta/models/{model}/streamGenerateContent: Gemini chat streaming access interface
  • /api/tags: Ollama protocol model list interface
  • /api/chat: Ollama protocol chat entry
  • /api/show: Ollama protocol model details interface

Combined API Access

By combining Grouping and Tool Compatibility Mode, you can build more flexible API access paths. Please refer to the API list below for specific combinations.

TypeProtocolGroupCompatAPI AddressNote
MCPSSEfalse/sse
ChatOpenaifalse/v1/chat/completions
ChatOpenai{group}false/{group}/v1/chat/completionsReplace {group} with the group name
ChatOpenai{group}true/{group}/compat_mode/v1/chat/completionsReplace {group} with the group name
ChatOpenaitrue/compat_mode/v1/chat/completions
ChatClaudefalse/v1/messages
ChatClaude{group}false/{group}/v1/messagesReplace {group} with the group name
ChatClaude{group}true/{group}/compat_mode/v1/messagesReplace {group} with the group name
ChatClaudetrue/compat_mode/v1/messages
ChatGeminifalse/v1beta/models/{model}/generateContent?key={key}Replace {model} with the model name and {key} with the API Key
ChatGemini{group}false/{group}/v1beta/models/{model}/generateContent?key={key}Replace {group} with the group name, {model} with the model name, and {key} with the API Key
ChatGemini{group}true/{group}/compat_mode/v1beta/models/{model}/generateContent?key={key}Replace {group} with the group name, {model} with the model name, and {key} with the API Key
ChatGeminitrue/compat_mode/v1beta/models/{model}/generateContent?key={key}Replace {model} with the model name and {key} with the API Key
ChatOllamafalse/api/chat
ChatOllama{group}false/{group}/api/chatReplace {group} with the group name
ChatOllama{group}true/{group}/compat_mode/api/chatReplace {group} with the group name
ChatOllamatrue/compat_mode/api/chat
ListOpenai/v1/modelsSupports groups and compatibility mode
ListCalude/v1/modelsSupports groups and compatibility mode
ListGemini/v1beta/modelsSupports groups and compatibility mode
ListOllama/api/tagsSupports groups and compatibility mode
Edit this page on GitHub
Last Updated: 8/20/25, 10:05 AM
Contributors: ezool