CDAPI DOCS

CLIENT INTEGRATIONS

Connect the tools you already use

Choose the protocol first, then enter the key, matching Base URL, and an exact model ID from the live catalog.

Choose a client

Endpoint rules

Client protocol Base URL Final request
OpenAI compatible https://ai.bycomet.cc/v1 /v1/chat/completions or /v1/responses
Anthropic Messages https://ai.bycomet.cc /v1/messages
Long-running generation https://api-direct.ai.bycomet.cc/v1 The matching OpenAI-compatible resource path
A 404 usually means the path was joined twice

Inspect the final request URL for a duplicated /v1 or resource path before changing the key or model.

RECOMMENDED IMPORT

CC Switch (CCS)

Use one-click import from API keys for supported tools, including Claude Code, Cursor, OpenClaw, and Hermes.

  1. Install the latest CC Switch release.
  2. Open the target key and choose CCS import.
  3. Select the application and a model that is available to the key group.
  4. Confirm the redacted key and endpoint before allowing the browser to open ccswitch://.
Success signal

The target tool returns a response and the same model request appears in usage logs with HTTP 200.

OPENAI RESPONSES

Codex CLI

Define the provider in the user-level ~/.codex/config.toml and keep the key in an environment variable.

~/.codex/config.toml
model = "YOUR_MODEL_ID"
model_provider = "ccapi"

[model_providers.ccapi]
name = "CDAPI"
base_url = "https://ai.bycomet.cc/v1"
env_key = "CDAPI_API_KEY"
wire_api = "responses"
Shell test
export CDAPI_API_KEY="sk-your-key"
codex exec "Reply with ok"

Confirm a /v1/responses request in usage logs. See the official Codex configuration reference for current keys.

ANTHROPIC MESSAGES

Claude Code

Use Bearer authentication through ANTHROPIC_AUTH_TOKEN. The Base URL must not include /v1.

Shell
export ANTHROPIC_BASE_URL="https://ai.bycomet.cc"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"

claude -p "Reply with ok"

If the request still goes to the official host, inspect the variables in the current shell and restart Claude Code. See the Claude Code gateway reference.

OPENAI COMPATIBLE

Cursor and desktop clients

Cursor Chat, Cherry Studio, Chatbox, Open WebUI, LobeChat, and similar clients normally use these fields:

Provider fields
Provider: OpenAI compatible
API Key: sk-your-key
Base URL: https://ai.bycomet.cc/v1
Model: YOUR_MODEL_ID
  1. Add the exact model ID shown in Models.
  2. Restart clients that cache provider settings.
  3. Send “Reply with ok” in a new chat and verify the request in usage logs.