HTTP API REFERENCE

One key across compatible protocols

Use an exact model ID from the live catalog. Endpoint support and available groups come from the same pricing configuration used by Models.

On this page

Authentication

Send the CDAPI key as a Bearer token. Never place it in the URL or request body.

HTTP headers

Authorization: Bearer sk-your-key
Content-Type: application/json

Routes

Capability	Method and path	Host
Model catalog	`GET /v1/models`	`https://ai.bycomet.cc`
Chat Completions	`POST /v1/chat/completions`	`https://ai.bycomet.cc`
Responses	`POST /v1/responses`	`https://ai.bycomet.cc`
Anthropic Messages	`POST /v1/messages`	`https://ai.bycomet.cc`
Images	`POST /v1/images/generations`	`https://api-direct.ai.bycomet.cc`
Videos	`POST /v1/videos`	`https://api-direct.ai.bycomet.cc`

Live model catalog

This table reads model IDs, capabilities, endpoint types, and available groups from the live pricing contract.

Public machine-readable catalog: GET /api/geo/catalog. It contains only currently available model/group pairs and calculated public prices.

Use GET /api/geo/catalog/{product} for a product category and GET /api/geo/models/{model_id} for an exact model. Product values are gpt, claude, gemini, image, video, and other.

Loading the live model catalog...

Model ID	Capabilities	Endpoint types	Available groups
Loading...

GET /v1/models

curl https://ai.bycomet.cc/v1/models \
  -H "Authorization: Bearer $CDAPI_API_KEY"

POST /V1/CHAT/COMPLETIONS

Chat Completions

cURL

curl https://ai.bycomet.cc/v1/chat/completions \
  -H "Authorization: Bearer $CDAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with ok"}],
    "stream": false
  }'

POST /V1/RESPONSES

Responses

Use this route only when the selected model lists Responses support.

cURL

curl https://ai.bycomet.cc/v1/responses \
  -H "Authorization: Bearer $CDAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"Reply with ok"}'

POST /V1/MESSAGES

Anthropic Messages

cURL

curl https://ai.bycomet.cc/v1/messages \
  -H "Authorization: Bearer $CDAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Reply with ok"}]
  }'

POST /V1/IMAGES/GENERATIONS

Image generation

Use the direct host and choose dimensions supported by the current image model.

cURL

curl https://api-direct.ai.bycomet.cc/v1/images/generations \
  -H "Authorization: Bearer $CDAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL_ID",
    "prompt": "A clean product photo on a white background",
    "size": "1024x1024",
    "n": 1
  }'

ASYNCHRONOUS VIDEO TASKS

Video generation

Create a task, poll its ID with bounded backoff, then download the completed content.

Create

curl https://api-direct.ai.bycomet.cc/v1/videos \
  -H "Authorization: Bearer $CDAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_VIDEO_MODEL_ID","prompt":"A slow camera move"}'

Poll

curl https://api-direct.ai.bycomet.cc/v1/videos/task_abc123 \
  -H "Authorization: Bearer $CDAPI_API_KEY"

After status becomes completed, request GET /v1/videos/task_abc123/content. Stop polling on failed.